Description
The Rating module allows your users to rate and review channel entries. Along with the obvious, Rating also allows you to display ranked lists of entries, show detailed stats for entries, allow your users to edit their reviews, vote reviews up/down, manual and automated moderation, and more! You can also accept both member and Guest ratings.
Rating also contains it’s own set of custom fields, notification templates, and member group/channel privileges. Having your own custom rating fields allows you the flexibility of having as many rating and review fields as you need.
The Stats function is extensive, and allows you to output full stats on each entry as well as individual numeric rating fields. Numeric ratings can be counted, totaled and averaged.
Additionally, you can also use Bayesian (weighted) method of ranking your entries. It makes some calculations on your site and weights the entries a little differently. For example, an entry with an average rating of 4.6/5 from 30 rating submissions would likely be ranked higher than that of an entry with average rating of 5/5 from 3
rating submissions.
Works on: ExpressionEngine 2.x Shortcut:
Compare
Link to this page:
Changelog
- Version 3.2.2
- Version 3.2.1
- Version 3.2.0
- Version 3.1.1
- Version 3.1.0
- Version 3.0.3
- Version 3.0.2
- Version 3.0.1
- Version 3.0.0
- Version 2.3.4
- Version 2.3.3
- Version 2.3.2
- Version 2.3.1
- Version 2.3.0
Version 3.2.2 (May 10, 2013)
- Added paginate_base="" parameter to Rating:Rank tag.
- Added in variables for signature/avatar/photo heights and widths for Rating Comments.
- Added a {rating_comment_group_id} variable to the Rating:Comments tag to display the comment author's member group ID.
- Updated for compatibility with ExpressionEngine 2.6.
- Fixed a bug where omitting collection="" would not pull Rating entries in Rating:Entries tag.
- Fixed a bug where PHP errors would occur in the control panel on PHP 5.2.x.
- Fixed a bug where the Rating theme folder links were not fully compatible with moveable third party themes folder.
Version 3.2.1 (March 11, 2013)
- Added internal Demo Templates tab in control panel (replaces older "code pack" approach).
- Updates are now automatic and no longer require a manual update screen.
Version 3.2.0 (January 25, 2013)
- Removed support for ExpressionEngine 1.x (Rating is now EE2 only).
- Added offline documentation files to download package.
- Added ability to order Rating:Entries by "votes" (highest rated votes).
- Added Rating:Comment_Form tag for simple commenting on rating reviews.
- Added Rating:Comments tag for display of simple comments on rating reviews.
- Added {rating_comments} variable to Rating:Rating_Vote_Stats tag to parse the total amount of comments for a Rating review.
- Added ability to create custom statuses for Rating submissions.
- Added "sticky" capability to the Rating:Rank tag.
- Added "rating_comments_alter_status" and "rating_entries_alter_status" extension hooks.
- Added allow_unrated="" parameter to Rating:Form to allow the submission of ratings without a rating value and without assigning a value of zero (0) to the rating field.
- Added unrated_only="" parameter to Rating:Entries which allows you to list only rating entries that contain no value (unrated) for the specified numeric rating field(s).
- Added unrated_fields="" parameter to Rating:Entries which allows you to specify numeric rating fields that contain no value (unrated).
- Added exclude_unrated="" parameter to Rating:Entries to exclude rating entries that contain no value (unrated) for the specified numeric rating field(s).
- Fixed a bug where MySQL errors could occur in front end templates in EE 2.5.4+.
- Fixed a bug where orderby_ratings="" in Channel:Entries wasn't ordering non-rated entries correctly.
- Fixed a bug where rating_id="" was not working in the Rating:Entries tag.
- Fixed a bug where limit's greater than 100 were being ignored.
- Fixed various issues with upgrades and new installs concerning MySQL strict mode support.
Version 3.1.1 (May 4, 2012)
- Added support for ordering rating entries by 'random' for Rating:Entries tag.
- Added support for disable="" parameter to the Rating:Rank tag.
- Added support for search:custom_field="" parameter to the Rating:Rank tag.
- Added AJAX output support to the Rating:Form tag submission routine. Use ajax_request='yes' and output_json='yes' to use.
- Added 'Collection' column to "Ratings" tab in Rating control panel.
- Fixed a bug where Rating:Rank would show unrated entries on top when display_unrated="yes" was used WITHOUT the orderby="" parameter.
- Fixed a bug where submitting a field with a rating of '0' and no other field values would result in an incorrect error.
- Fixed a bug where an entry url_title with 'limit' in it would throw a MySQL error when using pagination in the Rating:Rank tag.
- Fixed a bug where not having a collection set would possibly show incorrect stats.
- Fixed a bug where member stats were not being saved correctly.
Version 3.1.0 (February 1, 2012)
- Added rating_location variable to the Rating:Entries tag.
- Added display_unrated="yes" parameter to the Rating:Rank tag to allow displaying of unrated entries as well.
- Modified Rating to allow Rating fields of the number type to have a value of 0.
- Modified Rating so that in previous versions, values of 0 are now treated as truly empty values.
- Modified Rating so that statistics for ratings will not assume values of 0 are to be used in calculations.
- Modified the Rated Entries page in the CP to have the channel_id added to the edit entry URL.
- Modified Rating to be MySQL Strict compatible.
- Updated pagination to support ExpressionEngine 2.4.
- Fixed a bug where the Bayesian ordering in the Rating:Rank tag would incorrectly sort ratings without a collection name.
- Fixed a bug where Rating:Rank would not show entries that had a status besides 'open'.
- Fixed a bug where Rating could be undefined in when passed as a conditional.
- Fixed a bug where the Date Range pulldowns and calendars in the Rating CP were not functioning correctly in newer versions of EE2.
- Fixed a bug where Rating:Rank would not support the show_expired="" parameter.
Version 3.0.3 (September 14, 2011)
- Added "absolute_results" variable to display the total results across all pages.
- Fixed a bug where admin_template="" was not being recognized in the Rating Form tag.
- Fixed a bug where {title} variable was not being correctly parsed in the Admin Notification.
- Fixed a bug where the Field Length variable was being ignored when editing Ratings in the CP.
- Fixed a bug where the "total_results" variable was displaying absolute count, instead of result count on current page.
Version 3.0.2 (July 5, 2011)
- Added img_width="" and img_height="" parameters to Entries and Stats tags for custom resizing of {X_overall_avg} variable's images.
- Fixed a bug where the Rating:Rank tag was ignoring the dynamic="" parameter.
- Fixed a bug where the template="" parameter was not working correctly for the Rating:Form tag.
- Fixed a bug where the Rating:Entries tag would not show any results if there was only Rating entries with NO numeric ratings.
- Fixed a bug where 'rating_edit_date' and 'gmt_rating_edit_date' were not working correctly in the Rating:Entries tag.
Version 3.0.1 (May 30, 2011)
- Added bayesian_average_score="" parameter to Rating:Rank tag. Allows one to reset the average rating used for the Bayesian Scoring.
Version 3.0.0 (April 29, 2011)
- Converted Rating to use Solspace Add-on Builder Framework, and Solspace Bridge for EE 1.x.
- Added support for editing rating submissions on the front end through the Rating:Form tag.
- Added {unsubscribe_link} as an option for user_template="" Rating templates in Rating:Form tag.
- Added three new form security parameters to the Form tag for setting the allowed, min, or max values for Rating fields: field:FIELD_NAME_HERE:values, field:FIELD_NAME_HERE:min, field:FIELD_NAME_HERE:max.
- Added {rating_paginate}{/rating_paginate} variable pair to Rating:Entries and Rating:Rank tags.
- Added {if rating_no_results} conditional to Stats, Entries, Rank, and Rating Vote Stats tags.
- Added {if can_edit} and {if can_delete} conditionals to Rating:Entries tag.
- Added rating_author_username="" parameter to Rating:Entries tag.
- Added support for NSM addon updater.
- Added Bayesian (weighted) ranking method to Rating:Rank tag.
- Added {previous_vote} variable to Rating_Vote_Stats tag. Will parse as 'up, 'down' or an empty string if no previous vote was made by the user.
- Added the form:attribute="" parameter type to the Rating:Form tag.
- Overhauled code to be much more efficient.
- Overhauled Rating:Rank tag to be much faster and much more efficient.
- Overhauled Rating control panel to be more powerful (moderation tools, mass edit, etc) and easier use.
- Renamed "form_name" parameter and references to "collection".
- Renamed Rankings tag to Rank.
- Renamed Quarantine tag to Report.
- Renamed Quarantine_Allowed tag to Reporting_Allowed.
- Renamed Insert_Rating_Rev tag to Insert_Rating_Vote.
- Renamed Rating_Rev_Stats tag to Rating_Vote_Stats.
- Deprecated the Rating:Count tag.
- Deprecated the require_membership="no" parameter. Guest posting permissions are now available in Rating CP.
- Modified Insert_Rating_Vote tag to allow the usage of 'up' and 'down' instead of 'yes' and 'no' respectively, as a segment.
- Modified Rating_Vote_Stats variables and conditionals to make more sense: 'n' => 'down_votes', 'y' => 'up_votes', 'percent_n' => 'down_percent', 'percent_y' => 'up_percent', 'total' => 'total_votes', 'if already_reviewed' => 'if already_voted', 'if not_already_reviewed' => 'if not_already_voted'.
- Modified the rating_author_id= parameter for Rating:Entries tag to now accept 'CURRENT_USER', 'NOT_CURRENT_USER', '0' and '0'.
- Modified Exporting of Ratings to now be CSV. Can be overridden by switching 'csv_separator' class variable in mcp.rating.base.php to "\t"
- Removed Notify Authors channel preference in favor of notify_authors="" parameter in Rating:Form tag.
- Removed Notification Emails channel preference in favor of notify="" parameter in Rating:Form tag.
- Removed the Parse_Rating_Stats feature. Users should now just use Rating:Stats tag to achieve same results.
- Fixed a bug where Rating Entries was not correctly parsing not_already_reviewed and already_reviewed.
- Fixed a bug where a user would get a notification of the rating they just submitted if they checked the "notify me" option.
NOTE: Users must FIRST be using Rating 2.3.4 BEFORE upgrading to Rating 3.x. If you're using an earlier version of Rating, please ensure you upgrade to Rating 2.3.4 first.
Version 2.3.4 (March 21, 2011)
- Modified the default field length to 100 from 1.
- Fixed a bug where performing an upgrade from Rating 2.3.2 to 2.3.3 could result in a MySQL error.
- Fixed a bug where ratings could not be deleted by non-Super Admins with proper privileges.
- Fixed a bug with pagination in the Rating CP area.
- Fixed all instances of $_SERVER to $IN->AGENT in module code.
Version 2.3.3 (March 17, 2010)
- Added checks to the upgrade routine to clean up any issues with the review/rating fields.
- Modified code to make Rating compatible with PHP 5.3.
- Modified queries to improve speed of the Rating Entries method.
- Rewrote the update_stats() method to correct Stats issues.
- Modified the restrictions against logged-in users submitting ratings. It no longer checks against IP addresses of logged in members.
- Fixed a bug where the {overall_count} variable was being calculated incorrectly.
- Fixed a bug where exp_rating_stats was getting the correct overall_count info, but exp_weblog_titles was not. Depending on where {overall_count} was used, the output could be incorrect.
- Fixed a bug where Rating and Review columns didn't show on the data export.
- Fixed a bug where an error message might show when using the first_rating feature.
- Fixed a bug where individual form averages were calculated incorrectly when there was more than one numeric field.
- Fixed a bug where any logged in member could delete a rating using the Rating:Delete function. Added permission settings in the Rating module CP.
- Fixed the pagination query in Rating:Entries.
- Fixed a bug where errors would sometimes occur when trying to install Rating.
Version 2.3.2 (October 7, 2009)
NOTE: Be sure to follow the special updating instructions.
- Modified the Orderby_Rating feature in Weblog:Entries to allow for orderby_rating="yes" and orderby="title" to give the same effect as orderby="rating|title".
- Modified the "locked" status of the "rating"/"review" fields in the Rating module CP to permit editing of formatting and character limits.
- Combined all 3 Rating extensions to make a single, unified extension.
- Fixed a bug where closed ratings would improperly affect the update_stats routine the Stats output.
Version 2.3.1 (September 18, 2009)
- Fixed a bug in update_stats() where PHP's max() would output an error if it was handed an empty array.
- Fixed a bug where the Rating Export utility was not pulling data from the database.
- Fixed bugs in the Maintenance() routine that caused stats to be incorrect if more than one form is used.
- Fixed a bug where the precision="" parameter was being applied to variables that shouldn't.
- Fixed a bug where emails were not being sent to addresses supplied in the notify="" parameter in Rating:Form.
Version 2.3.0 (August 24, 2009)
- Added duplicate_check_guest_ip=“no” parameter for Rating:Form, Insert_Rating_Rev, and Rating_Review_Stats functions.
- Added “rating_id” variable to notification templates.
- Added check on upgrade, to ensure the “rating” and “review” fields exist.
- Improved already_reviewed, not_already_reviewed, and prior_review_count behavior for logged-out users.
- Modified Rating to now protect the “rating” and “review” fields as permanent default fields.
- Modified Cookie/IP check on new rating submits.
- Modified the default row limit in Ratings table to 50.
- Modified Guest ratings to now show guests’s name (or GUEST) and e-mail address in Rating module CP.
- Modified the “stars/bar/circles” variable pairs to be allowed to be used more than once per template.
- Removed moderation-related code and “Moderate Ratings?“ preference in Rating module CP as the function no longer exists.
- Fixed a bug where the Rating:Stats function would intermittantly display.
- Fixed several bugs where the code contained “( )“ instead of “[ ]“.
- Fixed several bugs where some areas of Rating were not PHP4 compatible.
- Fixed pagination in Rating module CP so that sorting preferences are preserved from page to page.
- Fixed a bug where Rating:Rankings did not correctly return the contents of the no_results conditional.
- Fixed bug where “overall_count/sum/avg” variables did not factor in ANY numerical rating fields except the default ‘rating’ field.
- Fixed a bug where the “timeframe_” variables in Rating:Rankings were not calculating properly.
- Fixed a bug where the Maintenance method would not calculate count, sum, and avg columns correctly in exp_rating_stats.
Installation
ExpressionEngine 2.x Installation Instructions
1. Copy Add-on Files
Rating includes the Code Pack module software to install the Rating Code Pack sample templates and data (optional). It is included with your download in a separate folder.
- Within the /EE2/system/expressionengine/third_party/ directory, copy all folders into your sites’ ./system/expressionengine/third_party/ directory.
- Within the /EE2/themes/third_party/ directory, copy all folders into your sites’ ./themes/third_party/ directory.
2. Installing the Add-On
- Go to the Modules area in the ExpressionEngine Control Panel, find Rating in the list, and click Install.
3. Loading the Rating Code Pack sample data (optional)
To make use of the Rating Code Pack sample templates, you’ll need to make sure the Code Pack module and Rating Code Pack extension is installed:
- Go to the Extensions area in the ExpressionEngine Control Panel, find Rating Code Pack in the list, and click Enable.
- Go to the Modules area in the ExpressionEngine Control Panel, find Code Pack in the list and make sure it is installed. If not, click Install. Then, click the link for Code Pack.
- In the list of available Code Packs, click Rating Code Pack.
- Create a prefix name for the sample data such as test_ or rating_.
- Select the Default code pack and click the Submit button. The Code Pack module will output sample templates and other data, all prefixed with the value you specified.
4. Setup & Configuring
- Before you start using Rating, you’ll need to set and adjust some member group and channel preferences.
- To adjust any settings in Rating, click on the Preferences tab in the Control Panel area and then modify as necessary.
5. Troubleshooting and Support
For Support and Troubleshooting, visit the Solspace Support Forums.
ExpressionEngine 1.x Installation Instructions
1. Copy Add-on Files
This add-on requires that you use the Solspace Bridge software with ExpressionEngine 1.x. It will be included with your download in a separate folder. Additionally, Rating includes the Code Pack module software to install the Rating Code Pack sample templates and data (optional). It will be included with your download in a separate folder.
- Within the /EE1/system/ directory, copy the bridge folder into your sites’ ./system/ directory.
- Within the /EE1/system/modules/ directory, copy all folders into your sites’ ./system/modules/ directory.
- Within the /EE1/system/extensions/ directory, copy all folders and files into your sites’ ./system/extensions/ directory.
- Within the /EE1/system/language/english/ directory, copy the lang.rating_code_pack.php file into your sites’ ./system/language/english/ directory.
- Within the /EE1/themes/ directory, copy all folders into your sites’ ./themes/ directory.
2. Installing the Add-On
- Go to the Modules tab in the ExpressionEngine Control Panel, find Rating in the list, and click Install.
- Go to the Extensions Manager area in the ExpressionEngine Control Panel, and make sure the jQuery for the CP extension exists and is enabled.
3. Loading the Rating Code Pack sample data (optional)
To make use of the Rating Code Pack sample templates, you’ll need to make sure the Code Pack module and Rating Code Pack extension is installed:
- Go to the Extensions area in the ExpressionEngine Control Panel, find Rating Code Pack in the list, and click Enable.
- Go to the Modules tab in the ExpressionEngine Control Panel, find Code Pack in the list and make sure it is installed. If not, click Install. Then, click the link for Code Pack.
- In the list of available Code Packs, click Rating Code Pack.
- Create a prefix name for the sample data such as test_ or rating_.
- Select the Default code pack and click the Submit button. The Code Pack module will output sample templates and other data, all prefixed with the value you specified.
4. Setup & Configuring
- Before you start using Rating, you’ll need to set and adjust some member group and weblog preferences.
- To adjust any settings in Rating, click on the Preferences tab in the Control Panel area and then modify as necessary.
5. Troubleshooting and Support
For Support and Troubleshooting, visit the Solspace Support Forums.
Updates
- Upgrading from Rating 3.x to latest Rating 3.x on EE 2.x
- Upgrading from Rating 3.x to latest Rating 3.x on EE 1.x
- Upgrading from Rating 2.x to Rating 3.x
- Upgrading from Rating 2.x to latest Rating 2.x
After downloading the latest version of the add-on, unzip the download file and follow these instructions...
ExpressionEngine 2.x Updating Instructions
1. Copy Add-on Files
Rating includes the Code Pack module software to install the Rating Code Pack sample templates and data (optional).
- Within the /EE2/system/expressionengine/third_party/ directory, copy all folders into your sites' ./system/expressionengine/third_party/ directory.
- Within the /EE2/themes/third_party/ directory, copy all folders into your sites' ./themes/third_party/ directory.
2. Updating the Add-On
- Go to the Modules area in the ExpressionEngine Control Panel and click the link for Rating
- Click the Update link now displayed in the module's control panel.
- If an update has been made to the Code Pack module, repeat the same steps as above, but with the Code Pack module.
If you're installing the Rating Code Pack for the first time, click here for setup instructions.
3. Troubleshooting and Support
For Support and Troubleshooting, visit the Solspace Support Forums.
ExpressionEngine 1.x Updating Instructions
1. Upgrading from Rating 2.x to Rating 3.x (if applicable)
If you're upgrading from Rating 2.x to Rating 3.x, please follow the special instructions below:
NOTE: please be sure to make sure you're using Rating 2.3.4 before upgrading to Rating 3.x, as prior versions do NOT contain an upgrade path. If you're using Rating 2.3.3 and earlier, please upgrade to Rating 2.3.4 first. See Rating 2.x to latest Rating 2.x upgrade instructions here.
- Take your site Offline. We recommend that you take your site offline for the duration of the update so that people visiting your site won't see any PHP errors, etc.
- Delete the extension file named ext.rating_extension.php in your ./system/extensions/ directory.
- Delete the language file named lang.rating.php in your ./system/language/english/ directory.
- Delete the folder named rating in your ./system/modules/ directory.
- Delete the folder named rating_themes in your ./themes/ directory (be sure to back up any custom themes you may have).
2. Copy Add-on Files
This add-on requires that you use the Solspace Bridge software with ExpressionEngine 1.x. It is included with your download in a separate folder. Additionally, Rating includes the Code Pack module software to install the Rating Code Pack sample templates and data (optional).
- Within the /EE1/system/ directory, copy the bridge folder into your sites' ./system/ directory.
- Within the /EE1/system/modules/ directory, copy all folders into your sites' ./system/modules/ directory.
- Within the /EE1/system/extensions/ directory, copy all folders and files into your sites' ./system/extensions/ directory.
- Within the /EE1/system/language/english/ directory, copy the lang.rating_code_pack.php file into your sites' ./system/language/english/ directory.
- Within the /EE1/themes/ directory, copy all folders into your sites ./themes/ directory.
3. Updating the Add-On
- Go to the Modules tab in the ExpressionEngine Control Panel and click the link for Rating
- Click the Update link now displayed in the module's control panel.
- If an update has been made to the Code Pack module, repeat the same steps as above, but with the Code Pack module.
If you're installing the Rating Code Pack for the first time, click here for setup instructions.
4. Troubleshooting and Support
For Support and Troubleshooting, visit the Solspace Support Forums.
$59.95Add to Cart
Software Support
We pride ourselves on our level of support and our attention to the customer. If you have an issue, we're here to help.
30-day Money Back Guarantee
If your software purchase does not meet your expectations, or is not right for you, just let us know and we'll give you a full refund within 30 days of purchase.
Affiliate Program
Add a Solspace Affiliate link to your site and make 5% on referred purchases. Read more »
