From Meta, a Wikimedia project coordination wiki
Jump to navigation Jump to search
Blue Glass Arrow.svg MediaWiki logo.png
This page should be moved to
Please do not move the page by hand. It will be imported by a administrator with the full edit history. In the meantime, you may continue to edit the page as normal.

This is a further modified

  • version of the RSS engine from User:Rdb78, which in turn is based on the
  • version of the RSS engine from User:Duesentrieb, which in turn is an extended
  • version of the RSS-feed extension by Mutante.

It now supports highlighting and filtering. Moreover, the wiki engine cache can be disabled as described on . Finally, the default encoding is set to ISO-8859-1.

# RSS-Feed Mediawiki extension
# 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
# Requires: 
#  * magpie rss parser <>
#  * iconv <>, see also <>
# Installation:
#  * put this file (rss.php) into the extension directory of your mediawiki installation 
#  * add the following to the end of LocalSettings.php: include("extensions/rss.php");
#  * make sure magpie can be found by PHP.
# Usage:
#  Use one section between <rss>-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.
#    * 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.
#    * reverse                 display the rss items in reverse order
# Example: 
#    <rss>|charset=UTF-8|short|max=5</rss>

if( !defined( 'MEDIAWIKI' ) ) {

$wgExtensionCredits['other'][] = array(
	'name' => 'rss feed extension',
	'author' => 'mutante, Duesentrieb, Rdb, Mafs',
	'version' => '09/2005',
	'url' => '',
	'description' => 'displays an rss feed on a wiki page'

#change this according to your magpie installation!

#install extension hook
$wgExtensionFunctions[] = "wfRssExtension"; 

#extension hook callback function
function wfRssExtension() { 
   global $wgParser;
   #install parser hook for <rss> tags
   $wgParser->setHook( "rss", "renderRss" );
#parser hook callback function
function renderRss( $input ) {
    global $wgOutputEncoding;
    $DefaultEncoding = "ISO-8859-1";
   $DisableCache = true;
   # $input = mysql_escape_string($input);
   if (!$input) return ""; #if <rss>-section is empty, return nothing
   #parse fields in rss-section
   $fields= explode("|",$input);
   $url= @$fields[0];
   $args= array();
   for ($i=1; $i<sizeof($fields); $i++) {
       $f= $fields[$i];
       if (strpos($f,"=")===False) $args[strtolower(trim($f))]= False;
       else {
               list($k,$v)= explode("=",$f,2);
	if (trim($v)==False) $args[strtolower(trim($k))] = False; 
	else $args[strtolower(trim($k))]= trim($v);

   #get charset from argument-array    
   $charset= @$args["charset"];
   if (!$charset) $charset= $DefaultEncoding;
    #get max number of headlines from argument-array
   $maxheads = @$args["max"];
   $headcnt = 0;
   #get short-flag from argument-array
   #if short is set, no description text is printed
   if (isset($args["short"])) $short = True; else $short = False;
    #get reverse-flag from argument-array
   if (isset($args["reverse"])) $reverse = True; else $reverse = False;
    #get highlight terms from argument-array    
   $rssHighlight= @$args["highlight"];
   $rssHighlight= str_replace("  "," ", $rssHighlight);
   $rssHighlight= explode(" ", trim($rssHighlight));
   #get filter terms from argument-array    
   $rssFilter= @$args["filter"];
   $rssFilter= str_replace("  "," ", $rssFilter);
   $rssFilter= explode(" ", trim($rssFilter));    
   #fetch rss. may be cached locally.
   #Refer to the documentation of magpie for details.
   $rss = @fetch_rss($url);
   #check for errors.
   if ($rss->ERROR) {
       return "<div>Failed to load RSS feed from $url: ".$rss->ERROR."</div>"; #localize...
   if (!is_array($rss->items)) {
       return "<div>Failed to load RSS feed from $url!</div>"; #localize...

   #Bild title line    
   $title= iconv($charset,$wgOutputEncoding,$rss->channel['title']);
   if ($rss->channel['link']) $title= "<a href='".$rss->channel['link']."'>$title</a>";
    if ($reverse) $rss->items = array_reverse($rss->items);
    $description = False; 
   foreach ($rss->items as $item) {
if ($item['description']) {$description = True; break;}
    #Bild items
   if (!$short and $description) { #full item list
       foreach ($rss->items as $item) {

	$d_text = true;
	$d_title = true;

               $href = trim(iconv($charset,$wgOutputEncoding,$item['link']));
               $title = trim(iconv($charset,$wgOutputEncoding,$item['title']));
	$d_title = wfRssFilter ($title, $rssFilter);
	$title= wfRssHighlight($title, $rssHighlight);
	#bild description text if desired
               if ($item["description"]) {
                       $text= trim(iconv($charset,$wgOutputEncoding,$item['description']));
                        #avoid pre-tags
                       $text= str_replace("\r"," ",$text);
                       $text= str_replace("\n"," ",$text);
                       $text= str_replace("\t"," ",$text);
					$d_text = wfRssFilter ($text, $rssFilter);
					$text= wfRssHighlight($text, $rssHighlight);
					$display = $d_text or $d_title;
			else   {
					$text = "";
					$display = $d_title;
		if ($display) {
               	$output.="<dt><a href='$href'>$title</a></dt>";
               	if ($text) $output.="<dd>$text</dd>\n";
        #Cut off output when maxheads is reached:
       if (++$headcnt == $maxheads)  break;
   else { #short item list
       foreach ($rss->items as $item) {
               $href = trim(iconv($charset,$wgOutputEncoding,$item['link']));
               $title = trim(iconv($charset,$wgOutputEncoding,$item['title']));
			$d_title = wfRssFilter ($title, $rssFilter);
			$title= wfRssHighlight($title, $rssHighlight);
				if ($d_title ) $output.="<li><a href='$href'>$title</a></li>";
                #Cut off output when maxheads is reached:
               if (++$headcnt == $maxheads)  break;

   if ($DisableCache) {
	global $wgVersion;
	# Do not cache this wiki page.
	# for details see
	global $wgTitle, $wgDBprefix;
	$ts = mktime();
	$now = gmdate("YmdHis", $ts + 120);
	$ns = $wgTitle->getNamespace();
	$ti = wfStrencode($wgTitle->getDBkey());

	$version = preg_replace("/^([1-9]).([1-9]).*/", "\\1\\2", $wgVersion);
	if ($version>14) $sql = "UPDATE $wgDBprefix"."page SET page_touched='$now' WHERE page_namespace=$ns AND page_title='$ti'";
	else             $sql = "UPDATE $wgDBprefix"."cur SET cur_touched='$now' WHERE cur_namespace=$ns AND cur_title='$ti'";

	wfQuery($sql, DB_WRITE, "");
    return $output;

 function wfRssFilter ($text, $rssFilter) {

	$display = true;
	if (is_array($rssFilter)) {
	foreach($rssFilter as $term) {
		if ($term) {
			$display = false;
			if (preg_match("|$term|i", $text, $a))  {  $display = true; return $display; }
	if ($display) break;
return $display;
function wfRssHighlight($text, $rssHighlight) {

$starttag = "v8x5u3t3u8h";
$endtag   = "q8n4f6n4n4x";

	$count_color = count($color);

if (is_array($rssHighlight)) {
	foreach($rssHighlight as $term) {
		if ($term) {
			$text = preg_replace("|\b(\w*?".$term."\w*?)\b|i", "$starttag"."_".$i."\\1$endtag", $text);
			if ($i == $count_color) $i=0;
# to avoid trouble should someone wants to highlight the terms "span", "style", ...
for ($i=0; $i<5; $i++) {
	$text = preg_replace("|$starttag"."_".$i."|", "<span style=\"background-color:".$color[$i]."; font-weight: bold;\">", $text);
	$text = preg_replace("|$endtag|", "</span>", $text);

return $text;

Improved Version by Niffler[edit]

Also have a look at User:niffler/RSS for a modified version with a few more features -- --Niffler 09:06, 28 February 2006 (UTC)

Another improved version[edit]

User:Alxndr/RSS supports filtering-out based on item title, and only displays unique items. —Alxndr (t) 19:54, 28 October 2006 (UTC)