Babble::Document::Collection - Babble document collector class
Babble::Document::Collection is a meta-class. One, that's sole purpose is to collect Babble::Document objects, and group them together with a little meta-info about them.
The author of this collection
The subject of the collection.
The title of the collection.
A unique ID for the collection, usually a hyperlink to the source homepage.
A link to the source of this collection (for example, to an RSS feed).
The creation date of this version of the collection.
A brief description of the collection
The name of the collection. Usually used for subscription lists in the templates. This does not come from the feed, as the others. It must be specified at object creation time. Defaults to author's value if undefined, or title's, if author is undefined too.
The image associated with the collection. It is stored as a HASH reference, containing the following keys:
The URL to the image. (Mandatory)
Title of the image (to be used in ALT attributes or the like)
An image link - where the image points to. (Mandatory)
Width of the image.
Height of the image.
Creates a new, empty Babble::Document::Collection object. All the properties mentioned above are recognised as paramaters.
To add documents to the collection, simply push them to @{$collection->{documents}}.
@{$collection->{documents}}
Given a list of filters (see Babble::Document::search for a specification of filters) in an arrayref, returns all the documents that match the specified criteria. If no matches are found, returns an empty array.
Return all entries (the lowest level entries) as an array.
Sort all the elements in an aggregation by date, and return the sorted array of items.
Gergely Nagy, algernon@bonehunter.rulez.org
Bugs should be reported at http://bugs.bonehunter.rulez.org/babble.
Babble, Babble::Document
To install Babble, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Babble
CPAN shell
perl -MCPAN -e shell install Babble
For more information on module installation, please visit the detailed CPAN module installation guide.