Scroll to navigation

Wiki::Toolkit::Feed::Listing(3pm) User Contributed Perl Documentation Wiki::Toolkit::Feed::Listing(3pm)

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.

2021-01-04 perl v5.32.0