update your existing plugin’s WordPress compatibility

The following is a brief overview on how to pull down your repository from WordPress.org and bump the Tested Up To version, without having to push out an update for your plugin.


Subversion or TortoiseSVN

The first thing you need is a method to interact with the version controlled running SVN. If you are on a Mac, you can install SVN through brew.

$ brew install subversion

If you are on a PC you can install TortoiseSVN to help manage things through a GUI. (I’m sure there is one for the mac, I just haven’t used it)

https://tortoisesvn.net/

Clone the Plugin

Once you have one of the above methods installed, you need to pull down the repository for your plugin. Your plugin can be found at https://plugins.svn.wordpress.org/your-plugin-name where your-plugin-name is the slug of your plugin.

To clone the repository using one of the above methods:

Subversion on Mac:
$ svn co https://plugins.svn.wordpress.org/your-plugin-name my-local-dir (replacing your-plugin-name with your plugin slug)

TortoiseSVN on Windows:
I believe you can right click go to TortoiseSVN → Checkout and enter the URL for your plugin.

Docs: https://tortoisesvn.net/docs/nightly/TortoiseSVN_en/tsvn-dug-checkout.html

Bump Tested Up To Version

When the files have all been cloned, to bump the ‘Tested Up To’ version in your plugin you will want to update the ‘Tested Up To’ version inside of the readme.txt inside of the latest tag and the trunk directories.

Ideally the version would be something like 4.9, which moving forward will include all point releases (4.9.1, 4.9.2 etc).

Commit the Changes back to WordPress.org

Once you’ve made your changes you’ll need to add and commit the changes back to the WordPress plugin repository.

Subversion on Mac:

$ svn add --force ./*
$ svn ci -m 'Bump tested up to version'

TortoiseSVN on Windows:
Right click the top level directory for your plugin and select TortoiseSVN → Commit Check the boxes next to each of the files you want to commit, enter a commit message at the top and click OK.

Docs: https://tortoisesvn.net/docs/nightly/TortoiseSVN_en/tsvn-dug-commit.html

That’s all. Once your commit has gone through it can take up to 15 minutes or so for the changes to reflect on WordPress.org.

Additional Resources

  1. Additional info on using subversion with WordPress: https://developer.wordpress.org/plugins/wordpress-org/how-to-use-subversion/
  2. Brew subversion: http://brewformulas.org/Subversion
  3. TortoiseSVN Docs: https://tortoisesvn.net/docs/nightly/TortoiseSVN_en/