=== Multi Rating === Contributors: dpowney Donate link: http://www.danielpowney.com/donate Tags: rating, multi-rating, post rating, star, multi, criteria, rich snippet, testimonial, review Requires at least: 3.0.1 Tested up to: 3.9.1 Stable tag: trunk License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Multi Rating is a simple rating plugin which allows visitors to rate a post based on multiple criteria and questions. == Description == Multi Rating is a simple rating plugin which allows visitors to rate a post based on multiple criteria and questions. It is responsive, easy to use and integrates seamlessly into any WordPress theme. = Features = * 5 star ratings, percentage and score results * Multuple 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 * Shortcodes to display the rating form, rating results and top rating results * schema.org structured markup is be added to every page that allow search engines to display the aggregated rating results as rich snippets. * View the rating results and selected values in the WP-admin * Widget to display the top rating results * 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... * Reports on number of entries per day * Export rating results to CSV file * Custom taxonomy support * API functions for using Multi Rating in your theme Here's a live demo: http://danielpowney.com/multi-rating/ The plugin is i18n translation ready (.pot file in the languages directory). Different versions of Font Awesome are supported as well to help prevent any theme or plugin conflicts. = Shortcode Examples = * [display_rating_form] * [display_rating_form post_id="100" title="My rating form" submit_button_text="Submit"] * [display_rating_result] * [display_rating_result post_id="100" no_rating_results_text="No rating result yet" show_rich_snippets="false" show_count="true" show_title="false"] * [display_top_rating_results] * [display_top_rating_results title="Top Rating Results" limit="10"] = API Functions = The API functions are located in the multi-rating-api.php file which contains a static class called Multi_Rating_API. The key API functions are: * display_top_rating_results * display_rating_result * display_rating_form = Multi Rating Pro = The following key features are available in the Pro version: * Multiple rating forms with different rating items * WordPress comments system integration * Logged in users can update or delete their existing ratings * New shortcodes, API functions and widgets (e.g. display user reviews and individual rating item results) * 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 * View rating results per post and rating form in WP-admin backend * 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/down rating item type * Display rating item results breakdown in a poll format Other features available in the Pro version include: * Allow/disallow anonymous user ratings option * Option to display the rating result back to the user when they submit a rating form * More filters on WP-admin rating results tables To learn more go to 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 WordPress admin 1. Go to 'Settings' menu 'Multi Rating' option in WordPress admin == Frequently Asked Questions == Full documentation available at: http://danielpowney.com/multi-rating/ == Screenshots == 1. Demo of rating results after page title, rating form and top rating results 2. View rating results in WP-admin 3. Edit post page in WP-admin showing Multi Rating meta box and shortcode sample in visual editor 4. Rating items table 5. Add a new rating item 6. Top Rating Results widget 7. Rating result details including values 8. Settings page == Upgrade Notice == == Changelog == = 2.3.1 = * Fixed bug calculating raitng results if a new rating item is added * Modified how rating results are calculated * Sorting of rating results by result type * Fixed bug missing before_title after_title in display_top_rating_results shortcode * Fixed bug in JS where trim is not supported in IE8 * Added support for custom taxonomies = 2.3 = * Support for different versions of Font Awesome added * Plugin now i18n translation ready * Added About page = 2.2.4 = * New report which shows number of entries per day * Ability to export rating results to a CSV file = 2.2.3 (07/07/2014) = * Added on hover color for star rating select = 2.2.2 (29/05/2014) = * Fixed missing category_id attribute to display_top_rating_results shortcode = 2.2.1 (29/05/2014) = * Fixed category filter = 2.2 (28/05/2014) = * Added Fontawesome star icons instead of using image sprites * Added radio options and star ratings along with the select drop down to select rating item values * Some template and style changes to improve the layout * Fixed a couple of misc bugs = 2.1 (07/05/2014) = * Refactored HTML for rating form and rating results including CSS styles * 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 * Added class shortcode attribute * Refactored how rating results are returned in API = 2.0.4 (12/04/2014) = * Fixed rich snippets bug * Refactored API functions and added more params that can be used in shortcodes = 2.0.3 = * Information on multi-rating-pro plugin features added = 2.0.2 = * Rating results table in WP-admin query updated to order by entry_date desc = 2.0.1 = * Fixed top rating results widget bug = 2.0 = * Major refactor of plugin. * Old Shortcodes deprecated and replaced with new shortcodes. Old settings and API functions renamed and may not backward compatible. * Old settings have been renamed * 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. * Improved WP admin including view rating result entries and values = 1.1.8 (15/01/2014) = * Allow removing title from rating form and top rating results = 1.1.7 (13/01/2014) = * Added settings for default rating form title and default top rating results title = 1.1.6 (7/01/2014) = * Fixed bug in displaying top results for multiple post types = 1.1.5 (6/01/2014) = * Fixed custom title for widgets = 1.1.4 (19/12/2013) = * Added support for character encoding = 1.1.3 = (14/12/2013) * Fixed post title on top rating results widget = 1.1.2 = (14/12/2013) * Removed debugging comment accidentally left behind = 1.1.1 (12/12/2013) = * Changed shortcode parameter for post id from id to post_id * Fixed default values in API functions for themes * Fixed bug which caused only 5 top rating results being displayed = 1.1 = * Added weight rating for multi criteria = 1.0.3= * Fixed activation for older versions of PHP = 1.0.2 = * Added option to change rating results stars to small, medium or large size * Fixed some CSS issues = 1.0.1 = * Added check is_singular() to add rich snippets to rating results = 1.0 = * Initial release