Andy Wardley > Template-XML > Template::Plugin::XML::RSS

Download:
Template-XML-2.17.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  3
Open  0
View/Report Bugs
Module Version: 2.66   Source  

NAME ^

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

SYNOPSIS ^

    [% USE news = XML.RSS('news.rdf') %]
   
    [% FOREACH item IN news.items %]
       [% item.title %]
       [% item.link  %]
    [% END %]

DESCRIPTION ^

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 http://slashdot.org/slashdot.rdf.

    <?xml version="1.0"?>
    <rdf:RDF
      xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
      xmlns="http://my.netscape.com/rdf/simple/0.9/">
    
      <channel>
        <title>Slashdot:News for Nerds. Stuff that Matters.</title>
        <link>http://slashdot.org</link>
        <description>News for Nerds.  Stuff that Matters</description>
      </channel>
    
      <image>
        <title>Slashdot</title>
        <url>http://slashdot.org/images/slashdotlg.gif</url>
        <link>http://slashdot.org</link>
      </image>
      
      <item>
        <title>DVD CCA Battle Continues Next Week</title>
        <link>http://slashdot.org/article.pl?sid=00/01/12/2051208</link>
      </item>
      
      <item>
        <title>Matrox to fund DRI Development</title>
        <link>http://slashdot.org/article.pl?sid=00/01/13/0718219</link>
      </item>
      
      <item>
        <title>Mike Shaver Leaving Netscape</title>
        <link>http://slashdot.org/article.pl?sid=00/01/13/0711258</link>
      </item>
      
    </rdf:RDF>

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

    [% news.channel.title  %]
    [% news.channel.link   %]
    [% news.channel.etc... %]  

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

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

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

AUTHORS ^

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

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

COPYRIGHT ^

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.

SEE ALSO ^

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

syntax highlighting: