ABOUT

webring provides an easy-to-configure solution for creating a webring. All URLs are stored in one file (webring.urls), and each link in the webring references one of three functions: next (next.php), previous (prev.php), or random (rand.php) at this site.

REQUIREMENTS

webring requires PHP>3 (tested on 3.015) with support for $HTTP_REFERER, and depends upon the loopedArray class (included). webring links will only work on browsers that allow redirects using the http-equiv meta tag.

ARCHITECTURE

webring uses the loopedArray object, which simulates a "looped" array data type with a number of basic functions. See "loopedArray.api" for an outline of how to use this class. See "webring.api" for an outline of the webring class.

CONFIGURATION

Simply add urls, one per line, to the file webring.urls. Then reference next.php, prev.php, and rand.php from the pages in your webring.

IMPORTANT SIDE EFFECTS

Note that if next.php or prev.php are referenced from URLs outside the web ring (not in the webring.urls file) the following behavior will occur:

• prev.php will redirect the last URL in webrings.url, or the root directory if webrings.url is empty
• next.php will redirect to the second URL in webrings.url, or the first URL in webrings.url if webrings.url only contains one URL, or the root directory if webrings.url is empty.

ADDENDUM

This software is released as-is, with no implications of warranty or fiteness to a particular use. The author implies no obligation to provide techincal support for this software on the part of himself or his company.

Robert@MSIA.org