ExpressionEngine Add-ons

Rating 4.0.4

Accept ratings and reviews from your site visitors and members.

  Overview

The Rating add-on 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 logged in member and logged out 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 weighs 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.

  Compatibility

The latest version of Rating is 4.0.4. The chart below shows the current technical requirements and compatibility for the latest version of Rating.

  Compatibility Chart

Rating currently only supports the latest version of ExpressionEngine plus 1 point version back. The red, vertical dashed line represents the cut-off for EE versions we support. EE versions to the right of that line are no longer supported by us with our add-ons. The icon represents an update specifically for compatibility with that EE version. Please upgrade to this add-on version before upgrading to that version of ExpressionEngine.

Date formats below are: M/D/YYYY. As always, we recommend that you always use the latest versions of our add-ons. However, this chart may answer some of your questions about upgrading the Solspace Rating add-on and ExpressionEngine, and reduce the risk of incompatibility. This chart also serves as a guide to see when support for the latest version of ExpressionEngine becomes available.

EE 3.4.x EE 3.3.x EE 3.2.x EE 3.1.x EE 3.0.x EE 2.11.x EE 2.10.x EE 2.9.x EE 2.8.x EE 2.7.x EE 2.6.x EE 2.5.x
4.0.4+ 6/22/2016
4.0.2+ 4/19/2016
4.0.0 12/16/2015 4.0.0 12/16/2015 4.0.0 12/16/2015
3.3.1+ 2/20/2015
3.3.1 2/20/2015 3.2.4 4/18/2014 3.2.4 4/18/2014 3.2.3 10/8/2013 3.2.2 5/10/2013 3.2.0 1/25/2013

  What People Are Saying

  Documentation     Changelog

Changelog

4.0.4 (June 22, 2016) #

  • Updated for compatibility with ExpressionEngine 3.4.
  • Fixed a bug where the short name auto-generating JS was automatically overwriting existing short names when editing fields, templates, etc.

4.0.3 (April 29, 2016) #

  • Added support for PHP7.

4.0.2 (April 19, 2016) #

  • Updated Rating for compatibility with ExpressionEngine 3.3's new icon set in the control panel.
  • Fixed a bug where Rating would display some errors with PHP 5.3.
  • Fixed a bug where IPv6 IP addresses would not be recognized correctly by duplicate detection for guests.
  • Fixed a bug where deleting channel entries that have ratings would not remove Rating data, and would then display errors in the Rating add-on control panel.

4.0.1 (February 3, 2016) #

  • Fixed a bug where Rating would not install on Windows based machines.
  • Fixed a bug where the {previous_vote} variable in Rating:Rating_Vote_Stats tag was not calculating correctly.

4.0.0 (December 16, 2015) #

  • Updated Rating to be compatible with ExpressionEngine 3+ (only). Rating 3.x is required for ExpressionEngine 2.x.
  • Overhauled Rating Stars feature to be much more customizable. You can now specify an alternate directory for where your Rating star images are located, adjust output size and set file type extension. Also included new set of default modern star images.
  • Added rating_status="" parameter to Rating:Rank template tag.
  • Added status="" parameter to Rating:Stats template tag.
  • Added site_id="" parameter to Rating:Comment_Form template tag.
  • Added secure_action="" and secure_return="" parameters to Rating:Form and Rating:Comment_Form template tags.
  • Added 'if rating_no_results' and 'if rating_comment_no_results' conditionals to Rating:Form and Rating:Comment_Form tags, respectively.
  • Modified Rating:Form template tag to update and calculate average rating stats for all statuses except "closed", as a performance option. Previously, it used to exclude "Pending" and "Declined" statuses as well - these are no longer reserved statuses.
  • Updated language throughout Rating control panel area to be clearer.
  • Updated and enhanced moderation controls in Rating control panel.
  • Removed 'if first_rating' conditional/feature from Rating:Form and Rating:Entries template tags. This can be accomplished with use of 'if duplicate' / 'if not_duplicate' conditionals in Rating:Form. The {first_rating} variable continues to exist in Rating:Entries, and will parse as the numeric rating submitted for the first rating the user submitted for the given entry (if multiple ratings are submitted).
  • Removed timeframe range searching on Rating:Rank template tag.
  • Removed Ratings export feature in Rating control panel.
  • Fixed a bug where users could submit a rating without 'params_id' and submit the rating with no collection and status of "open".

3.3.1 (February 20, 2015) #

  • Added new modern-style stars images theme.
  • Updated and refreshed demo templates. Example templates include AJAX as well.
  • Fixed a bug where {if can_edit} and {if can_delete} conditionals in Rating:entries tag were not working correctly.

3.3.0 (September 15, 2014) #

  • Added front and back-end editing and deletion of Rating Comments.
  • Added advanced pagination to Rating:Entries tag.
  • Added notify_author="yes" parameter to Rating:Form tag.
  • Updated demo templates to show Rating Comments functionality.
  • Fixed a bug where the Rated Entries and Ratings sections in the control panel would not preserve or respect search filters when using pagination.
  • Fixed a bug where email notifications weren't sent to the channel entry author when owner_template="" was used in Rating:Form. This parameter is used in conjunction with notify_author="yes".
  • Fixed a bug where using a non-numerical field in the unrated_fields="" parameter in Rating:Entries caused a MySQL error instead of failing silently.
  • Fixed potential error when sending notifications when the rating field isn't used.
  • Fixed a bug where the contents of CAPTCHA conditionals would display despite Rating and EE CAPTCHA settings not requiring CAPTCHA in EE 2.9+.

3.2.4 (April 18, 2014) #

  • Updated for compatibility with ExpressionEngine 2.8.

3.2.3 (October 8, 2013) #

  • Updated for compatibility with ExpressionEngine 2.7+.
  • Modified Rating:Entries when used with ordering by votes, to order by votes scores, and then order by most recent rating.
  • Restored usage of ExpressionEngine native output->show_user_error forms while on the front end.
  • Fixed a bug in the Edit Rating control panel form where selected fields would not re-toggle.
  • Fixed a bug where users could not submit another rating for an entry (with duplicate checks on), despite having the users original rating deleted in the Control Panel.

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.

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.

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.

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.

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.

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.

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.

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.

3.0.0 (April 29, 2011) #

NOTE: Users must FIRST be using Rating 2.3.4 BEFORE upgrading to Rating 3.x. If you're using an earlier ### of Rating, please ensure you upgrade to Rating 2.3.4 first.

  • 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.

  Pro Services

Need help with an implementation of Rating? Need Rating to do more? We're available for hire!

If you're interested in any of the above services, or have questions about them, fill out the form below to begin our conversation!

  EE Aftercare

Ongoing repairs, additions, and adjustments are a normal part of the life cycle of a web site. With EE Aftercare, you have someone on your team who you can trust to take care of your web site. Solspace brings years of experience in developing, refurbishing, and supporting EE web sites. With EE Aftercare, you have a high-end developer on your team, working with you to have the best and most effective possible web presence.

Learn more about EE Aftercare