Rating 3.x

Legacy documentation for Rating 3.x.

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

Version 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+.

Version 3.2.4 (April 18, 2014)

  • Updated for compatibility with ExpressionEngine 2.8.

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

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.