[wp-hackers] WP SVN

[Michael D Adams]

On Feb 12, 2008, at 2:27 AM, Mário Gamito wrote:

> Hi,
>
> I've uploaded a plugin I wrote: http://wordpress.org/extend/plugins/ 
> comments-statistics/

That repository needs to contain the following directories:

trunk/
tags/

trunk/ holds the in-development version of you plugin and tags/  
contains sub-directories each with a released versions of your plugin:

tags/0.2.1/
tags/0.2.2/
...

At a minimum, trunk/ and each tags/sub-directory/ should contain a  
readme.txt file and a WordPress plugin file.

readme.txt files need to follow the following standard format:
http://svn.wp-plugins.org/comments-statistics/readme.txt

A WordPress plugin file is a PHP file with a plugin header:
http://codex.wordpress.org/Writing_a_Plugin#Standard_Plugin_Information

By default the WordPress Plugins Directory will use the trunk/  
version of your plugin.  If you want to tell it to use one of your  
tagged versions (a version in a tags/sub-directory/), you must  
specify in trunk/readme.txt a "Stable tag" line such as the following.

Stable tag: 0.2.2


So, for your Display Comments Statistics plugin, your repository  
should look like the following.

trunk/readme.txt
trunk/dcs.php
trunk/... (other files)

tags/0.2.1/readme.txt
tags/0.2.1/dcs.php (the old 0.2.1 version of you plugin)
tags/0.2.1/...

tags/0.2.2/readme.txt
tags/0.2.2/dcs.php
tags/0.2.2/...

And your trunk/readme.txt file should look something like:


=== Display Comments Statistics ===
Contributors: gamito
Tags: comments, stats, statistics
Stable tag: 0.2.2

Display comments statistics about platforms and browsers.


Here's some other resources you may find useful or informative:

Validator for readme.txt files
http://wordpress.org/extend/plugins/about/validator/

Using Subversion:
http://wordpress.org/extend/plugins/about/svn/

Plugin Developer FAQ:
http://wordpress.org/extend/plugins/about/faq/

Cheers,
Mike