Why not adopt me?
NAME
Rubric::Entry - a single entry made by a user
VERSION
$Id: Entry.pm,v 1.12 2004/12/02 04:07:43 rjbs Exp $DESCRIPTION
This class provides an interface to Rubric entries. It inherits from Rubric::DBI, which is a Class::DBI class.
COLUMNS
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 modifiedRELATIONSHIPS
link
The link attribute returns a Rubric::Link.
user
The user attribute returns a Rubric::User.
tags
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.
recent_tags_counted
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.
INFLATIONS
created
modified
The created and modified columns are stored as seconds since epoch, but inflated to Time::Piece objects.
METHODS
by_tag(\%arg)
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.)
user - the user whose tags to search (can be undef)
tags - an arrayref of tag names
body - whether entries must have bodies (T, F, or undef)
link - whether entries must have a link (T, F, or undef)This returns a list or Class::DBI::Iterator, depending on context.
set_new_tags(\@tags)
This method replaces all entry's current tags with the new set of tags.
tags_from_string($taglist)
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.
TODO
AUTHOR
Ricardo SIGNES, <rjbs@cpan.org>
BUGS
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.
COPYRIGHT
Copyright 2004 Ricardo SIGNES. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.