The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

XML::RAI::Channel - An interface to the channel elements of a RSS feed.

DESCRIPTION

A subclass of XML::RAI::Object, XML::RAI::Channel handles the mapping function and retrieval of RSS channel elements.

METHODS

$channel->src

Returns the XML::RSS::Parser::Element that the object is using as its source.

$channel->parent

Returns the parent of the RAI object.

$channel->add_mapping(key, @xpaths)

Creates or appends XPath mappings to the channel 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.

$channel->contributor
  • dc:contributor

$channel->coverage
  • dc:coverage

$channel->creator
  • dc:creator

$channel->description
  • description

  • dc:description

  • dcterms:abstract

  • dcterms:alternative

$channel->format
  • dc:format

$channel->generator
  • admin:generatorAgent/@rdf:resource

  • admin:generatorAgent

  • generator

$channel->identifier
  • dc:identifier/@rdf:resource

  • dc:identifier

  • link

$channel->issued
  • dcterms:issued

  • dc:date

  • lastBuildDate

  • rss091:lastBuildDate

$channel->issued_strict
  • dcterms:issued

$channel->language
  • @xml:lang

  • dc:language

  • language

  • rss091:language

  • $channel->link

    • link

    • @rdf:about

  • $channel->maintainer

    • admin:errorReportsTo/@rdf:resource

    • admin:errorReportsTo

    • webMaster

  • $channel->modified

    • dcterms:modified

    • dc:date

    • lastBuildDate

    • rss091:lastBuildDate

  • $channel->modified_strict

    • dcterms:modified

  • $channel->publisher

    • dc:publisher

    • managingEditor

    • rss091:managingEditor

  • $channel->relation

    • dc:relation/@rdf:resource

    • dc:relation

  • $channel->rights

    • dc:rights

    • copyright

    • creativeCommons:license

    • rss091:copyright

  • $channel->source

    • dc:source

    • source

    • title

  • $channel->subject

    • dc:subject

    • category

  • $channel->title

    • title

    • dc:title

  • $channel->type

    • dc:type

  • $channel->valid

    • dcterms:valid

    • expirationDate

AUTHOR & COPYRIGHT

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

17 POD Errors

The following errors were encountered while parsing the POD:

Around line 83:

=begin without a target?

Around line 97:

'=item' outside of any '=over'

Around line 111:

You forgot a '=back' before '=head2'

Around line 234:

Expected '=item *'

Around line 244:

Expected '=item *'

Around line 256:

Expected '=item *'

Around line 270:

Expected '=item *'

Around line 278:

Expected '=item *'

Around line 290:

Expected '=item *'

Around line 300:

Expected '=item *'

Around line 314:

Expected '=item *'

Around line 326:

Expected '=item *'

Around line 336:

Expected '=item *'

Around line 346:

Expected '=item *'

Around line 354:

Expected '=item *'

Around line 366:

You forgot a '=back' before '=head1'

Around line 373:

'=end' without a target?