NAME

Rubric::Entry - a single entry made by a user

VERSION

 $Id: Entry.pm,v 1.9 2004/11/19 20:37:12 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
 created     - the time when the entry was first created
 modified    - the time when the entry was last modified

RELATIONSHIPS

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

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.

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.