EE entry rating module

I finally could force myself to write up at least a rough documentation for an entry rating module I made some time ago. So here it comes.

Features / characteristics are:

independent from comments
can be restricted to logged-in members only
voting results from members and visitors may be shown separately or overall
rating-form is either drop-down with configurable options or radio-inputs from 1 to 5
result output either with images (like the stars here) or numbers or both - can be defined with variables in the template
works on single- and multi-entry pages
{exp:weblog:entries} can be used to list entries sorted by highest ratings.
one vote per member per entry allowed
one vote per IP per entry allowed

You can see it in action over here.

Installation:

Upload the entry_rating-folder into the modules folder of your ExpressionEngine system directory.
Upload the ext.entry_rating_ext.php-file into the extensions folder of your ExpressionEngine system directory.
Upload the lang.entry_rating.php-file into the language/english folder of your ExpressionEngine system directory.
Upload the images empty.gif, half.gif & full.gif to any directory you like. You can also use your own set of images as long as you keep the names.
In your Control Panel goto Modules, locate the Entry Rating module and click Install.
- Now you can click on the Entry Rating module to enter the settings.
- If you want to use the images to represent the voting result, enter the URL of the folder to which you uploaded the images. If the URL is correct the images will appear instead of the ??? once you clicked update settings.
- If you want to use the SELECT-input for voting you can edit the options here.
- You may also change the label of the button used to submit the vote
- and the text that appears if the user already voted on an entry
In your Control Panel goto Admin > Utilities > Extensions Manager, locate the Entry Rating extension and click Enable?.

The tags:

{exp:entry_rating:show_rating entry_id="{entry_id}"}<br />
{/exp:entry_rating:show_rating}

The show_rating tag is used to output the voting results for an entry. Obviously it has to be placed inside a {exp:weblog:entries}{/exp:weblog:entries} tag-pair. This can be done on a single-entry page as well as on a multientry-page.

Parameters:
entry_id="{entry_id}”
This parameter is mandatory.

Inside the show_rating tag-pair you have access to several variables to output your results.

{overall_votings} The total number of votes
{overall_vote} The numerical value of the average voting result, logged-in users and visitors combined
{overall_vote_symbol}Graphical representation of the average voting result, logged-in users and visitors combined

{visitor_votings} The total number of votes made by visitors
{visitor_vote} The numerical value of the average voting result by visitors
{visitor_vote_symbol} Graphical representation of the average voting result by visitors

{member_votings} The total number of votes made by logged-in users
{member_vote} The numerical value of the average voting result by logged-in users
{member_vote_symbol} Graphical representation of the average voting result by logged-in users


{exp:entry_rating:rating_form entry_id="{entry_id}"}

This tag displays the rating form if the current user has not already voted for this entry. If he has already voted his vote is displayed instead of the form. Note: this tag has no closing tag.

Parameters:
entry_id="{entry_id}”
This parameter is mandatory.

members_only="1”
If this parameter is set, the form will only be displayed to logged-in members.

type="radio”
If this parameter is set, the rating-form is displayed with radio-buttons labels 1-5.

otherwise it defaults to a select-list.

{exp:entry_rating:order_by_rating type="overall" limit="5"}
{exp:weblog:entries weblog="testsite" entry_id="{order_by_rating}" sortby="rating" dynamic="off"}
<a href="{path=site/article}">{title}</a>
{exp:entry_rating:show_rating entry_id="{entry_id}"}({overall_vote}){/exp:entry_rating:show_rating}
{/exp:weblog:entries}
{/exp:entry_rating:order_by_rating}</p>