=== Comment Rating Field Plugin ===
Contributors: n7studios,wpzinc
Donate link: https://www.wpzinc.com/plugins/comment-rating-field-pro-plugin
Tags: comment,field,rating,ratings,star,stars,gd,comments,review,reviews,stars,feedback
Requires at least: 3.6
Tested up to: 4.7.2
Stable tag: trunk
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Adds a 5 star rating field to the end of a comment form in WordPress.
== Description ==
Comment Rating Field adds a 5 star rating field to the end of a comment form in WordPress, allowing the site visitor to optionally submit a rating along with their comment. Ratings are displayed as stars below the comment text.
> #### Comment Rating Field Pro
> Comment Rating Field Pro provides additional functionality:
>
> - **Choose Maximum Rating Scale:** You're not restricted to a 5 star rating scale; choose a maximum between 3 and 10
> - **Unlimited Rating Fields for any Post Type:** Add more than one rating field to your comment forms for Pages, Posts and/or Custom Post Types
> - **Different Rating Fields by Post Type and Taxonomy:** Each rating field group can be targeted to a specific Post Type and/or Taxonomy, allowing different fields for different sections of your web site.
> - **Google Rich Snippet Support:** Choose a schema (e.g. Review, Product, Place, Person) for your Ratings. Visitors can see the average rating on your Google search results.
> - **Retina Ready, Any Color and Size:** Editable styling options include star/bar foreground and background colors, as well as star size.
> - **Rating Field Placement:** Rating fields on your comment form can display before all fields, before the comment field or after the comment field.
> - **Rating Control:** Disable ratings on replies, limit the number of ratings per User per Post.
> - **Manage Reviews:** View and edit ratings in the WordPress Admin when editing a Comment.
> - **Jetpack, WooCommerce and Simple Comment Editing Support:** Pro is compatible with Jetpack, WooCommerce and SCE.
> - **Rating Output:** Average ratings can be displayed in excerpts, content and/or RSS feeds. Choose to display average rating, rating breakdown, number of ratings.
> - **Amazon Bar Chart Style:** Ratings can be output in a bar chart breakdown style, similar to Amazon.
> - **Filter Comments:** Users can click an average rating breakdown (e.g. 5 stars), to see all comments with a 5 star review.
> - **Shortcodes:** Use a shortcode to display the rating output anywhere within your content, for any Post ID.
> - **Widgets:** Use a shortcode to display the rating output anywhere within your content, for any Post ID.
> - **Functions:** For developers not using comment_form() and wp_list_comments(), PHP functions are supplied to easily output average ratings, ratings on comments and rating fields within your custom implementation.
>
> [Upgrade to Comment Rating Field Pro](https://www.wpzinc.com/plugins/comment-rating-field-pro-plugin/)
= Support =
We will do our best to provide support through the WordPress forums. However, please understand that this is a free plugin,
so support will be limited. Please read this article on how to properly ask for WordPress support and get it.
If you require one to one email support, please consider upgrading to the Pro version.
= WP Zinc =
We produce free and premium WordPress Plugins that supercharge your site, by increasing user engagement, boost site visitor numbers
and keep your WordPress web sites secure.
Find out more about us at wpzinc.com
== Installation ==
1. Upload the `comment-rating-field-plugin` folder to the `/wp-content/plugins/` directory
2. Active the Comment Rating Field Plugin through the 'Plugins' menu in WordPress
3. Configure the plugin by going to the `Comment Rating Field Plugin` menu that appears in your admin menu
== Frequently Asked Questions ==
== Screenshots ==
1. Comment Rating Field Plugin on Comment Form
2. Star rating displayed below comment text
== Changelog ==
= 2.2.0 =
* Added: Edit Ratings in WordPress Admin when editing a Comment
* Added: Improved graphics for star rating and cancel buttons, with Retina support
* Added: Shortcode to output average rating for a Post
= 2.1.3 =
* Fix: Undefined variable errors
= 2.1.2 =
* Fix: Only display Review Helper for Super Admin and Admin
= 2.1.1 =
* Added: Review Helper to check if the user needs help
* Added: Using Pro core codebase and UI for basic features. Fixes several oustanding bugs
* Updated: Dashboard Submodule
* Fix: On new installations, enable for Posts by default to avoid possible confusion that the plugin does not work
= 2.1.0 =
* Fix: Changed branding from WP Cube to WP Zinc
= 2.0.9 =
* Tested with WordPress 4.3
* Fix: plugin_dir_path() and plugin_dir_url() used for Multisite / symlink support
= 2.0.8 =
* Added: Spanish translation
* Fix: Only calculate average rating from approved comments (some comments awaiting moderation were wrongly included in calculations previously)
= 2.0.7 =
* Fix: Changed Menu Icon
* Fix: WordPress 4.0 compatibility
* Fix: Removed unused admin CSS
= 2.0.6 =
* Fix: PHP warning on uninitialized $totalRating variable (props: tim.samuelsson)
= 2.0.5 =
* Added translation support and .pot file
= 2.0.4 =
* Fix: Better jQuery rating integration
= 2.0.3 =
* Removed reference to unused admin.js file
= 2.0.2 =
* Committed frontend.js; removed unused files
= 2.0.1 =
* Dashboard CSS + JS enhancements
= 2.0 =
* Fix: UI enhancements
= 1.5 =
* Fix: Upgrade link
* Version number in line with Pro version
= 1.42 =
* Fix: Enabled on Page option (ratings now display on Pages)
* Fix: CSS for some installations where rating numbers would display in front of stars
= 1.41 =
* Fix for WordPress 3.4 compatibility
* jQuery Rating Javascript updated to 3.14
= 1.4 =
* Removal of Donate Button
* On Activation, plugin no longer enables ratings on Pages and Posts by default
* Change: Average Rating displayed below content for better formatting and output on themes
* Fix: Language / localisation support
* Fix: Rating only shows on selected categories where specified in the plugin
* Fix: Recalculation of rating when comment removed
* Fix: Multisite Compatibility
* Fix: W3 Total Cache compatibility
* Pro Version Only: Support: Access to support ticket system and knowledgebase
* Pro Version Only: Custom Post Types: Support for rating display and functionality on ANY Custom Post Types and their Taxonomies
* Pro Version Only: Widgets: List the Highest Average Rating Posts within your sidebars
* Pro Version Only: Shortcodes: Use a shortcode to display the Average Rating anywhere within your content
* Pro Version Only: Rating Field: Make rating field a required field
* Pro Version Only: Display Average Rating: Choose to display average rating above or below the content
* Pro Version Only: Seamless Upgrade: Retain all current settings and ratings when upgrading to Pro
= 1.3 =
* Javascript changes to fix comment rating field not appearing below comment field on some themes.
= 1.2 =
* Enable on Pages Option Added
* Enable on Post Categories Option Added
* Display Average Option Added - will display the average of all ratings at the top of the comments list.
* Donate Button Added to Settings Panel
* Change to readme.txt file for required ID on comment form.
= 1.01 =
* Fixed paths for CSS and Javascript.
= 1.0 =
* First release.
== Upgrade Notice ==