\n- [mr_rating_form title=\"Please rate this\" submit_button_text=\"Submit\"]<\/li>\n
- [mr_rating_result post_id=\"100\" no_rating_results_text=\"No rating result yet\"]<\/li>\n
- [mr_rating_results_list title=\"Top Ratings\" sort_by=\"highest_rated\" limit=\"10\"]<\/li>\n
- [mr_rating_results_list title=\"Ratings\" sort_by=\"most_entries\" limit=\"5\"]<\/li>\n<\/ul>\n\n
Premium Version<\/h4>\n\n
Looking for some more advanced functionality? The Multi Rating Pro<\/a> version provides a significant additional feature set, including:<\/p>\n\n\n- Create multiple rating forms<\/li>\n
- Ratings moderation (approve or unapprove rating entries)<\/li>\n
- WordPress comment ratings<\/li>\n
- E-mail notifications for new rating entries<\/li>\n
- Show text labels for rating item options instead of numbers<\/li>\n
- Bayesian average ratings<\/li>\n
- Add common review fields (title, name, e-mail and comments)<\/li>\n
- Add custom fields to collect additional information<\/li>\n
- Display rating entry details in a review layout<\/li>\n
- Display rating item results in a poll \/ bar chart layout<\/li>\n
- Extra shortcodes, widgets & Gutenerg blocks (i.e. reviews, dashboard of user ratings and detailed rating item results)<\/li>\n
- Logged in users can update or delete their existing ratings<\/li>\n
- Override the rating form to be used on specific posts, URLs, post types, post ids, taxonomies, terms etc\u2026<\/li>\n
- Options to exclude the home page, search page and archive pages (e.g. category)<\/li>\n
- Includes a thumbs up \/ thumbs down rating item type (e.g. like or dislike)<\/li>\n
- Option to only allow ratings from logged in users<\/li>\n
- Google reCAPTCHA validation (add-on)<\/li>\n
- Gravity Forms integration (add-on)<\/li>\n
- And much much more...<\/li>\n<\/ul>\n\n\n
5.0.6 (19\/12\/2022)<\/h4>\n\n\n- Fix: Added nonces to tools to prevent CSRF attack<\/li>\n
- Fix: XSS fixes<\/li>\n<\/ul>\n\n
5.0.5<\/h4>\n\n\n- Minor changes e.g. readme<\/li>\n<\/ul>\n\n
5.0.4 (07\/03\/2021)<\/h4>\n\n\n- Fix: Tweak to JSON encoding for JSON-LD structured data<\/li>\n<\/ul>\n\n
5.0.4 (02\/03\/2021)<\/h4>\n\n\n- New: Added mr_structured_data_item_type filter<\/li>\n
- Fix: Special characters causing invalid JSON-LD markup<\/li>\n
- Fix: Fresh install upgrade error<\/li>\n<\/ul>\n\n
5.0.3 (21\/09\/2020)<\/h4>\n\n\n- Fix: Custom image settings undefined error in admin<\/li>\n<\/ul>\n\n
5.0.2 (14\/08\/2020)<\/h4>\n\n\n- Fix: Console error in Gutenberg editor due to icon_classes missing<\/li>\n
- Fix: Deprecated jQuery function live() was used in admin JS<\/li>\n<\/ul>\n\n
5.0.1 (28\/06\/2020)<\/h4>\n\n\n- Fix: Auto placement post type issue<\/li>\n<\/ul>\n\n
5.0 (27\/06\/2020)<\/h4>\n\n\n- New: Added REST API readonly endpoints for rating results list, rating items and a custom field on posts with rating results<\/li>\n
- Tweak: Upgraded Font Awesome icons to latest v3 & v4 and added v5<\/li>\n
- Tweak: Fixed about page CSS and removed Credits tab.<\/li>\n
- Tweak: Removed custom CSS option. You should move this to the Customizer.<\/li>\n
- Tweak: Some minor CSS style changes. You may need to update your styles.<\/li>\n
- New: Added 3 Gutenberg blocks for the rating form, rating result and rating reslt list.<\/li>\n
- New: Migrated post meta settings to Gutenberg editor.<\/li>\n
- 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.<\/li>\n
- New: Added integration with WooCommerce Product structured data<\/li>\n
- New: Added integration with Wordpress SEO (Yoast) structured data graph<\/li>\n
- Tweak: Removed minified assets.<\/li>\n
- Tweak: Removed widget check for enabled post types.<\/li>\n
- Tweak: Moved enabled post types option to the auto placement settings.<\/li>\n
- Tweak: Changed classic editor post meta box styles.<\/li>\n
- 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.<\/li>\n<\/ul>\n\n
4.3.1<\/h4>\n\n\n- Tweak: Removed WPML references<\/li>\n<\/ul>\n\n
4.3 (14\/04\/2018)<\/h4>\n\n\n- Tweak: Removed IP address duplicate checking for GDPR compliance. Cookies will be the default option used instead.<\/li>\n
- Bug: Fixed PHP error when saving rating items due to typo...<\/li>\n<\/ul>\n\n
4.2.9 (22\/12\/2017)<\/h4>\n\n\n- Tweak: Changed doubleval to floatval to avoid Wordfence and GravityScan false positive security alert for eval( $_POST string<\/li>\n<\/ul>\n\n
4.2.8 (05\/12\/2017)<\/h4>\n\n\n- Bug: Upon plugin activation, do not redirect to about page if network admin<\/li>\n
- Bug: Fixed admin css not loading correctly<\/li>\n
- Tweak: Fixed visible date-picker div element in WP-admin<\/li>\n
- Tweak: Improved UI for Ratings, Entries, Rating Items and Reports screens in WP-admin<\/li>\n
- Tweak: Updated About page<\/li>\n
- Tweak: Added Upgrade to Pro advert in Settings screen in WP-admin<\/li>\n
- Tweak: Updated text in Tools screen in WP-admin<\/li>\n
- Bug: Removed comment form from appearing in the auto placement settings under the rating form position<\/li>\n<\/ul>\n\n
4.2.7 (25\/07\/2017)<\/h4>\n\n\n- 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.<\/li>\n<\/ul>\n\n
4.2.6 (15\/02\/2017)<\/h4>\n\n\n- New: Font Awesome 4.7.0 support<\/li>\n
- New: Added mr_disable_custom_text filter to turn off custom text settings allowing language translation of strings<\/li>\n
- Bug: Fixed incorrect data format used when updating label of a rating item<\/li>\n<\/ul>\n\n
4.2.5 (25\/01\/2017)<\/h4>\n\n\n- Bug: Fixed some potential SQL injection vulnerabilities<\/li>\n
- Bug: Fixed a couple of cross site scripting (XSS) vulnerabilities in the rating form<\/li>\n
- Bug: Fixed incorrect weight validation for decimals when adding a new rating item<\/li>\n
- Bug: Added missing validation of post id when saving a rating entry<\/li>\n
- Bug: Check if editor and administrator roles roles exist before adding mr_edit_rating capability<\/li>\n<\/ul>\n\n
4.2.4 (18\/10\/2016)<\/h4>\n\n\n- New: Added badge icon to about page<\/li>\n
- New: Added post meta field \"mr_rating_result_count_entries\" which is a count of rating entries<\/li>\n
- New: Added post meta field \"mr_rating_result_star_rating\" which has the overall star rating<\/li>\n<\/ul>\n\n
4.2.3 (16\/07\/2016)<\/h4>\n\n\n- Bug: Fixed styles for icon font library not defaulting correctly<\/li>\n
- Bug: Fixed hide rating form on submit and template strip newlines settings not saving correctly<\/li>\n<\/ul>\n\n
4.2.2 (14\/07\/2016)<\/h4>\n\n\n- Bug: Fixed issue unable to add more than one rating item<\/li>\n
- Tweak: Added new error if default option > max option when adding a new rating item<\/li>\n<\/ul>\n\n
4.2.1 (09\/07\/2016)<\/h4>\n\n\n- Bug: Fixed fatal error missing rating-entries.php file<\/li>\n<\/ul>\n\n
4.2 (08\/07\/2016)<\/h4>\n\n\n- New: Added Dashicon support<\/li>\n
- New: Added Font Awesome 4.2.0, 4.5.0 and 4.6.3 support<\/li>\n
- New: Added Pro version menu item<\/li>\n
- New: Added disable styles option<\/li>\n
- New: Changes the font icon options to be generic to allow other font icon libraries to be added<\/li>\n
- Tweak: Removed the hide post meta box option to keep the settings minimal and simple in the free version<\/li>\n
- Tweak: Moved MR post meta box so that it's not at the top<\/li>\n
- Tweak: Changed the rating-form.php template file so that messages are shown just above the buttons<\/li>\n
- Bug: The default WordPress charset collate is now used for db table creation and updates (global $charset_collate variable)<\/li>\n
- Bug: Fixed some schema.org microdata errors<\/li>\n
- Bug: Some JS fixes based on JSLint and also updated some jQuery selectors based on attribute values to be surrounded in quotes<\/li>\n
- Tweak: Updated languages files<\/li>\n<\/ul>\n\n
4.1.13 (09\/06\/2016)<\/h4>\n\n\n- Bug: Fixed pagination with filters on rating entries and rating results tables in wp-admin<\/li>\n<\/ul>\n\n
4.1.12 (06\/06\/2016)<\/h4>\n\n\n- Tweak: Minor readme changes and updated some links<\/li>\n<\/ul>\n\n
4.1.11 (02\/11\/2015)<\/h4>\n\n\n- Bug: jQuery UI calls protocol agnostic i.e http or https<\/li>\n
- Bug: Removed usage of mysql_real_escape_string() in admin tables<\/li>\n<\/ul>\n\n
4.1.10 (15\/10\/2015)<\/h4>\n\n\n- Bug: Fixed attachments not being able to calculate ratings due to post status inherit instead of published<\/li>\n
- Bug: Fixed rating form using mrp_rating_form_include_minus filter<\/li>\n
- Tweak: Changed Rating Results List widget show filter default to false<\/li>\n
- Tweak: Moved creating sample rating item if none exists to plugin activation<\/li>\n<\/ul>\n\n
4.1.9 (10\/09\/2015)<\/h4>\n\n\n- Bug: Fixed settings section in wp-admin for custom error message text<\/li>\n
- Tweak: Fixed plugin about page for WP 4.3<\/li>\n<\/ul>\n\n
4.1.8 (14\/08\/2015)<\/h4>\n\n\n- 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.<\/li>\n<\/ul>\n\n
4.1.7 (08\/07\/2015)<\/h4>\n\n\n- Bug: Fixed schema.org microdata for itemtype Article (the post) in rating-result.php template file missing required itemprops publishedDate, headline and image<\/li>\n<\/ul>\n\n
4.1.6 (02\/08\/2015)<\/h4>\n\n\n- Bug: Fixed dbdelta key spacing as per https:\/\/core.trac.wordpress.org\/ticket\/32314<\/li>\n<\/ul>\n\n
4.1.5 (16\/07\/2015)<\/h4>\n\n\n- Tweak: Set template strip newlines option to on by default<\/li>\n
- New: Create a sample rating item if none exists<\/li>\n<\/ul>\n\n
4.1.4 (15\/07\/2015)<\/h4>\n\n\n- New: Added auto placement of rating results options before_content and after_content<\/li>\n
- New: Added rating form widget<\/li>\n
- New: Added rating results widget<\/li>\n<\/ul>\n\n
4.1.3 (06\/07\/2015)<\/h4>\n\n\n- Tweak: Changed post link in rating results and rating entries tables to the edit post page<\/li>\n
- Bug: Fixed touch event on minus icon with custom star images in rating form not working properly<\/li>\n<\/ul>\n\n
4.1.2 (03\/07\/2015)<\/h4>\n\n\n- Bug: Fixed error creating db tables on activation caused by stray comma in SQL statement<\/li>\n<\/ul>\n\n
4.1.1 (30\/06\/2015)<\/h4>\n\n\n- New: Added JS dialog to confirm clearing rating entries in the Tools<\/li>\n
- 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.<\/li>\n
- Bug: Fixed preserve max option value in rating-result.php template<\/li>\n
- Bug: Added number_format() to rating-result.php template for showing count of entries<\/li>\n
- Bug: Optimized db indexes for better performance<\/li>\n<\/ul>\n\n
4.1<\/h4>\n\n\n- Tweak: Added option for rating form error message color<\/li>\n
- 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<\/li>\n
- Tweak: Now using minified JS and CSS files<\/li>\n
- 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.<\/li>\n<\/ul>\n\n
4.0.2<\/h4>\n\n\n- Tweak: Improved data sanitization<\/li>\n
- Bug: Added template strip newlines option<\/li>\n<\/ul>\n\n
4.0.1<\/h4>\n\n\n- New: Added option to strip newlines from templates prior to display to support plugins such as Visual Composer<\/li>\n<\/ul>\n\n
4.0<\/h4>\n\n\n- New: Fully WPML compatible<\/li>\n
- New: Added filters for entries query: select, from, join, where, order by, group by and limit<\/li>\n
- New: Added support for Font Awesome 4.3.0<\/li>\n
- New: Added sorting by entry count for equal ratings.<\/li>\n
- Bug: Updated jQuery .on(\"hover\") to .on(\"mouseenter mouseleave\") as this was removed in jQuery 1.9<\/li>\n
- New: Added in-built template system<\/li>\n
- 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.<\/li>\n
- New: Added a setting to be able to default hide the Multi Rating meta box.<\/li>\n
- New: Added more sorting options to rating results in the WP-admin.<\/li>\n
- New: Added CSS cursor pointer on hover of star rating icons.<\/li>\n
- New: Added dashicons-star-filled as menu icon<\/li>\n
- New: Applied widget_title filter for widget titles<\/li>\n
- Bug: Fixed security flaw related to name & comment fields. Please update.<\/li>\n
- Bug: Improved escaping of SQL queries and output data sanitization.<\/li>\n
- Bug: Fixed AJAX returning rating result where rating results position for a post is do not show.<\/li>\n
- 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<\/li>\n
- Tweak: Renamed the Top Rating Results widget to Rating Results List widget which is more generic and supports different sorting mechanisms.<\/li>\n
- 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.<\/li>\n
- Tweak: Improved readability of frontend JS<\/li>\n
- Tweak: General CSS improvements<\/li>\n
- Tweak: Removed the view more functionality. This will added again later utilising AJAX instead of a page refresh.<\/li>\n
- Tweak: Renamed the display_top_rating_results() API function to display_rating_results_list() (old API function is deprecated, but will still work).<\/li>\n
- 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)<\/li>\n
- Important: Deleted class-rating-results.php file as it's no longer needed.<\/li>\n
- Important: Deleted template functions from class-rating-form.php.<\/li>\n
- 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<\/li>\n
- Important: Moved common sorting functions from API to utils class.<\/li>\n<\/ul>\n\n
3.2.1<\/h4>\n\n\n- New: Added loading spinner when saving rating form<\/li>\n
- Tweak: Improved styles in plugin settings page<\/li>\n<\/ul>\n\n
3.2<\/h4>\n\n\n- New: Refactored save rating restrictions to allow using cookies and or an IP address within a specified time in hours<\/li>\n
- New: Added edit_ratings capability to allow Editor role to be able to edit ratings<\/li>\n<\/ul>\n\n
3.1.5<\/h4>\n\n\n- Bug: Removed undefined PHP variable notice in plugin settings page<\/li>\n<\/ul>\n\n
3.1.4<\/h4>\n\n\n- Bug: Fixed auto placement issue - undefined content in mr_can_apply_filter<\/li>\n<\/ul>\n\n
3.1.3<\/h4>\n\n\n- New: Added settings to upload your own star rating images to use instead of Font Awesome star icons<\/li>\n
- New: Added after_auto_placement action hook<\/li>\n
- New: Added mr_can_apply_filter and mr_can_do_shortcode filters<\/li>\n
- 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<\/li>\n
- New: Added more options to show feature image and thumbnail size to the Top Rating Results widget<\/li>\n
- New: Added Font Awesome 4.2.0 support<\/li>\n<\/ul>\n\n
3.1.2<\/h4>\n\n\n- Bug: Fixed show_count parameter not set correctly when displaying the top rating results<\/li>\n
- Bug: Fixed filter button text callback defect<\/li>\n<\/ul>\n\n
3.1.1<\/h4>\n\n\n- Bug: Fixed rounding of star result to 2 decimals<\/li>\n
- Bug: Fixed is_admin() checks to also check AJAX requests to support plugins such as FacetWP<\/li>\n
- New: Added filter button custom text and category label text<\/li>\n
- New: Added ability to sort rating results in WP-admin by post title asc, post title desc, top rating results and most entries<\/li>\n
- New: Added to delete all associated rating results and entry data when a post is deleted<\/li>\n
- Bug: Added fix to only show published posts in the Top Rating Results and to recalculate the rating results when a post changes status<\/li>\n<\/ul>\n\n
3.1<\/h4>\n\n\n- New: Added edit rating feature in WP-admin<\/li>\n
- Tweak: Replaced storing username with user id<\/li>\n
- Tweak: Refactored star rating html generation<\/li>\n
- New: Added WP filter for custom rating form validation<\/li>\n
- Tweak: Some CSS changes<\/li>\n
- Tweak: Improved usability of WP-admin tables<\/li>\n<\/ul>\n\n
3.0.2<\/h4>\n\n\n- Bug: Fixed weight issue calculting rating results<\/li>\n<\/ul>\n\n
3.0.1<\/h4>\n\n\n- Tweak: Performance impovements. Added rating results cache.<\/li>\n<\/ul>\n\n
3.0<\/h4>\n\n\n- New: Major plugin refactor.<\/li>\n
- Bug: Several bug fixes<\/li>\n
- New: Added more filters in WP-admin tables<\/li>\n
- New: Added new Tools menu<\/li>\n
- New: Added rating results table in WP-admin<\/li>\n
- New: Hide rating form on submit<\/li>\n
- New: Replaced JS alert after submitting rating form with HTML message<\/li>\n
- New: Added several action hooks<\/li>\n<\/ul>\n\n
2.3.1<\/h4>\n\n\n- Bug: Fixed bug calculating raitng results if a new rating item is added<\/li>\n
- Tweak: Modified how rating results are calculated<\/li>\n
- Tweak: Sorting of rating results by result type<\/li>\n
- Bug: Fixed bug missing before_title after_title in display_top_rating_results shortcode<\/li>\n
- Bug: Fixed bug in JS where trim is not supported in IE8<\/li>\n
- New: Added support for custom taxonomies<\/li>\n<\/ul>\n\n
2.3<\/h4>\n\n\n- New: Support for different versions of Font Awesome added<\/li>\n
- New: Plugin now i18n translation ready<\/li>\n
- New: Added About page<\/li>\n<\/ul>\n\n
2.2.4<\/h4>\n\n\n- New: New report which shows number of entries per day<\/li>\n
- New: Ability to export rating results to a CSV file<\/li>\n<\/ul>\n\n
2.2.3 (07\/07\/2014)<\/h4>\n\n\n- New: Added on hover color for star rating select<\/li>\n<\/ul>\n\n
2.2.2 (29\/05\/2014)<\/h4>\n\n\n- Bug: Fixed missing category_id attribute to display_top_rating_results shortcode<\/li>\n<\/ul>\n\n
2.2.1 (29\/05\/2014)<\/h4>\n\n\n- Bug: Fixed category filter<\/li>\n<\/ul>\n\n
2.2 (28\/05\/2014)<\/h4>\n\n\n- Tweak: Added Fontawesome star icons instead of using image sprites<\/li>\n
- New: Added radio options and star ratings along with the select drop down to select rating item values<\/li>\n
- Tweak: Some template and style changes to improve the layout<\/li>\n
- Bug: Fixed a couple of misc bugs<\/li>\n<\/ul>\n\n
2.1 (07\/05\/2014)<\/h4>\n\n\n- Tweak: Refactored HTML for rating form and rating results including CSS styles<\/li>\n
- 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<\/li>\n
- New: Added class shortcode attribute<\/li>\n
- Tweak: Refactored how rating results are returned in API<\/li>\n<\/ul>\n\n
2.0.4 (12\/04\/2014)<\/h4>\n\n\n- Bug: Fixed rich snippets bug<\/li>\n
- New: Refactored API functions and added more params that can be used in shortcodes<\/li>\n<\/ul>\n\n
2.0.3<\/h4>\n\n\n- New: Information on multi-rating-pro plugin features added<\/li>\n<\/ul>\n\n
2.0.2<\/h4>\n\n\n- New: Rating results table in WP-admin query updated to order by entry_date desc<\/li>\n<\/ul>\n\n
2.0.1<\/h4>\n\n\n- Bug: Fixed top rating results widget bug<\/li>\n<\/ul>\n\n
2.0<\/h4>\n\n\n- New: Major refactor of plugin.<\/li>\n
- Important: Old Shortcodes deprecated and replaced with new shortcodes. Old settings and API functions renamed and may not backward compatible.<\/li>\n
- New: Old settings have been renamed<\/li>\n
- 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.<\/li>\n
- New: Improved WP admin including view rating result entries and values<\/li>\n<\/ul>\n\n
1.1.8 (15\/01\/2014)<\/h4>\n\n\n- New: Allow removing title from rating form and top rating results<\/li>\n<\/ul>\n\n
1.1.7 (13\/01\/2014)<\/h4>\n\n\n- New: Added settings for default rating form title and default top rating results title<\/li>\n<\/ul>\n\n
1.1.6 (7\/01\/2014)<\/h4>\n\n\n- Bug: Fixed bug in displaying top results for multiple post types<\/li>\n<\/ul>\n\n
1.1.5 (6\/01\/2014)<\/h4>\n\n\n- Bug: Fixed custom title for widgets<\/li>\n<\/ul>\n\n
1.1.4 (19\/12\/2013)<\/h4>\n\n\n- New: Added support for character encoding of rating items in db<\/li>\n<\/ul>\n\n
1.1.3 (14\/12\/2013)<\/h4>\n\n\n- Bug: Fixed post title on top rating results widget<\/li>\n<\/ul>\n\n
1.1.2 (14\/12\/2013)<\/h4>\n\n\n- Bug: Removed debugging comment accidentally left behind<\/li>\n<\/ul>\n\n
1.1.1 (12\/12\/2013)<\/h4>\n\n\n- New: Changed shortcode parameter for post id from id to post_id<\/li>\n
- Tweak: Fixed default values in API functions for themes<\/li>\n
- Bug: Fixed bug which caused only 5 top rating results being displayed<\/li>\n<\/ul>\n\n
1.1<\/h4>\n\n