mediawiki-extensions-RSS/RELEASE-NOTES

RELEASE NOTES of the MediaWiki extension RSS
http://www.mediawiki.org/wiki/Extension:RSS

=== TO DO ===
* set an upper default limit for HttpRequest request size when fetching feeds
  doing a HEAD request first to ask for the size but that value may not be
  available. Check how much data is returned as its coming back
  in which case you'd override the content fetch callback and count data as it
  comes in or check the header, again, if it's provided, at the start of data
  coming in. Then you could abort cleanly once it's gotten too much
  (otherwise using the defaults - PHP will abort the entire program when your
  memory usage gets too high)

=== Version 2.10 2012-02-27 ===
* final solution of bug 30028 "Error parsing XML for RSS" - improve and harden
  Extension:RSS when parsing differently flavoured RSS feeds and ATOM feeds
* new parameter $wgRSSUrlNumberOfAllowedRedirects (default = 0)
  Some feed urls redirect. The new RSS version can deal with redirects,
  but it must be expressly enabled. For example, you can set
  $wgRSSUrlNumberOfAllowedRedirects = 1;

=== Version 2.01 2012-02-24 ===
* "summary" element of ATOM feed items are shown
  which is handled like "description" element of RSS
* handling of basic HTML layout tags <p> <br> <b> <i> <u> <s> in item description

=== Version 2.00 2012-02-24 ===
* first version which can parse RSS and at least some ATOM feeds
  partial solution of bug 30028 "Error parsing XML for RSS" - improve and harden
  Extension:RSS when parsing differently flavoured RSS feeds and ATOM feeds

=== Version 1.94 2012-02-23 ===
* changed white list definition and behaviour:

  1. changed the name from $wgRSSAllowedFeeds to $wgRSSUrlWhitelist
  2. behaviour has been changed

  the new behaviour is:
  $wgRSSUrlWhitelist is empty by default. Since version 1.94 it must be 
  expressly set to an array( list-of-comma-separated-allowed-RSS-urls-strings )
  or set to array( "*" ) if you want to allow any url

  the old behaviour was:
  $wgRSSAllowedFeeds was empty by default and empty meant that every Url
  was allowed by default. This has been changed, see new behaviour.

=== Version 1.92 2012-02-13 ===
* added optional date= attribute and $wgRSSDateDefaultFormat parameter
* added optional item-max-length= attribute and $wgRSSItemMaxLength parameter
  fixes bug 30377 add a new parameter to limit the number of characters when 
  rendering the channel item <description>

=== Version 1.90 2011-08-15 ===
* removed parsing of each single channel subelement (item)
* only the finally constructed feed is sent to the recursive parser:
  in pre-1.9 versions, each channel subelement (item) was sent to the parser
* [[MediaWiki:Rss-item]] default has channel subelement <description> added
* Rss template default name has been changed:

  until 1.8:  [[Template:RSSPost]]
        1.9:  [[MediaWiki:Rss-feed]], an existing [[Template:RSSPost]]
	      takes precedence to be compatible to pre-1.9 versions
* introducing [[MediaWiki:Rss-feed]] with a meaningful default.
  The channel subelements which make the feed are rendered in this
  new standard layout:
  * <title>
  : <description>
  : <author> <date>
* There are several ways to customize the final layout of feed items:
  1. Admins can change the [[MediaWiki:Rss-feed]] default page
  2. Users can use the optional template= parameter to tell the extension
     to render the feed with a different layout
     <rss template=Pagename>...</rss> use layout as in [[Template:Pagename]]
  3. <rss template=Namespace:Pagename>...</rss> use [[Namespace:Pagename]]

=== Version 1.8 2010-10-19 ===
* removed dependencies on Snoopy in favor of MediaWiki's internal HttpRequest
* removed MagpieRSS (perhaps to be replaced later with SimplePie)
  because of concerns about MagpieRSS's security problems and
  lack of maintenance.
* Added ability to do more with the layout of RSS feeds.

=== Version 1.7 2010-07-23 ===
* cleaned up, included MagpieRSS library
* put into the WMF subversion repository by Jeroen De Dauw
  http://www.mediawiki.org/wiki/User:Jeroen_De_Dauw
* i18n file added by TranslateWiki.net people

== Change Log of pre-1.7 versions 2010 and before ==
(latest on top)
*modified by [[User:K001|K001]] 15:15, 26 January 2010 (UTC): version 1.6, added support for date formats
*modified by Peter Newman: 03:15, 7 October 2009 (UTC) Added htmlspecialchars escaping to the displayed strings
*modified by [[User:Cmreigrut|Cmreigrut]] 19:05, 19 November 2008 (UTC): added date (if specified) to short output
*modified by --[[User:Wikinaut|Wikinaut]] 11:17, 7 May 2008 (UTC) : changed method to disable chaching; Extension is now compatible to MediaWiki 1.12
*modified by Svanslyck 02.2008, replacing all « and » with "
*<del>This has been updated to work better on newer (1.9) MediaWiki software, with the help of [[User:Duesentrieb]]. --[[User:CryptoQuick|CryptoQuick]] 14:26, 24 January 2007 (UTC)</del>
**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;[[User:Alxndr|Alxndr]]&#x00a0;<sup>([[User talk:Alxndr|t]])</sup> 02:02, 16 June 2007 (UTC)
***I just found [http://nako.us/2007/03/16/mediawiki-19-fix-for-wfstrencode/ 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;[[User:Alxndr|Alxndr]]&#x00a0;<sup>([[User talk:Alxndr|t]])</sup> 02:18, 16 June 2007 (UTC)
*modified by Alxndr 09.2006
*modified by Dzag 07.2006
*extended by Niffler 28.02.2006
*extended by Mafs  10.07.2005, 24.07.2005
*extended by Rdb78 07.07.2005
*extended by Duesentrieb 30.04.2005
*original by mutante 25.03.2005