A 3 step guide to getting your WordPress plugin onto WordPress.org

I recently got my bm-custom-login plugin accepted onto the Wordress plugin repository. In order to get it online I had to use subversion – something I’ve never used before.

I found the “using svn page” on wordpress.org to be rather intimidating. For example the first section “getting started” jumps straight into telling you what commands to type without even mentioning the basic things such as what to download. This seems to go against the simple software the WordPress team try to promote so I thought I’d work it out for myself and document the process. It was considerably simpler than expected.

Before we start

Since this is a tutorial for uploading WordPress plugins I think I should point out that you will need a WordPress.org account, and to have submitted an application for them to host your plugin. Once you get the confirmation email (which seems to take a couple of days) you can move on.

Step 1 – Get the software

I knew from the start that I didn’t want to mess around with the command line. I won’t be using svn (subversion) often enough to need to learn it, and I don’t want to have to remember all the obtuse commands. This meant my first port of call was some visual svn software. A 30 second search on Google showed me that TortoiseSVN was by far the most popular so I figured I’d use that – you can download TortoiseSVN here.

After downloading, install TortoiseSVN. This package contains everything you’ll need to manage your files. If you want to create an SVN server then you will need Subversion itself but that’s outside the scope of this tutorial.

Step 2 – Check in the initial files

When you register a plugin on wordpress.org the svn folder is created for you so you can skip that. All you need is to create a folder on your pc for your subversion files. I created an SVN folder then a bm-custom-login folder – I will then place all future plugins in the same folder. Right click on your plugin folder, and select “SVN Update”, you will be asked where to update the files from (use the url sent to you when your wordpress plugin was approved) and the existing files will be downloaded. Remember, anybody can download these files, but only you can upload them…

Step 3 – Update your plugin

Create a readme.txt file using this as an outline. This file outlines what will be displayed on your plugin page. Save the readme.txt into the same folder as your plugin.

Go back to your main plugin folder (in my case ‘SVN/bm-custom-login’), right click and press “SVN Commit”. You will now be asked for your login information, which is the same as your wordpress.org login details. Press ok, and your plugin will be uploaded. Now wait a short while and your plugin will be live on WordPress Extend.

In the future…

Now that I have the plugin online I have decided to forward all download requests through this page. Doing this will ensure people always have the latest version, it also means I only have to update one set of code. Finally having the code on wordpress.org means that should I update the plugin people using it will be informed via the built in plugin update notifications.

Since I now have the know how, I will be releasing some of my other custom plugins fairly soon.

Let me know what you think on Mastodon, or BlueSky (or Twitter X if you must).

WordPress News

The latest WordPress updates from the WPBriefs Podcast.

Related Posts

27 May 2013

WordPress: 10 Years Young, What Does The Future Hold?

WordPress is now 10 years old. I started using wordpress 9 years ago – which means I joined the WordPress community early on. The reason I chose WordPress is simply because of the fabled 5 minute install process – I...
25 Jul 2007

WordPress Tips and Tricks – Custom Login Page

It’s cool to have the WordPress login page customized to fit your own website branding. This is even more significant for multi author blogs, or sites you have set up for clients as it adds that little extra something.Since writing...
16 Sep 2016

What is the Difference Between WordPress.org and WordPress.com?

Recently, I’ve received a couple of emails asking about the difference between WordPress.com and WordPress.org versions of WordPress. The reason for the confusion is that I sell themes for both sites – and I often get people buying my themes...
29 Mar 2009

The future of WordPress themes

A couple of weeks ago there was quite a lot of talk within the WordPress themes community about the future of WordPress. Ian Stewart started it, and then it spread around the blogosphere… so I thought I’d offer my rather...
30 Jun 2007

WordPress tips and tricks – Custom Page Templates

Some time ago I posted the first of my tips and tricks for WordPress, and I thought it was about time I posted some more so, to start things off, here is a short tutorial on custom page templates in...
01 Mar 2019

Open Source Sustainability

A lot of the internet is powered by open source technology. WordPress being a perfect example. This article looks at the practices behind open source development and considers just how sustainable it all is.One story looks at OpenSSL and how...