Allows you to add notes to plugins.
Where is the Plugin Notes data stored?
The notes are stored in the options table of the database.
Which variables can I use ?
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_PATH% : Plugin uri path on your website
%WPURI% : 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!)
%WPURI_LINK% : A link to the above WordPress repository of the plugin
Already showing for each plugin (less useful):
%NAME%: Plugin Name
%URI%: URI of the plugin website
%AUTHOR%: Name of the plugin author
%AUTHORURI%: Website of the plugin author
%VERSION%: Current plugin version
%DESCRIPTION%: Description of the plugin
Can I use the markdown syntax in the notes ?
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’ );
How do I use Markdown syntax?
Please refer to markdown syntax.
Can I use html in the notes ?
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.
Can I change the allowed html tags ?
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;
}
Can I change the output of the plugin ?
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.
Example:
add_filter( ‘plugin_notes_note’, ‘your_function’, 8, 3 );
How can I translate the plugin?
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.