XML::RAI::Item - An interface to the item elements of a RSS
feed.
A subclass of XML::RAI::Object, XML::RAI::Item handles the mapping
function and retrieval of RSS item elements.
- $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.
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
- dcterms:abstract
- description
- dc:description
- $item->content
- xhtml:body
- xhtml:div
- content:encoded
- description
- dc:description
- rss091:description
- $item->content_strict
- xhtml:body
- xhtml:div
- content:encoded
- $item->contentstrict
- xhtml:body
- xhtml:div
- content:encoded
- $item->contributor
- $item->coverage
- $item->created
- dcterms:created
- dc:date
- pubDate
- rss091:pubDate
- $item->created_strict
- $item->creator
- $item->description
- description
- dc:description
- dcterms:abstract
- $item->format
- $item->identifier
- dc:identifier/@rdf:resource
- dc:identifier
- guid
- link
- $item->issued
- dcterms:issued
- dc:date
- pubDate
- rss091:pubDate
- $item->issued_strict
- $item->language
- @xml:lang
- dc:language
- /@xml:lang
- /channel/dc:language
- /channel/language
- /channel/rss091:language
- $item->link
- link
- @rdf:about
- guid[@isPermaLink="true"]
- $item->modified
- dcterms:modified
- dc:date
- pubDate
- rss091:pubDate
- $item->modified_strict
- $item->ping
- trackback:ping/@rdf:resource
- trackback:ping
- $item->pinged
- trackback:about/@rdf:resource
- trackback:about
- $item->publisher
- dc:publisher
- /channel/dc:publisher
- /channel/managingEditor
- /channel/rss091:managingEditor
- $item->relation
- dc:relation/@rdf:resource
- dc:relation
- $item->rights
- dc:rights
- /channel/copyright
- /channel/creativeCommons:license
- /channel/rss091:copyright
- $item->source
- $item->subject
- $item->title
- $item->type
- $item->valid
- dcterms:valid
- expirationDate
The "ping" and
"pinged" methods have been moved into
their own RAI plugin. See XML::RAI::TrackBack for more.
Please see the XML::RAI manpage for author, copyright, and license
information.