Please read this entire file before installing and using this mod. Back up your YaBB files before installing any mod.
Once you have installed the mod and have saved your RSS Feed settings you are ready to access your forum's new RSS Feed via a RSS reader (aggregator). The basic URL for your RSS Feed is in the form:
http://www.mysite.com/cgi-bin/yabb/YaBB.pl?action=rss
This URL will feed posts from all the categories and boards which are checked in the RSS Feed Settings.
http://www.mysite.com/cgi-bin/yabb/YaBB.pl?action=rss;feedcat=mycategory
This URL will feed posts from all the boards checked in the category "mycategory". To use it, "mycategory" must be checked in the RSS Feed Settings. Note that "mycategory" is a Category ID, not the Category Name. For convenience, the Category ID for each category in your forum is listed in () after the Category Name in the RSS Feed Settings.
http://www.mysite.com/cgi-bin/yabb/YaBB.pl?action=rss;feedcat=mycategory.category2
This URL will feed posts from all the boards checked in the categories "mycategory" and "category2". To use it, "mycategory" and "category2" must be checked in the RSS Feed Settings. The posts from any non-checked boards in the two categories will be ignored.
http://www.mysite.com/cgi-bin/yabb/YaBB.pl?action=rss;feedboard=myboard.anotherboard
This URL will feed all the posts in boards "myboard" and "anotherboard" if the two boards are checked in the RSS Feed Settings.
Many boards or categories that can be added to a single URL, each separated by a period (.) character. Do not mix categories and boards in a single feed URL.
http://www.mysite.com/cgi-bin/yabb/YaBB.pl?action=rss;feedcat=mycategory;feedboard=myboard
This URL will produce no results.
The mod was tested using SharpReader 0.9.4.1. and output was validated using rss.scripting.com's validator. Many RSS readers are available. A simple web search should provide a RSS reader compatible with your operating system.
Note that the mod uses the Dublin Core (dc:) library for certain xml definitions. It is possible that from time to time the host server for the Dublin Core library may be down, causing feed validation errors.
Included with the mod is an RSS logo, rss_button.gif, that might be useful for putting links to your feed on your site.
The server time offset from GMT needs to be set manually. The reason is that the Time module used by YaBB overrides perl's default gmtime function and I haven't found a way to get at the gmtime index.
Author: Ironwing, AstroPilot, and hydepark2
Website: http://www.mineralarts.com/cgi/yabb2a/YaBB.pl
Changes from B6 to B7 by: SSR
A largish hunk of code in this mod came straight out of the Recent.pl file produced by the YaBB 2 Development Team.
Thank you to "macprime" (Stefan Rechsteiner) for alpha testing, suggestions, and for the german translation.