XML::RAI::Item(3)     User Contributed Perl Documentation    XML::RAI::Item(3)



NAME
       XML::RAI::Item - An interface to the item elements of a RSS feed.

DESCRIPTION
       A subclass of XML::RAI::Object, XML::RAI::Item handles the mapping
       function and retrieval of RSS item elements.

METHODS
       $item->src
           Returns the XML::RSS::Parser::Element that the object is using as
           its source.

       $item->parent
           Returns the parent of the RAI object.

       $item->add_mapping(key, @xpaths)
           Creates or appends XPath mappings to the item object for
           extensibility and easier access of RAI.

   META DATA ACCESSORS
       These accessor methods attempt to retrieve meta data from the source
       XML::RSS::Parser element by checking a list of potential tag names
       until one returns a value.  They are generally based on Dublin Core
       terminology and RSS elements that are common across the many formats.
       If called in a SCALAR context, the value of the first element of the
       tag being matched is returned. If called in an ARRAY context it will
       return all of the values to the tag being matched -- it does not return
       all of the values for all of the tags that have been mapped to the
       method. (Note that some mappings only allow one value to be returned.)
       Returns "undef" if nothing could be found.

       The following are the tags (listed in XPath notation) mapped to each
       method and the order in which they are checked.

       $item->abstract
           o   dcterms:abstract

           o   description

           o   dc:description

       $item->content
           o   xhtml:body

           o   xhtml:div

           o   content:encoded

           o   description

           o   dc:description

           o   rss091:description

       $item->content_strict
           o   xhtml:body

           o   xhtml:div

           o   content:encoded

       $item->contentstrict
           o   xhtml:body

           o   xhtml:div

           o   content:encoded

       $item->contributor
           o   dc:contributor

       $item->coverage
           o   dc:coverage

       $item->created
           o   dcterms:created

           o   dc:date

           o   pubDate

           o   rss091:pubDate

       $item->created_strict
           o   dcterms:created

       $item->creator
           o   dc:creator

           o   author

       $item->description
           o   description

           o   dc:description

           o   dcterms:abstract

       $item->format
           o   dc:format

       $item->identifier
           o   dc:identifier/@rdf:resource

           o   dc:identifier

           o   guid

           o   link

       $item->issued
           o   dcterms:issued

           o   dc:date

           o   pubDate

           o   rss091:pubDate

       $item->issued_strict
           o   dcterms:issued

       $item->language
           o   @xml:lang

           o   dc:language

           o   /@xml:lang

           o   /channel/dc:language

           o   /channel/language

           o   /channel/rss091:language

       $item->link
           o   link

           o   @rdf:about

           o   guid[@isPermaLink="true"]

       $item->modified
           o   dcterms:modified

           o   dc:date

           o   pubDate

           o   rss091:pubDate

       $item->modified_strict
           o   dcterms:modified

       $item->ping
           o   trackback:ping/@rdf:resource

           o   trackback:ping

       $item->pinged
           o   trackback:about/@rdf:resource

           o   trackback:about

       $item->publisher
           o   dc:publisher

           o   /channel/dc:publisher

           o   /channel/managingEditor

           o   /channel/rss091:managingEditor

       $item->relation
           o   dc:relation/@rdf:resource

           o   dc:relation

       $item->rights
           o   dc:rights

           o   /channel/copyright

           o   /channel/creativeCommons:license

           o   /channel/rss091:copyright

       $item->source
           o   dc:source

           o   source

       $item->subject
           o   dc:subject

           o   category

       $item->title
           o   title

           o   dc:title

       $item->type
           o   dc:type

       $item->valid
           o   dcterms:valid

           o   expirationDate

           The "ping" and "pinged" methods have been moved into their own RAI
           plugin. See XML::RAI::TrackBack for more.

AUTHOR & COPYRIGHT
       Please see the XML::RAI manpage for author, copyright, and license
       information.

POD ERRORS
       Hey! The above document had some coding errors, which are explained
       below:

       Around line 95:
           =begin without a target?

       Around line 108:
           '=item' outside of any '=over'

       Around line 124:
           You forgot a '=back' before '=head2'

       Around line 462:
           You forgot a '=back' before '=head1'

       Around line 469:
           '=end' without a target?



perl v5.16.3                      2005-11-20                 XML::RAI::Item(3)
