Plugin Notes

Allows you to add notes to plugins. Useful when you’re using lots of plugins and/or make modifications to a plugin and want to make a note of them, and/or work on your WordPress install with a group of people. This plugin was inspired by a post by Chris Coyier: (


  • Add/edit/delete notes for each plugin on the plugin page
  • You can use HTML in notes (v1.1+)
  • You can use markdown syntax in notes (v1.5+)
  • You can use a number of variables which will be automagically replaced when the note displays (v1.5+)
  • Save a note as a template for new notes (v1.5+)
  • You can color-code notes to see in one glance what’s up or down (v1.6+)
  • Links within note automagically have target="_blank" added so you won’t accidently leave your site while working with the plugins.

Please have a look at the FAQ for more information about these features.


Markdown script: PHP Markdown 1.0.1.o

External link indicator: liberally nicked from the Better WP External Links plugin


Dutch – jrf

Please help us make this plugin available in more language by translating it. See the FAQ for more info.


Latest version: Download Plugin Notes v1.6 [zip]


  1. Extract the .zip file and upload its contents to the /wp-content/plugins/ directory. Alternately, you can install directly from the Plugin directory within your WordPress Install.
  2. Activate the plugin through the “Plugins” menu in WordPress.
  3. Add notes to your plugins from the Manage Plugins page (Plugins > Installed)
  4. Party.


Q. Where is the Plugin Notes data stored?
A. The notes are stored in the options table of the database.

Q. Which variables can I use ?
A. There are a number of variables you can use in the notes which will automagically be replaced. Most aren’t that useful as the info is provided by default for the plugin, but they are included anyway for completeness.

Example use: you want a link to the WordPress Plugin repository for each plugin.
Instead of manually adding each and every link, you can just add the following note to each plugin and the link will be automagically placed:

Plugin: %WPURI_LINK%

Available variables:


Plugin uri path on your website


URI of the WordPress repository of the plugin (Please note: it is not tested whether the plugin is actually registered in the WP plugin repository!)


A link to the above WordPress repository of the plugin

Already showing for each plugin (less useful):


Plugin Name


URI of the plugin website


Name of the plugin author


Website of the plugin author


Current plugin version


Description of the plugin

Q. Can I use the markdown syntax in the notes ?
A. Yes, you can use markdown.
The markdown syntax conversion is done on the fly. The notes are saved to the database without conversion.

Don’t like markdown ?
Just add the following snippet to your (child-)themes functions.php file to turn markdown parsing off:

add_filter( 'plugin_notes_markdown', '__return_false' );

Q. How do I use Markdown syntax?
A. Please refer to markdown syntax.

Q. Can I use html in the notes ?
A. Yes, you can use html in the notes. The following tags are allowed: a, br, p, b, strong, i, em, u, img, hr.
The html is saved to the database with the note.

Q. Can I change the allowed html tags ?
A. Yes, you can, though be careful as you might open up your WP install to XSS attacks.

To change the allowed html tags, just add a variation of the following snippet to your (child-)themes functions.php file:

add_filter( 'plugin_notes_allowed_tags', 'your_function', 10, 1 );
function your_function( $allowed_tags ) {
    //do something with the $allowed_tags array
    return $allowed_tags;

Q. Can I change the output of the plugin ?
A. Yes, you can. There are filters provided at three points:
1. The actual note to be displayed -> plugin_notes_note
1. The html for the note including the surrounding box -> plugin_notes_row
1. The html for the input form -> plugin_notes_form

Hook into those filters to change the output before it’s send to the screen.

add_filter( 'plugin_notes_note', 'your_function', 10, 3 );
function your_function( $note, $plugin_data, $plugin_file ) {
    //do something
    return $output;
add_filter( 'plugin_notes_row', 'your_function', 10, 3 );
function your_function( $output, $plugin_data, $plugin_file ) {
    //do something
    return $output;
add_filter( 'plugin_notes_form', 'your_function', 10, 2 );
function your_function( $output, $plugin_safe_name ) {
    //do something
    return $output;

If you want to filter the note output before the variable replacements are made and markdown syntax is applied, set the priority for your plugin_notes_note filter to lower than 10.


add_filter( 'plugin_notes_note', 'your_function', 8, 3 );

Q. How can I translate the plugin?
A. The plugin is translation ready, though there is not much to translate. Use the /languages/plugin-notes.pot file to create a new .po file for your language. If you would like to offer your translation to other users, please open a pull request on GitHub.


2015-06-13 / 1.6 Originally released Dec 2012 by jrf

  • [New feature] Added ability to change the background color of notes.

2015-06-09 / 1.5 Originally released Dec 2012 by jrf

  • [Bug fix] Fixed AJAX delete bug (kept ‘waiting’).
  • [New feature] Added output filters for html output (plugin_notes_row and plugin_notes_form) and the note itself (plugin_notes_note).
  • [New feature] Added ability to use a number of variables in notes which will automagically be replaced – see FAQ for more info.
  • [New feature] Added ability to use markdown syntax in notes – see FAQ for more info.
  • [Usability improvement] Added <hr /> to allowed tags list and made the tag list filterable through the new plugin_notes_allowed_tags filter.
  • [Usability improvement] Made the default text area for adding a note larger.
  • [Usability improvement] Added automagical target=”_blank” to all links in plugin notes including external link indicator.
  • [Usability improvement] Added contextual help for WP 3.3+,
  • [Usability improvement] Added FAQ section and plugin license info to the readme file ;-)
  • [Usability improvement] Added uninstall script for clean uninstall of the plugin.
  • [Usability improvement] Added minified versions of the js and css files.
  • [I8n] Created .POT file and added Dutch translation.
  • [Security] Improved output escaping.

2015-04-15 / 1.2

  • Fix strict warning: Redefining already defined constructor.
  • Version bump for WordPress 4.1.

2010-10-15 / 1.1

  • Certain HTML tags are now allowed in notes: <p> <a> <b> <strong> <i> <em> <u> <img>. Thanks to Dave Abrahams for suggesting this feature.
  • Some style tweaks
  • Fixed PHP Error Notices

2009-12-04 / 1.0

  • Fixed a major bug that was causing fatal errors
  • Added some inline code comments
  • Changed around some minor styling.
  • Bumping release number up to 1.0 because I feel like it

2009-10-24 / 0.1

  • Initial beta release

3 thoughts on “Plugin Notes

  1. Hi Mohammad,
    Thank you for an excellent plugin. I run on: MySQL version 5.1.45-log, Apache 2.2.14, PHP 5.2.11
    Still I have an issue with it. For testing reasons I wrote some notes. I then uninstalled and deleted your plugin from my test site. All my notes were gone. Something that was, of course, expected. I then deactivating and deleting other plugins.
    But. I re-upload and reactivated your plugin and the notes were still GONE. GONE. Gone with the wind…. From ALL plugins. Not very convenient.
    When I checked my phpMyAdmin database the data was still there, but it did not show up. Furthermore, when I tried adding a new note, all the previously installed data were deleted and this time, really gone from the database.
    I think that this is quite an issue. Could you please look into it?
    Thank you in advance,

  2. Hello again Mohammad,
    Time passed and we are now on WordPress 3.1
    So….. Another idea/request

    At present when activated either via “network activate” or for the individual sites works fine on super-admin plugins as well as for site-admins.

    I think it should be the other way around. It should give info to super-admins ONLY (and if possible to chosen admins as well). I mean I want (as super-admin) to keep notes to myself for the different plugins and not have every single admin in my multisite installation read them

    Anyway, just my thoughts…
    Thank you again, marikamitsos

  3. After more investigation on a live site I found that the plugin works fine and only ppl with “edit-plugins” capabilities can view or change the notes.
    Still I think it would be an improvement if ppl not allowed to edit plugins also did not see the message about putting a note in the first place.
    Great work, thank you for sharing.

Leave a Reply