Rubric::Entry - a single entry made by a user
$Id: Entry.pm,v 1.18 2005/01/11 02:15:29 rjbs Exp $
This class provides an interface to Rubric entries. It inherits from Rubric::DBI, which is a Class::DBI class.
id - a unique identifier link - the link to which the entry refers user - the user who made the entry title - the title of the link's destination description - a short description of the entry body - a long body of text for the entry created - the time when the entry was first created modified - the time when the entry was last modified
The link attribute returns a Rubric::Link.
The user attribute returns a Rubric::User.
Every entry has_many tags that describe it. The tags method will return the tags, and the entrytags method will return the Rubric::EntryTag objects that represent them.
tags
entrytags
This method returns a reference to an array of arrayrefs, each a (tag, count) pair for tags used on the week's 50 most recent entries.
The created and modified columns are stored as seconds since epoch, but inflated to Time::Piece objects.
The arguments to by_tag indicate the tags and users for which to search. (The built-in Class::DBI search method can't handle this kind of search.)
by_tag
user - the user whose tags to search (can be undef) tags - an arrayref of tag names link - the id of the entry's link has_body - whether entries must have bodies (T, F, or undef) has_link - whether entries must have a link (T, F, or undef)
This returns a list or Class::DBI::Iterator, depending on context.
This method replaces all entry's current tags with the new set of tags.
This (class) method takes a string of tags, delimited by whitespace, and returns a reference to an array of the tags, dropping invalid tags.
Valid tags (shouldn't this be documented somewhere else instead?) may contain letters, numbers, underscores, colons, dots, and asterisks.
Ricardo SIGNES, <rjbs@cpan.org>
<rjbs@cpan.org>
Please report any bugs or feature requests to bug-rubric@rt.cpan.org, or through the web interface at http://rt.cpan.org. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
bug-rubric@rt.cpan.org
Copyright 2004 Ricardo SIGNES. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Rubric, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Rubric
CPAN shell
perl -MCPAN -e shell install Rubric
For more information on module installation, please visit the detailed CPAN module installation guide.