Syndication

extern.php is used to include information about your board from pages outside the forums and to syndicate news about recent discussions via RSS / Atom / XML. The script is able to display a list of recent discussions, a list of active users or a collection of general board statistics. It can be called directly via an URL, from a PHP include command or through the use of Server Side Includes (SSI).

The script behaviour is controlled via variables supplied in the URL to the script. The different variables are: action (what to do), show (how many items to display), fid (the ID or ID's of the forum(s) to poll for topics), nfid (the ID or ID's of forums that should be excluded), tid (the ID of the topic from which to display posts) and type (output as HTML or RSS). The only mandatory variable is action. Possible/default values are:

Examples

Here are some examples using PHP include().

include('http://host.com/extern.php?action=stats');

include('http://host.com/extern.php?action=feed&show=10&fid=5,6,7');

include('http://host.com/forums/extern.php?action=online');

include('http://host.com/forums/extern.php?action=online_full');

And finally some examples using extern.php to output an RSS, ATOM, XML, HTML feed.

http://host.com/extern.php?action=feed&type=rss

http://host.com/extern.php?action=feed&type=atom

http://host.com/extern.php?action=feed&type=xml

http://host.com/extern.php?action=feed&type=html