Creating a readme.txt File

If you are planning to submit your plugin to the WordPress Plugin Directory, you must also include a standard readme.txt file. This is a required file and your plugin won't be accepted to the Plugin Directory without it. The format of this text file is important because it contains necessary information about your plugin that users can open and read, as well as information that displays on your plugin's page within the Plugin Directory. The information in this file includes required and optional elements, as described in Table 6-1.

Table 6-1 Required and Optional Elements for the readme.txt Plugin File

image

image

An example of a properly formatted readme.txt file looks like this (this one contains all the required components):

=== WordPress Twitter Connect === Contributors: LSWilson Tags: twitter, social media Requires at least: 2.7 Tested up to: 3.0 Stable tag: trunk Submits your WordPress blog posts to your Twitter account when you publish. == Description == Use this plugin to automatically submit your blog posts to your Twitter account when you hit the publish button. You can also submit your blog posts to multiple Twitter accounts, specified in the WordPress Twitter Connect options page in your Dashboard. == Installation == Extract the zip file and just drop ...

Get WordPress® All-in-One For Dummies® now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.