Provided by: libtemplate-plugin-xml-perl_2.17-3_all bug


       Template::Plugin::XML::RSS - Plugin interface to XML::RSS


           [% USE news = XML.RSS('news.rdf') %]

           [% FOREACH item IN news.items %]
              [% item.title %]
              [%  %]
           [% END %]


       This Template Toolkit plugin provides a simple interface to the XML::RSS module.

           [% USE news = XML.RSS('mysite.rdf') %]

       It creates an XML::RSS object, which is then used to parse the RSS file specified as a
       parameter in the USE directive.  A reference to the XML::RSS object is then returned.

       An RSS (Rich Site Summary) file is typically used to store short news 'headlines'
       describing different links within a site.  This example is extracted from

           <?xml version="1.0"?>

               <title>Slashdot:News for Nerds. Stuff that Matters.</title>
               <description>News for Nerds.  Stuff that Matters</description>


               <title>DVD CCA Battle Continues Next Week</title>

               <title>Matrox to fund DRI Development</title>

               <title>Mike Shaver Leaving Netscape</title>


       The attributes of the channel and image elements can be retrieved directly from the plugin
       object using the familiar dotted compound notation:

           [%  %]
           [%   %]
           [% %]

           [% news.image.title    %]
           [% news.image.url      %]
           [%     %]
           [% news.image.etc...   %]

       The list of news items can be retrieved using the 'items' method:

           [% FOREACH item IN news.items %]
              [% item.title %]
              [%  %]
           [% END %]


       This plugin was written by Andy Wardley inspired by an article in Web Techniques by Randal

       The XML::RSS module, which implements all of the functionality that this plugin delegates
       to, was written by Jonathan Eisenzopf.


       Copyright (C) 1996-2006 Andy Wardley.  All Rights Reserved.

       This module is free software; you can redistribute it and/or modify it under the same
       terms as Perl itself.


       Template::Plugin, XML::RSS, XML::Parser