=== Multi Rating ===
Contributors: dpowney
Tags: rating, review, post rating, star rating, 5 star
Requires at least: 4.0
Tested up to: 6.1
Stable tag: 5.0.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A powerful post rating / review system plugin for WordPress. Easily add 5 star ratings to your posts.

== Description ==

A powerful post rating / review system plugin for WordPress with a niche of doing multi ratings better than anyone else. Easily add 5 star ratings to your posts.

Check out [the demo](https://multiratingpro.com/demo-page-free?utm_source=view-demo&utm_medium=free-plugin&utm_campaign=readme).

= Features =

* Rate posts based on different criteria with **star ratings**, select and radio buttons
* Compatible with both the Classic editor and new **Gutenberg** editor
* Adds **Google review snippets** to improve SEO (JSON-LD)
* Integrates JSON-LD structured data with WordPress SEO (Yoast) and WooCommerce plugins
* Use **Font Awesome** icons or upload custom images intead
* Several **Gutenberg blocks**, shortcodes and widgets available
* Can apply different **weights** to rating items to adjust results
* Can **automatically add** the rating form and rating result to post content
* **i18n translation ready** for multilingual sites
* In-built **template system** to customize the HTML presentation
* Access ratings through the WordPress **REST API**
* Can export rating entries to CSV
* Can edit rating details from WP-admin
* Style options for stars icon colors

= Shortcodes =

* [mr_rating_form] - displays the rating form.
* [mr_rating_result] - displays the overall rating result.
* [mr_rating_results_list] - displays a list of post ratings.

Shortcode examples:

* [mr_rating_form title="Please rate this" submit_button_text="Submit"]
* [mr_rating_result post_id="100" no_rating_results_text="No rating result yet"]
* [mr_rating_results_list title="Top Ratings" sort_by="highest_rated" limit="10"]
* [mr_rating_results_list title="Ratings" sort_by="most_entries" limit="5"]

= Premium Version =

Looking for some more advanced functionality? The [Multi Rating Pro](https://multiratingpro.com?utm_source=pro-version&utm_medium=free-plugin&utm_campaign=readme&utm_content=top) version provides a significant additional feature set, including:

* Create multiple rating forms
* Ratings moderation (approve or unapprove rating entries)
* WordPress comment ratings
* E-mail notifications for new rating entries
* Show text labels for rating item options instead of numbers
* Bayesian average ratings
* Add common review fields (title, name, e-mail and comments)
* Add custom fields to collect additional information
* Display rating entry details in a review layout
* Display rating item results in a poll / bar chart layout
* Extra shortcodes, widgets & Gutenerg blocks (i.e. reviews, dashboard of user ratings and detailed rating item results)
* Logged in users can update or delete their existing ratings
* Override the rating form to be used on specific posts, URLs, post types, post ids, taxonomies, terms etc…
* Options to exclude the home page, search page and archive pages (e.g. category)
* Includes a thumbs up / thumbs down rating item type (e.g. like or dislike)
* Option to only allow ratings from logged in users
* Google reCAPTCHA validation (add-on)
* Gravity Forms integration (add-on)
* And much much more...

== Screenshots ==

1. Rating form and rating results
2. Gutenberg blocks 1
3. Gutenberg blocks 2
4. General settings
5. Auto placement settings
6. Style settings
7. Post ratings in WP-admin
8. Rating entries in WP-admin
9. Rating items in WP-admin
10. Widget options for list of rating results

== Upgrade Notice ==

== Changelog ==

= 5.0.6 (19/12/2022) =
* Fix: Added nonces to tools to prevent CSRF attack
* Fix: XSS fixes

= 5.0.5 =
* Minor changes e.g. readme

= 5.0.4 (07/03/2021) =
* Fix: Tweak to JSON encoding for JSON-LD structured data

= 5.0.4 (02/03/2021) =
* New: Added mr_structured_data_item_type filter
* Fix: Special characters causing invalid JSON-LD markup
* Fix: Fresh install upgrade error

= 5.0.3 (21/09/2020) =
* Fix: Custom image settings undefined error in admin

= 5.0.2 (14/08/2020) =
* Fix: Console error in Gutenberg editor due to icon_classes missing
* Fix: Deprecated jQuery function live() was used in admin JS

= 5.0.1 (28/06/2020) =
* Fix: Auto placement post type issue

= 5.0 (27/06/2020) =
* New: Added REST API readonly endpoints for rating results list, rating items and a custom field on posts with rating results
* Tweak: Upgraded Font Awesome icons to latest v3 & v4 and added v5
* Tweak: Fixed about page CSS and removed Credits tab.
* Tweak: Removed custom CSS option. You should move this to the Customizer.
* Tweak: Some minor CSS style changes. You may need to update your styles.
* New: Added 3 Gutenberg blocks for the rating form, rating result and rating reslt list.
* New: Migrated post meta settings to Gutenberg editor.
* New: Added JSON-LD AggregateRatings structured data support for supported schema.org item types. Removed old microdata format which was previously added in the templates.
* New: Added integration with WooCommerce Product structured data
* New: Added integration with Wordpress SEO (Yoast) structured data graph
* Tweak: Removed minified assets.
* Tweak: Removed widget check for enabled post types.
* Tweak: Moved enabled post types option to the auto placement settings.
* Tweak: Changed classic editor post meta box styles.
* Tweak: Removed post type check from the mr_can_apply_filter filter. This allows auto placement even when the post type is not enabled using post meta fields.

= 4.3.1 =
* Tweak: Removed WPML references

= 4.3 (14/04/2018) =
* Tweak: Removed IP address duplicate checking for GDPR compliance. Cookies will be the default option used instead.
* Bug: Fixed PHP error when saving rating items due to typo...

= 4.2.9 (22/12/2017) =
* Tweak: Changed doubleval to floatval to avoid Wordfence and GravityScan false positive security alert for eval( $_POST string

= 4.2.8 (05/12/2017) =
* Bug: Upon plugin activation, do not redirect to about page if network admin
* Bug: Fixed admin css not loading correctly
* Tweak: Fixed visible date-picker div element in WP-admin
* Tweak: Improved UI for Ratings, Entries, Rating Items and Reports screens in WP-admin
* Tweak: Updated About page
* Tweak: Added Upgrade to Pro advert in Settings screen in WP-admin
* Tweak: Updated text in Tools screen in WP-admin
* Bug: Removed comment form from appearing in the auto placement settings under the rating form position

= 4.2.7 (25/07/2017) =
* Tweak: Turned off auto placement in RSS feeds by checking the is_feed() function. Note a simple way to flush an RSS feed cache is to update a post.

= 4.2.6 (15/02/2017) =
* New: Font Awesome 4.7.0 support
* New: Added mr_disable_custom_text filter to turn off custom text settings allowing language translation of strings
* Bug: Fixed incorrect data format used when updating label of a rating item

= 4.2.5 (25/01/2017) =
* Bug: Fixed some potential SQL injection vulnerabilities
* Bug: Fixed a couple of cross site scripting (XSS) vulnerabilities in the rating form
* Bug: Fixed incorrect weight validation for decimals when adding a new rating item
* Bug: Added missing validation of post id when saving a rating entry
* Bug: Check if editor and administrator roles roles exist before adding mr_edit_rating capability

= 4.2.4 (18/10/2016) =
* New: Added badge icon to about page
* New: Added post meta field "mr_rating_result_count_entries" which is a count of rating entries
* New: Added post meta field "mr_rating_result_star_rating" which has the overall star rating

= 4.2.3 (16/07/2016) =
* Bug: Fixed styles for icon font library not defaulting correctly
* Bug: Fixed hide rating form on submit and template strip newlines settings not saving correctly

= 4.2.2 (14/07/2016) =
* Bug: Fixed issue unable to add more than one rating item
* Tweak: Added new error if default option > max option when adding a new rating item

= 4.2.1 (09/07/2016) =
* Bug: Fixed fatal error missing rating-entries.php file

= 4.2 (08/07/2016) =
* New: Added Dashicon support
* New: Added Font Awesome 4.2.0, 4.5.0 and 4.6.3 support
* New: Added Pro version menu item
* New: Added disable styles option
* New: Changes the font icon options to be generic to allow other font icon libraries to be added
* Tweak: Removed the hide post meta box option to keep the settings minimal and simple in the free version
* Tweak: Moved MR post meta box so that it's not at the top
* Tweak: Changed the rating-form.php template file so that messages are shown just above the buttons
* Bug: The default WordPress charset collate is now used for db table creation and updates (global $charset_collate variable)
* Bug: Fixed some schema.org microdata errors
* Bug: Some JS fixes based on JSLint and also updated some jQuery selectors based on attribute values to be surrounded in quotes
* Tweak: Updated languages files

= 4.1.13 (09/06/2016) =
* Bug: Fixed pagination with filters on rating entries and rating results tables in wp-admin

= 4.1.12 (06/06/2016) =
* Tweak: Minor readme changes and updated some links

= 4.1.11 (02/11/2015) =
* Bug: jQuery UI calls protocol agnostic i.e http or https
* Bug: Removed usage of mysql_real_escape_string() in admin tables

= 4.1.10 (15/10/2015) =
* Bug: Fixed attachments not being able to calculate ratings due to post status inherit instead of published
* Bug: Fixed rating form using mrp_rating_form_include_minus filter
* Tweak: Changed Rating Results List widget show filter default to false
* Tweak: Moved creating sample rating item if none exists to plugin activation

= 4.1.9 (10/09/2015) =
* Bug: Fixed settings section in wp-admin for custom error message text
* Tweak: Fixed plugin about page for WP 4.3

= 4.1.8 (14/08/2015) =
* Tweak: Made it easier to add your own schema.org microdata and override the default "https://schema.org/Article" micordata using new filter mr_rating_result_microdata. The old filters mrp_rating_result_microdata_thing and mrp_rating_result_microdata_thing_properties are no longer supported.

= 4.1.7 (08/07/2015) =
* Bug: Fixed schema.org microdata for itemtype Article (the post) in rating-result.php template file missing required itemprops publishedDate, headline and image

= 4.1.6 (02/08/2015) =
* Bug: Fixed dbdelta key spacing as per https://core.trac.wordpress.org/ticket/32314

= 4.1.5 (16/07/2015) =
* Tweak: Set template strip newlines option to on by default
* New: Create a sample rating item if none exists

= 4.1.4 (15/07/2015) =
* New: Added auto placement of rating results options before_content and after_content
* New: Added rating form widget
* New: Added rating results widget

= 4.1.3 (06/07/2015) =
* Tweak: Changed post link in rating results and rating entries tables to the edit post page
* Bug: Fixed touch event on minus icon with custom star images in rating form not working properly

= 4.1.2 (03/07/2015) =
* Bug: Fixed error creating db tables on activation caused by stray comma in SQL statement

= 4.1.1 (30/06/2015) =
* New: Added JS dialog to confirm clearing rating entries in the Tools
* Bug: Fixed several WPML issues (i.e. unable to submit ratings) where the original post in the default language was not always returned calling icl_object_id.
* Bug: Fixed preserve max option value in rating-result.php template
* Bug: Added number_format() to rating-result.php template for showing count of entries
* Bug: Optimized db indexes for better performance

= 4.1 =
* Tweak: Added option for rating form error message color
* New: Added required option for rating items. If enabled and 0 is selected as the rating item value, a field is required error message is displayed
* Tweak: Now using minified JS and CSS files
* Tweak: Improved usability of star ratings by not setting a default value. Star ratings are now more interactive as the on hover state works straight away.

= 4.0.2 =
* Tweak: Improved data sanitization
* Bug: Added template strip newlines option

= 4.0.1 =
* New: Added option to strip newlines from templates prior to display to support plugins such as Visual Composer

= 4.0 =
* New: Fully WPML compatible
* New: Added filters for entries query: select, from, join, where, order by, group by and limit
* New: Added support for Font Awesome 4.3.0
* New: Added sorting by entry count for equal ratings.
* Bug: Updated jQuery .on("hover") to .on("mouseenter mouseleave") as this was removed in jQuery 1.9
* New: Added in-built template system
* New: Added more options to the Rating Results List widget (formally Top Rating Results widget) including taxonomy, terms, result type, show filter, filter label, show rank, header and sort by.
* New: Added a setting to be able to default hide the Multi Rating meta box.
* New: Added more sorting options to rating results in the WP-admin.
* New: Added CSS cursor pointer on hover of star rating icons.
* New: Added dashicons-star-filled as menu icon
* New: Applied widget_title filter for widget titles
* Bug: Fixed security flaw related to name & comment fields. Please update.
* Bug: Improved escaping of SQL queries and output data sanitization.
* Bug: Fixed AJAX returning rating result where rating results position for a post is do not show.
* Tweak: Renamed all shortcodes to have a prefix mr_ (old shortcode names are deprecated but will still work). display_rating_form => mr_rating_form, display_rating_results => mr_rating_results and display_top_rating_results => mr_rating_results_list
* Tweak: Renamed the Top Rating Results widget to Rating Results List widget which is more generic and supports different sorting mechanisms.
* Tweak: Refactored all shortcodes, widgets and the correspnding API functions to use new template system. Renamed some shortcode attributes names, widget options names and API function parameters to improve consistency.
* Tweak: Improved readability of frontend JS
* Tweak: General CSS improvements
* Tweak: Removed the view more functionality. This will added again later utilising AJAX instead of a page refresh.
* Tweak: Renamed the display_top_rating_results() API function to display_rating_results_list() (old API function is deprecated, but will still work).
* Tweak: Renamed the following API parameters and shortcode attributes: show_category_filter => show_filter (deprecated show_category_filter) and category_label_text => filter_label_text (deprecated category_label_text)
* Important: Deleted class-rating-results.php file as it's no longer needed.
* Important: Deleted template functions from class-rating-form.php.
* Important: Deleted actions that no longer make sense due to the new template system. If you've used these actions to modify the template, it will no longer work: mr_display_top_rating_results, mr_display_rating_results and mr_display_rating_form
* Important: Moved common sorting functions from API to utils class.

= 3.2.1 =
* New: Added loading spinner when saving rating form
* Tweak: Improved styles in plugin settings page

= 3.2 =
* New: Refactored save rating restrictions to allow using cookies and or an IP address within a specified time in hours
* New: Added edit_ratings capability to allow Editor role to be able to edit ratings

= 3.1.5 =
* Bug: Removed undefined PHP variable notice in plugin settings page

= 3.1.4 =
* Bug: Fixed auto placement issue - undefined content in mr_can_apply_filter

= 3.1.3 =
* New: Added settings to upload your own star rating images to use instead of Font Awesome star icons
* New: Added after_auto_placement action hook
* New: Added mr_can_apply_filter and mr_can_do_shortcode filters
* New: Modified the Top Rating Results widget, [display_top_rating_results] shortcode and the display_top_rating_results() API function to be able to display the featured image of a post
* New: Added more options to show feature image and thumbnail size to the Top Rating Results widget
* New: Added Font Awesome 4.2.0 support

= 3.1.2 =
* Bug: Fixed show_count parameter not set correctly when displaying the top rating results
* Bug: Fixed filter button text callback defect

= 3.1.1 =
* Bug: Fixed rounding of star result to 2 decimals
* Bug: Fixed is_admin() checks to also check AJAX requests to support plugins such as FacetWP
* New: Added filter button custom text and category label text
* New: Added ability to sort rating results in WP-admin by post title asc, post title desc, top rating results and most entries
* New: Added to delete all associated rating results and entry data when a post is deleted
* Bug: Added fix to only show published posts in the Top Rating Results and to recalculate the rating results when a post changes status

= 3.1 =
* New: Added edit rating feature in WP-admin
* Tweak: Replaced storing username with user id
* Tweak: Refactored star rating html generation
* New: Added WP filter for custom rating form validation
* Tweak: Some CSS changes
* Tweak: Improved usability of WP-admin tables

= 3.0.2 =
* Bug: Fixed weight issue calculting rating results

= 3.0.1 =
* Tweak: Performance impovements. Added rating results cache.

= 3.0 =
* New: Major plugin refactor.
* Bug: Several bug fixes
* New: Added more filters in WP-admin tables
* New: Added new Tools menu
* New: Added rating results table in WP-admin
* New: Hide rating form on submit
* New: Replaced JS alert after submitting rating form with HTML message
* New: Added several action hooks

= 2.3.1 =
* Bug: Fixed bug calculating raitng results if a new rating item is added
* Tweak: Modified how rating results are calculated
* Tweak: Sorting of rating results by result type
* Bug: Fixed bug missing before_title after_title in display_top_rating_results shortcode
* Bug: Fixed bug in JS where trim is not supported in IE8
* New: Added support for custom taxonomies

= 2.3 =
* New: Support for different versions of Font Awesome added
* New: Plugin now i18n translation ready
* New: Added About page

= 2.2.4 =
* New: New report which shows number of entries per day
* New: Ability to export rating results to a CSV file

= 2.2.3 (07/07/2014) =
* New: Added on hover color for star rating select

= 2.2.2 (29/05/2014) =
* Bug: Fixed missing category_id attribute to display_top_rating_results shortcode

= 2.2.1 (29/05/2014) =
* Bug: Fixed category filter

= 2.2 (28/05/2014) =
* Tweak: Added Fontawesome star icons instead of using image sprites
* New: Added radio options and star ratings along with the select drop down to select rating item values
* Tweak: Some template and style changes to improve the layout
* Bug: Fixed a couple of misc bugs

= 2.1 (07/05/2014) =
* Tweak: Refactored HTML for rating form and rating results including CSS styles
* New: Added Multi Rating meta box in edit page to override default settings for automatic placements of rating form and rating results per post or page
* New: Added class shortcode attribute
* Tweak: Refactored how rating results are returned in API

= 2.0.4 (12/04/2014) =
* Bug: Fixed rich snippets bug
* New: Refactored API functions and added more params that can be used in shortcodes

= 2.0.3 =
* New: Information on multi-rating-pro plugin features added

= 2.0.2 =
* New: Rating results table in WP-admin query updated to order by entry_date desc

= 2.0.1 =
* Bug: Fixed top rating results widget bug

= 2.0 =
* New: Major refactor of plugin.
* Important: Old Shortcodes deprecated and replaced with new shortcodes. Old settings and API functions renamed and may not backward compatible.
* New: Old settings have been renamed
* Important: Old rating result will not be migrated. If you wish to keep your rating results, you must continue to use the version 1.1.8.
* New: Improved WP admin including view rating result entries and values

= 1.1.8 (15/01/2014) =
* New: Allow removing title from rating form and top rating results

= 1.1.7 (13/01/2014) =
* New: Added settings for default rating form title and default top rating results title

= 1.1.6 (7/01/2014) =
* Bug: Fixed bug in displaying top results for multiple post types

= 1.1.5 (6/01/2014) =
* Bug: Fixed custom title for widgets

= 1.1.4 (19/12/2013) =
* New: Added support for character encoding of rating items in db

= 1.1.3 (14/12/2013) =
* Bug: Fixed post title on top rating results widget

= 1.1.2 (14/12/2013) =
* Bug: Removed debugging comment accidentally left behind

= 1.1.1 (12/12/2013) =
* New: Changed shortcode parameter for post id from id to post_id
* Tweak: Fixed default values in API functions for themes
* Bug: Fixed bug which caused only 5 top rating results being displayed

= 1.1 =
* New: Added weight rating for multi criteria

= 1.0.3=
* Bug: Fixed activation for older versions of PHP

= 1.0.2 =
* New: Added option to change rating results stars to small, medium or large size
* Bug: Fixed some CSS issues

= 1.0.1 =
* New: Added check is_singular() to add rich snippets to rating results

= 1.0 =
* Initial release