Changelogger Plugin// Changelogs for everyone

The 20th of June 2009 was the day when changelogs found their way into readme.txt files of plugins in the WordPress plugin repository. Thanks to Peter Westwood und Mdawaffe a new version of the readme.txt example file was available online that had an example of the changelog in action.

For many many people a changelog is a very important thing; it is all about justifying to your users why they should upgrade to the latest version of a plugin. That's why I created the little plugin called Changelogger. It shows the latest changelog right on the plugin listing page, whenever there's a plugin ready to be updated.

The plugin requires WordPress 2.7+

  1. Download the plugin and unzip it.
  2. Upload the folder changelogger/ to your /wp-content/plugins/ folder.
  3. Activate the plugin from your WordPress admin panel.
  4. Installation finished.

  1. Deactivate the plugin from your WordPress admin panel.
  2. Upload the folder changelogger/ to your /wp-content/plugins/ folder and overwrite the existing file.
  3. Activate the plugin from your WordPress admin panel.

Note
The changelog on a plugin update is being shown if the plugin author added a changelog section based on the new readme.txt example file to their plugin.

Screenshots

49 Responses

  1. I love the plugin, although it appears that the changelog needs to be from the newest version to the oldest, is there a way to have the plugin parse the correct readme file?

    • Hey Josh,

      the ‘correct’ example readme file suggests listing changelogs from the newest version to the oldest, so that is how my plugin’s trying to parse the readme.

    • Hey Will,

      no bug. It’s just that the plugin author added a changelog section to his plugin’s readme.txt file, but did not fill it properly: http://wordpress.org/extend/plugins/contact-form-7/changelog/ He just added a link which my plugin can’t parse.

      Well, I will try to add validation in the upcoming version, checking if the readme.txt changelog section can be parsed (and is not just a plain link 🙂 ).

  2. Hi Oliver,

    I just installed the plugin, sounds very useful. I have one suggestion: Could you add a link to the plugin’s revision log in the WordPress Plugin Trac? This would be useful especially for plugins without changelog, but also interesting for plugins which have a changelog. If you have the plugin’s slug, you can easily compose the URL like this: “http://plugins.trac.wordpress.org/log/$slug/trunk”. Would be great if you could add that.

    Best regards,
    Robert

    • I added a link to the plugin’s Revision Log in the update notification message. Thanks for your suggestion! 🙂

  3. Hello,

    First of all, great plugin – I use it on all my sites.

    I noticed something today: I had a plugin at version 1.4. The newest version was 1.5.1, but it also had a 1.5 version in between.

    The problem is that Changelogger only displayed the changes for 1.5.1 and didn’t include the ones for 1.5.

    Do you think you can correct this?

    Thanks!

    • Hey scribu,

      the problem with displaying every version note between the currently installed plugin version and the latest available is that it would definately be too much of information.

      I got several inquiries on the same issue as yours, and working on a space-saving solution already. 🙂

  4. Just downloaded the new version. Interesting solution to the screen space problem.

    Only trouble is that you have to wait a while each time you click the navigation. Wouldn’t it be possible to load the entire readme upfront, instead of getting bits through AJAX?

    Also, I noticed that when you click back, an AJAX request is made again, instead of caching the results.

    Either way, thanks for the updated version 🙂

    • Hey scribu,

      well, I’ll see if i’ll provide an alternative way of displaying the changelog, but as for me the AJAX’y way of displaying changelogs is a valid way of handling the huge amount of changelog data along with other plugin-specific data on the plugin page.

      But let’s see. I’ll see and wair what other users are saying. 🙂

  5. Hi,
    Recently Changelog stopped working – it says that changelog section exists but is not readable. Could you fix this?

    BTW, Thanks for this great plugin 🙂

  6. The current version (1.2.6) throws the following error while trying to activate:

    “Plugin could not be activated because it triggered a fatal error.

    Parse error: syntax error, unexpected T_STRING, expecting T_OLD_FUNCTION or T_FUNCTION or T_VAR or ‘}’ in /home/mysite/public_html/blog/wp-content/plugins/changelogger/changelogger.php on line 65”

    Please check.

    • Hey Raj,

      thanks for letting me know. I guess you’re running on PHP4? I fixed the error with version 1.2.7 that should be available in a few minutes.

  7. Great plugin, one of the first I install 🙂

    Would it be possible to add support for when bulk updating plugins from /wp-admin/update-core.php ?

    • Hey Adam,

      good idea, unfortunately there are no hooks provided for the plugin updates list at /wp-admin/update-core.php. I’ll keep my eyes open for when they add hooks in future versions of WP. 🙂

  8. Solid plugin, however after one recent update, I notice that all the “v”s in the changelog message for each plugin on the “Plugins” page is omitted. Has anyone else experienced this?

    For example, the word “very” shows up as “ery”, and so on

  9. I’ve updated to WordPress 3.0 and Changelogger no longer is showing on the Plugins page. I’m not sure if it is a conflict with another plugin or not.

  10. Hi!

    Changelogger doesn’t work for me anymore. I can send you a screenshot and more details (plugins installed, etc) if you want, send me an email!

  11. The changelog plug in worked fine for me, after following all these questions and answers, thanks to all of you.

      • Ah, so when an update are available for a plugin then will your plugin show the content of it. Ok lets wait and see when this occurs,

Leave a Comment