Club Drupal

 * jQuery rollover effects and AJAX no-reload voting

 * Graceful degradation to an HTML rating form when JavaScript is turned off

 * Per-nodetype configurability

 * Support for anonymous voters

 * Spam protection to keep users from filling your DB with bogus votes

 * Easy-to-use integration with Views module for lists sorted by rating, or filtered by min/max ratings

 * A Fivestar CCK field for use in custom node types

Fivestar was designed by Nate Haug and Jeff Eaton.

This Module Made by Robots: http://www.lullabot.com

Dependencies

 * votingapi

Fivestar also provides additional features for both the CCK and Views modules.

Install

-------

Installing the Fivestar voting module is simple:

1) Copy the fivestar folder to the modules folder in your installation.

2) Enable the module using Administer -> Modules (/admin/build/modules)

Note: Aggressive caching will complain that fivestar doesn't work, but it

actually causes no problems. To improve performance, the module implements

hook_init() -- and the caching advisor screen uses that as the only metric to

determine whether a module will work with the caching system. Activate it

without fear, friends -- Fivestar will continue to hum happily along.

Upgrading from Drupal 5

-----------------------

The Drupal 6 version of VotingAPI has been significantly improved for both

efficiency and flexibility. Because Fivestar depends on VotingAPI for much of

its functionality, these changes have affected Fivestar.

The Fivestar Anonymous vote interval set in admin/settings/fivestar is no

longer available. We use the same setting as defined in VotingAPI now, set at

admin/settings/votingapi. It has the same effect as the previous Fivestar

setting.

Configuration for Simple Rating

-------------------------------

Fivestar has two completely separate modes of operation. The first is letting an

end-user rate a piece of content. The settings for this are on the content type

settings page. These settings let you expose a rating widget when viewing the

node, not editing it. Clicking on the widget registers a vote for that node, and

never anything else.

1) Configure the site-wide setting for Fivestar, Administer -> Settings ->

   Fivestar.

   appear on story nodes, use Administer -> Content Management ->

   Content Types -> Story, and check the "Enable Fivestar rating" box under

   that. Use Administer -> User Management -> Access Control, and check the

   "rate content" and "view ratings" checkboxes for the roles you'd like.

   You'll find these permission items under the "fivestar module" heading.

1) If it's not already enabled, turn on comment module at Administer ->

   Site Building -> Modules.

   Content Management -> Content Types -> Story, and select an option under

1) Create a new node type called 'review' at Administer -> Content Management ->

realy simple case, you could just enter the value 10 to always rate on the same

1. Open your favorite image editor and create an image that is 3 times as high as it is wide.

   The default size for Fivestar (and the easiest to work with) is 16x48 pixels.

3. Create a star icon in the top third. When satisfied, copy it into the middle and bottom

   thirds of the image. Change the middle and bottom copies to your liking. Fivestar will

   use the top, middle, and bottom images for each state of the star.

4. Save your image as "star.png" in a new directory. The name of your directory will be the label

   for your set of stars, spaces are not allowed.

5. Do the same thing for a cancel image, only there are only 2 states for a cancel image, so your

   image will be 16 pixels by 32pixels. Setup a guide at 16 pixels so your canvas is split in half.

6. Create a cancel icon in the top half. Then duplicate it into the bottom half. The cancel states

   are simply Off and Hover.

8. Create the CSS stylesheet. The easiest way to make this stylesheet is to copy an existing CSS

   file from another set of stars. The "Basic" set provides an excellent example for a 16x16 star,

   because it only changes the background image as necessary. If you're making a larger or smaller

   size for your stars than 16x16 pixels, the "Minimal" and "Outline" sets make for a good example.

Post them to the Fivestar issue queue: http://drupal.org/project/issues/fivestar

http://drupal.org/project/issues/fivestar. DO NOT POST IN THE FORUMS. Posting in

the issue queues is a direct line of communication with the module authors.