=== Multi Rating === Contributors: dpowney Donate link: http://www.danielpowney.com/donate Tags: rating, multi-rating, post rating, star, multi, criteria, rich snippet, testimonial, review, hReview, multi rating, feedback, user rating, wpml, feedback, question, star rating, 5 star, font awesome Requires at least: 3.8 Tested up to: 4.1.1 Stable tag: trunk License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html The best rating system plugin for WordPress. Multi Rating allows visitors to rate a post based on multiple criteria and questions. == Description == The best rating system plugin for WordPress. Multi Rating allows visitors to rate a post based on multiple criteria and questions. = Features = * 5 star ratings, percentage and score results * Multiple rating criteria and questions using star ratings, select drop-down lists and radio buttons to choose answers from * Font Awesome used for star rating icons or upload your own star rating images to use instead * Shortcodes to display the rating form and rating results * Shortcode and widget to display a list of rating results (sort by highest rated, lowest rated, most entries, post title ascending or post title descending) * Ability to add schema.org microdata to show the aggregate ratings in search engine results as rich snippets * View the rating results, entries and selected values in the WP-admin * Enable for custom post types and pages * Add custom weights to each rating item to adjust the overall rating results * Automatic placement settings to display the rating form and rating results on every post in different positions * Meta-box on the edit post page to override the default automatic placement settings * Settings to restrict post types, turn on validation, modify text, apply different styles and clear the database etc... * Graphical reports on the number of entries per day * Export rating results to a CSV file * Custom taxonomy support * Developer API functions and template tags to use in your theme * Edit ratings in WP-admin (Editor & Administrator user roles only) * In-built template system for customization * All data stoted in your own WordPress database - no signup required! * Fully WPML compatible Here's a live demo: http://danielpowney.com/multi-rating/ The plugin is i18n translation ready. Different versions of Font Awesome are supported as well to help prevent any theme or plugin conflicts. = Shortcode Examples = * [mr_rating_form] * [mr_rating_form title="Please rate this" submit_button_text="Submit"] * [mr_rating_result] * [mr_rating_result post_id="100" no_rating_results_text="No rating result yet" show_rich_snippets="false"] * [mr_rating_results_list] * [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"] Github: http://github.com/danielpowney/multi-rating = Multi Rating Pro = The following key features are available in the Pro version: * Multiple rating forms with different rating items * WordPress comments system integration * Add custom fields to collect additional information * Ratings moderation (approve or unapprove rating entries) * Logged in users can update or delete their existing ratings * New shortcodes, API functions and widgets (i.e. reviews and rating item results) * A user ratings dashboard shortcode * Rating forms can optionally include a name, e-mail and comment fields * Ability to use text descriptions for select and radio options instead of numbers * Post, category and specific page filters to include (whitelist) or exclude (blacklist) automatic placement of the rating form and rating results * Options to exclude the home page and archive pages (i.e. Category, Tag, Author or a Date based pages) * Thumbs up/thumbs down rating item type (e.g. like/dislike) * Display a breakdown of rating item results in 3 layouts * Allow/disallow anonymous user ratings option Check it out here http://danielpowney.com/downloads/multi-rating-pro/ == Installation == 1. Install plugin via the WordPress.org plugin directory. Unzip and place plugin folder in /wp-content/plugins/ directory for manual installation 1. Activate the plugin through the 'Plugins' menu in WP-admin 1. Go to Settings page in the 'Multi Rating' menu in WP-admin. The auto placement settings should be turned on with only the 'post' post type enabled by default. == Frequently Asked Questions == Full documentation available here http://danielpowney.com/multi-rating/ == Screenshots == 1. Auto placement of rating results after post title and rating form after post content. Twenty Fifteen theme. 2. Rating Results List shortcode. [mr_rating_results_list show_filter="true" title="Top Ratings" sort_by="highest_rated"] 3. Rating results in WP-admin for each post. 4. Every rating entry can be viewed in WP-admin and edited 5. Rating Results List widget options include displaying the post feature image, a rank, changing the result type (star rating out of 5, score or percentage), different sorting mechanisms (highest rated, lowest rated etc...), set widget title and much more. 6. Rating items table. 7. General settings. 8. Style settings include star rating select and on hover colors, load Font Awesome library CDN, version of Font Awesome and the ability to set custom star rating images to use instead of Font Awesome icons. 9. Custom text setting. 10. Graphical report on the number of entries per day. 11. The plugin has several tools including exporting rating results to a CSV file, clearing the rating results cache and deleting rating results in bulk. 12. WP-admin plugin menu. 13. Edit post page. Add shortcodes in the editor. The Multi Rating meta-box can set the auto placement settings per post to override the default settings. 14. Rating Results List Widget. Twenty Fifteen theme. == Upgrade Notice == == Changelog == = 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