NAME

Wiki::Toolkit::Feed::Listing - parent class for Feeds from Wiki::Toolkit.

DESCRIPTION

Handles common data fetching tasks, so that child classes need only worry about formatting the feeds.

Also enforces some common methods that must be implemented.

METHODS

fetch_recently_changed_nodes

Based on the supplied criteria, fetch a list of the recently changed nodes

fetch_newest_for_recently_changed

Based on the supplied criteria (but not using all of those used by fetch_recently_changed_nodes), find the newest node from the recently changed nodes set. Normally used for dating the whole of a Feed.

fetch_node_all_versions

For a given node (name or ID), return all the versions there have been, including all metadata required for it to go into a "recent changes" style listing.

recent_changes

Build an Atom Feed of the recent changes to the Wiki::Toolkit instance, using any supplied parameters to narrow the results.

If the argument "also_return_timestamp" is supplied, it will return an array of the feed, and the feed timestamp. Otherwise it just returns the feed.

node_all_versions

Build an Atom Feed of all the different versions of a given node.

If the argument "also_return_timestamp" is supplied, it will return an array of the feed, and the feed timestamp. Otherwise it just returns the feed.

format_geo

Using the geo and space xml namespaces, format the supplied node metadata into geo: and space: tags, suitable for inclusion in a feed with those namespaces imported.

The following are methods that any feed renderer must provide:

feed_timestamp

All implementing feed renderers must implement a method to produce a feed specific timestamp, based on the supplied node

generate_node_list_feed

All implementing feed renderers must implement a method to produce a feed from the supplied list of nodes

generate_node_name_distance_feed

All implementing feed renderers must implement a method to produce a stripped down feed from the supplied list of node names, and optionally locations and distance from a reference point.

parse_feed_timestamp

Take a feed_timestamp and return a Time::Piece object.

MAINTAINER

The Wiki::Toolkit team, http://www.wiki-toolkit.org/.

COPYRIGHT AND LICENSE

Copyright 2006-2009 the Wiki::Toolkit team.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.