Contents

== has_ratings

+has_ratings+ demonstrates a reference implementation for handling ratings.

== Resources

API

* http://api.pluginaweek.org/has_ratings

Bugs

* http://pluginaweek.lighthouseapp.com/projects/13276-has_ratings

Development

* http://github.com/pluginaweek/has_ratings

Source

* git://github.com/pluginaweek/has_ratings.git

== Description

Storing ratings is a pretty common task when building web applications with a
community-based focus.  Ratings can have names and values associated with them.
This plugin demonstrate a simple way to manage what ratings can be used and
how they are persisted.

== Usage

Note that this is a reference implementation and, most likely, should be
modified for your own usage.

=== Example

  user = User.find(1)
  video = Video.find(1)
  
  video.ratings.create(:rater => user, :value => 'poor')
  video.ratings.average   # => 1.0

== Assets

Included with the plugin are image/stylesheet assets for creating raters using
css as described at http://www.komodomedia.com/blog/2007/01/css-star-rating-redux

== Testing

Before you can run any tests, the following gem must be installed:
* plugin_test_helper[http://github.com/pluginaweek/plugin_test_helper]

To run against a specific version of Rails:

  rake test RAILS_FRAMEWORK_ROOT=/path/to/rails

== Dependencies

* Rails 2.3 or later
* enumerate_by[http://github.com/pluginaweek/enumerate_by] 0.4.0 or later

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
pluginaweek-has_ratings-0.3.0	README.rdoc