1 # $Id: Entry.pm,v 1.1.1.1 2004/05/29 17:29:56 btrott Exp $
3 package XML::Feed::Entry;
9 bless { entry => $item }, $class;
27 XML::Feed::Entry - Entry/item in a syndication feed
31 ## $feed is an XML::Feed object.
32 for my $entry ($feed->entries) {
33 print $entry->title, "\n", $entry->summary, "\n\n";
38 I<XML::Feed::Entry> represents an entry/item in an I<XML::Feed> syndication
45 The title of the entry.
49 The permalink of the entry, in most cases, except in cases where it points
50 instead of an offsite URI referenced in the entry.
52 =head2 $entry->content
54 The full entry body, or as much as is available in the feed.
56 In RSS feeds, this method will look first for
57 I<http://purl.org/rss/1.0/modules/content/#encoded> and
58 I<http://www.w3.org/1999/xhtml#body> elements, then fall back to a
59 I<E<lt>descriptionE<gt>> element.
61 =head2 $entry->summary
63 A short summary of the entry. Possibly.
65 Since RSS feeds do not have the idea of a summary separate from the entry
66 body, this may return the same value as the I<$entry-E<gt>content> method.
67 But it won't always, even with RSS feeds. For example, a number of RSS feeds
68 use an element like I<http://purl.org/rss/1.0/modules/content/#encoded>
69 for the entry body and put an excerpt in the I<E<lt>descriptionE<gt>> element;
70 in those cases, this method will return the excerpt.
72 =head2 $entry->category
74 The category in which the entry was posted.
78 The name or email address of the person who posted the entry.
82 The unique ID of the entry.
86 A I<DateTime> object representing the date and time at which the entry
89 =head2 $entry->modified
91 A I<DateTime> object representing the last-modified date of the entry.
93 =head1 AUTHOR & COPYRIGHT
95 Please see the I<XML::Feed> manpage for author, copyright, and license