WordPress.org

Usage

To display information about a SVN repository in one of your texts you just have to insert the [svn:<element>@<repository>] tag in the desired spot.

The element can be one of these:

• head for the current revision
• author for the username of the last contributer
• date for the actual time of the last change
• log for the user provided message
• box for a predefined box containing all four of the above along with a download link (using WebSVN)

The repository can be either a full path (i.e. /home/user/svn/repo) or just the name of the repository (i.e. repo). This of course is according to the settings in the admin panel where you have to set the base path of your repositories for the name-method to work.

Example: The current version of my program is [svn:head@/home/user/svn/program]. or The current version of my program is [svn:head@program]. This is only working when the svn base path is set to /home/user/svn in the admin panel.

As of version 0.7 there are additional attributes which you can set for each repository inside the tag:

• [svn:<element>@<category><repository>] (With a specified WebSVN category. *This also works with the full path tag.)
• [svn:<element>@<repository>/path/path/] (A subdirectory for the WebSVN download. This does not work with full path tag.)
• [svn:<element>@<category>*<repository>/path/path/] (Or a combination of both...)

Please note that in version 0.7.1 the separator for category and repository changed from a dot (.) to an asterisk (*) to allow paths with dots in it. (Bugfix for Josh, thanks for reporting!)

If you want to show the full box, you better insert it between paragraphs and not in the middle of your text, as it will bust your format. Also it is a good idea to use a wider theme than the default one to get the best formated box. The result is shown in the screenshot section.

Limitations

• The Plugin is limited quite a bit in its current form, as there is only support for the current (HEAD) revision.
• Also the use of WebSVN is mandatory to get a working download link.
• Subdirectory download is only possible if the full path tag isn't in use.