Description
For best README.md support, the fields under the plugin title, Contributors.. Tags.. etc, should be in a similar format to this readme example. This means that there should be no characters after the : other than the value, no formatting, just a value and new line.
This is the long description. No limit, and you can use Markdown (as well as in the following sections).
For backwards compatibility, if this section is missing, the full length of the short description will be used, and
Markdown parsed.
A few notes about the sections above:
- “Contributors” is a comma separated list of wp.org/wp-plugins.org usernames
- “Tags” is a comma separated list of tags that apply to the plugin
- “Requires at least” is the lowest version that the plugin will work on
- “Tested up to” is the highest version that you’ve successfully used to test the plugin. Note that it might work on
higher versions… this is just the highest one you’ve verified. -
Stable tag should indicate the Subversion “tag” of the latest stable version, or “trunk,” if you use
/trunk/
for
stable.Note that the
readme.txt
of the stable tag is the one that is considered the defining one for the plugin, so
if the/trunk/readme.txt
file says that the stable tag is4.3
, then it is/tags/4.3/readme.txt
that’ll be used
for displaying information about the plugin. In this situation, the only thing considered from the trunkreadme.txt
is the stable tag pointer. Thus, if you develop in trunk, you can update the trunkreadme.txt
to reflect changes in
your in-development version, without having that information incorrectly disclosed about the current stable version
that lacks those changes — as long as the trunk’sreadme.txt
points to the correct stable tag.If no stable tag is provided, it is assumed that trunk is stable, but you should specify “trunk” if that’s where
you put the stable version, in order to eliminate any doubt.
Testing out some Markdown bugs:
Examples:
define( ‘TC_PRE’, ‘Theme Review:[[br]]
– Themes should be reviewed using “define(\’WP_DEBUG\’, true);” in wp-config.php[[br]]
– Themes should be reviewed using the test data from the Theme Checklists (TC)
—–
‘ );
define( 'TC_POST', 'Feel free to make use of the contact details below if you have any questions,
comments, or feedback:[[br]]
[[br]]
* Leave a comment on this ticket[[br]]
* Send an email to the Theme Review email list[[br]]
* Use the #wordpress-themes IRC channel on Freenode.' );
three backtics:
add_action( 'init', function() {
// do stuff
} );
or indents
add_action( ‘init’, function() {
// do stuff
} );
Arbitrary section
You may provide arbitrary sections, in the same format as the ones above. This may be of use for extremely complicated
plugins where more information needs to be conveyed that doesn’t fit into the categories of “description” or
“installation.” Arbitrary sections will be shown below the built-in sections outlined above.
A brief Markdown Example
Ordered list:
- Some feature
- Another feature
- Something else about the plugin
Unordered list:
- something
- something else
- third thing
Here’s a link to WordPress and one to Markdown’s Syntax Documentation.
Titles are optional, naturally.
Markdown uses email style notation for blockquotes and I’ve been told:
Asterisks for emphasis. Double it up for strong.
<?php code(); // goes in backticks ?>
Screenshots
Blocks
This plugin provides 4 blocks.
- Namespace Block Name
- Title here
- Title here
- Title here
Installation
This section describes how to install the plugin and get it working.
e.g.
- Upload
plugin-name.php
to the/wp-content/plugins/
directory - Activate the plugin through the ‘Plugins’ menu in WordPress.
- Place
<?php do_action('plugin_name_hook'); ?>
in your templates
FAQ
-
A question that someone might have
-
An answer to that question.
-
What about foo bar?
-
Answer to foo bar dilemma.
-
Markdown 1
-
`body, h1, p {
color: #f1f1f1 !important;
} -
wpwrap {
-
background-color: #5f5f5f !important;
}` -
Markdown 2
- wpwrap {
background-color: #5f5f5f !important; } body, h1, p { color: #f1f1f1 !important; }
Reviews
Contributors & Developers
“Test Plugin 3 – Testing plugin” is open source software. The following people have contributed to this plugin.
Contributors“Test Plugin 3 – Testing plugin” has been translated into 8 locales. Thank you to the translators for their contributions.
Translate “Test Plugin 3 – Testing plugin” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0
- A change since the previous version.
- Another change.
- Another change this time that means something.
- A changelog line to test https://meta.trac.wordpress.org/changeset/8412