---
name: "Wiki::Toolkit::Feed::Listing"
section: "3pm"
platform: "linux"
package: "libwiki-toolkit-perl"
version: "0.86-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Wiki::Toolkit::Feed::Listing"
---

# Wiki::Toolkit::Feed::Listing(3pm)

parent class for Feeds from Wiki::Toolkit.

## 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.