Extension:RSS

Displays an RSS feed on a wiki page

Installation
(Make sure there's a semicolon at the end of that line)
 * 1) Save the source in your /extensions directory in a file named rss.php
 * 2) Download and save the Magpie RSS parser into the same directory. Magpie can be downloaded from SourceForge. Don't install Magpie and ignore Magpie's installation instructions - just drop the parser into your /extensions directory.
 * Optional - Check that iconv is installed; this can be done with a simple phpinfo; script.
 * 1) Place the following text in your LocalSettings.php file: require_once("$IP/extensions/rss.php");
 * 1) Make sure Magpie can be found by PHP.
 * 2) Finally, load your wiki, and have fun with RSS feeds!

Usage
Use one section between -tags for each feed. The rss section may contain parameters separated by a pipe ("|"), just like links and templates. These parameters are supported:


 * charset=…              The charset used by the feed. iconv is used to convert this.
 * short                  Do not show the description text for each news item.
 * date                   Shows date/time stamp for each news item.
 * max=x                  Shows x most recent headlines.
 * highlight= term1 term2 The terms separated by a space are highlighted.
 * filter= term1 term2    Show only RSS items containing at least one of the terms.
 * filterout= term1 term2 Do not show any RSS items containing any terms
 * reverse                Display the RSS items in reverse order

This extension supports filtering-out (i.e. ) items based on title when in short list mode. It only displays unique titles.

Example
 http://rss.slashdot.org/Slashdot/slashdot|charset=UTF-8|short|date|max=5 

Technical history
RSS extension is a modified version of
 * the RSS engine from Mafs, which is a modified version of
 * the RSS engine from Rdb78, which is a modified version of
 * the RSS engine from Duesentrieb, which is a modified version of
 * the RSS-feed extension by Mutante.

Change Log

 * original by mutante 25.03.2005
 * extended by Duesentrieb 30.04.2005
 * extended by Rdb78 07.07.2005
 * extended by Mafs 10.07.2005, 24.07.2005
 * extended by Niffler 28.02.2006
 * modified by Dzag 07.2006
 * modified by Alxndr 09.2006
 * modified by Svanslyck 02.2008, replacing all « and » with "
 * This has been updated to work better on newer (1.9) MediaWiki software, with the help of User:Duesentrieb. --CryptoQuick 14:26, 24 January 2007 (UTC)
 * This appears not to be true; I have received numerous emails about it not working with 1.9+. I would love to help debug and fix the extension, but my host has not upgraded to PHP 5 and I'm thus stuck at MediaWiki 1.6.8, so that's as far as this is guaranteed to work properly. If anyone develops a fix, please post a link to it here! &#x2014;Alxndr&#x00a0;(t) 02:02, 16 June 2007 (UTC)
 * I just found this fork that purports to have a fix for the new loss of wfStrEncode. I can't test it though so can anyone else verify that it works? &#x2014;Alxndr&#x00a0;(t) 02:18, 16 June 2007 (UTC)
 * modified by --Wikinaut 11:17, 7 May 2008 (UTC) : changed method to disable chaching; Extension is now compatible to MediaWiki 1.12
 * modified by Cmreigrut 19:05, 19 November 2008 (UTC): added date (if specified) to short output
 * modified by Peter Newman: 03:15, 7 October 2009 (UTC) Added htmlspecialchars escaping to the displayed strings