xml::rss::libxml::magicelement(3pm) [debian man page]

XML::RSS::LibXML::MagicElement(3pm)			User Contributed Perl Documentation		       XML::RSS::LibXML::MagicElement(3pm)

NAME

       XML::RSS::LibXML::MagicElement - Represent A Non-Trivial RSS Element

SYNOPSIS

	 us XML::RS::LibXML::MagicElement;
	 my $xml = XML::RSS::LibXML::MagicElement->new(
	   content => $textContent,
	   attributes => @attributes
	 );

DESCRIPTION

       This module is a handy object that allows users to access non-trivial RSS elements in XML::RSS style. For example, suppose you have an RSS
       feed with an element like the following:

	 <channel>
	   <title>Example</title>
	   <tag attr1="foo" attr2="bar">baz</tag>
	   ...
	 </channel>

       While it is simple to access the title element like this:

	 $rss->{channel}->{title};

       It was slightly non-trivial for the second tag. With this module, <tag> is parsed as a XML::RSS::LibXML::MagicElement object and then you
       can access all the elements like so:

	 $rss->{channel}->{tag};  # "baz"
	 $rss->{channel}->{tag}->{attr1}; # "foo"
	 $rss->{channel}->{tag}->{attr2}; # "bar"

METHODS

   new
       Create a new MagicElement object.

   attributes
       Returns the list of attributes associated with this element

   toString
       Returns the string representation of this object.  By default we use the "text content" of the found tag, but for XML::RSS compatibility,
       we use the concatenation of the attributes if no content is found.

AUTHOR

       Copyright 2005 Daisuke Maki <dmaki@cpan.org>. All rights reserved.

       Development partially funded by Brazil, Ltd. <http://b.razil.jp>

perl v5.12.4							    2011-09-17				       XML::RSS::LibXML::MagicElement(3pm)

Template::Plugin::XML::RSS(3pm) 			User Contributed Perl Documentation			   Template::Plugin::XML::RSS(3pm)

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 nota-
       tion:

	   [% 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

perl v5.8.8							    2008-03-01					   Template::Plugin::XML::RSS(3pm)