Using A Subversion (SVN) Client With The WordPress Plugin Repository

Once you’ve gained approval to add your plugin to the WordPress plugin directory, you’ll need to upload your files (Checkin) to the repository using subversion.

plugin approval wordpressYou’ll find some links in this email which lead to some very comprehensive information on the WordPress Codex.

You should follow these links and get your readme.txt file validated as well as reading the FAQ’s and SVN info.

You’ll find clicking the first link displays a directory tree like this.

subversion

You’ll need to add your files using subversion.

You can do this 2 ways:

  1. Using command line code or
  2. Installing a SVN client

Note: Refer to the WordPress codex with more information on command line otherwise simply install an SVN client.

SVN Client

An SVN (subversion) client is a bit like a simple FTP program.

This is the process i used to add my plugin to the WordPress repository:

  1. Install SVN client locally
  2. Checkout a copy of the directory structure to your local computer
  3. Drag in your plugin files (NOT folder) into the trunk folder
  4. Add your reademe.txt file to the trunk folder
  5. Add your banner to the Assets folder
  6. Checkin your local repository

Install SVN Client

You can upload your plugin files to the repository after installing a subversion software client on your local computer.

There’s one for Mac and one for Windows.

Checkout Directory Structure

You can create some folders for your local repository or simply checkout the directory structure which has been setup already.

Checkout Plugin File Directories

Simply enter the url to your plugin repository which will be sent to you once your plugin has been approved.

Enter the path to you local repository.

Checkout Directories

Local Repository

This is what a typical directory structure for a plugin repository looks like on a local computer.

Local Plugin Repository
Put all your plugin files in the trunk folder and your banner in the assets directory

When a directory is red, it means you’ve made changes to your files but haven’t yet committed your revisions to the WordPress repository.

Checkin (upload & commit) Plugin Repository

This is you moment of glory!

Using your SVN client, checkin and commit your repository of plugin files, readme.text and banner to be hosted in the WordPress plugin repository.

This screenshot shows a revision to the banner file being committed however you will need to commit all files.

Commit Plugin Repository

Make sure you add a message or your files will not be committed.

The screenshot below shows the plugin files, readme.text file and banner revisions committed to the plugin repository.

Your plugin will be live within minutes of a successful commit.

revision commit

WordPress Plugin Directory

Congrats!

You’ve successfully added you plugin to the official WordPress plugin directory and can make revisions to the files at any time using subversion.

WordPress Plugin Directory


Comments

3 responses to “Using A Subversion (SVN) Client With The WordPress Plugin Repository”

  1. Hi Brad,

    Thanks for help, I am new in WordPress.i want to upload my plugin in WordPress.org plugin directory. I got approval from there, but unable to upload the my files in trunk directory.

    Please help me in same

    1. Brad Dalton Avatar
      Brad Dalton

      Hello Prem

      Install the SVN client locally and check out the file system WordPress have already generated for your plugin to your local system.

      You can then add your plugin to the trunk and commit your plugin to the repo.

  2. Vasilis Avatar
    Vasilis

    Thanks a lot for your help!

Leave a Reply

Join 5000+ Followers

Get The Latest Free & Premium Tutorials Delivered The Second They’re Published.