Ratings & Reviews Changelog

This release keeps reviewers' personal information out of the GravityKit log.

Note: Ratings & Reviews now requires PHP 7.4 and WordPress 6.5 or newer.

🔒 Security

• Errors written to the GravityKit log now include only the related review, entry, and post IDs instead of reviewers' names, email addresses, IP addresses, review text, or full post data.

💻 Developer Updates

• Replaced GravityView hooks deprecated in GravityView 2.55 and later with their current equivalents.

This release fixes Star ratings not displaying correctly when Views are embedded with the GravityView block, along with resolving PHP notices on WordPress 6.7+.

🐛 Fixed

• Star ratings displayed as unstyled placeholder glyphs when the View was embedded using the GravityView block instead of the shortcode.
• A PHP notice could appear on WordPress 6.7+ because the extension loaded its field translations too early during startup.
• The extension's stylesheets and scripts were served with a stale cache-busting version, which could cause outdated assets to load after an update.

💻 Developer Updates

• Migrated View settings from the deprecated gravityview_default_args hook to the gravityview/view/settings/defaults filter.

This release resolves an issue causing incorrect ordering when sorting entries by review upvotes.

🐛 Fixed

• Review upvote sorting produced incorrect entry order.

This update fixes issues with saving review edits and the review form not appearing on the Single Entry page in certain cases.

🐛 Fixed

• Updated text not being saved after editing a review.
• Issue where the review form wouldn’t load on the Single Entry page if linked comments were missing from the database (e.g., after using a migration plugin).

This update fixes duplicate reviews in Single Entry layouts, PHP notices in embedded and lightbox contexts, and a translation loading warning in WordPress 6.8.

🐛 Fixed

• Duplicate reviews created under the logged-in user's name when viewing a single entry.
• WordPress 6.8 warning triggered by early loading of extension translations (requires GravityView 2.39 or newer).
• PHP notice when the View is embedded inside another View.
• PHP notice when viewing an entry in a lightbox.

This update allows saving user information for subsequent reviews and fixes issues with pending review messages and ratings in embedded Views.

🚀 Added

• Option to save user information for subsequent reviews.

🐛 Fixed

• When comments require manual approval, submitted reviews showed no pending notice to the user.
• Voting/rating entries was not possible on the Multiple Entries screen in embedded Views.

This release introduces the ability for users to remove their ratings and resolves entry and comment sorting issues.

🚀 Added

• Ability for users to remove their ratings.

🐛 Fixed

• Entries could not be sorted by stars and votes.
• Entry comments did not follow the display order set under the Discussion settings in WordPress.

This update resolves issues that prevented users from editing their reviews and allowed multiple reviews when the View was configured to limit them to one per user/entry.

🐛 Fixed

• Setting the "Reviews edit duration" to 0 (unlimited) did not allow users to edit their reviews.
• Reviews were not limited to one per user/entry when the corresponding option was enabled, and the View was embedded in a page/post.

This is a minor update that fixes a fatal error.

🐛 Fixed

• Fatal error dividing by zero when calculating average rating

This is a major update that introduces new features for anonymous reviews, enhanced control over the review form, Merge Tags, and additional customization options.

🚀 Added

• Anonymous (not logged in) users can now leave reviews/vote on entries. Learn more about anonymous reviews.
• Option to allow users to edit their reviews.
• Ability to sort entries by the number of upvotes.
• View setting to hide "Title" and "Rating" fields.
• Support for displaying the reviewer's avatar next to their review.
• Ratings can now be required on a review.
• View setting to disable downvoting.
• Merge Tags to display the total and average number of entry stars and votes. See all available Merge Tags.

🐛 Fixed

• Typo in an error message when a user tries to leave a review, but they're not allowed.
• The Rate Entry field was not allowing ratings when using the DataTables layout.
• Improved translation strings.
• PHP 8.2 deprecation notices.

🔧 Developer Updates

• Added gv_ratings_reviews_disable_downvoting filter to disable downvoting (default is false or the value set in the View settings). Learn more about the filter.
• Added gravityview_ratings_reviews_merge_tags and gravityview_ratings_reviews_replace_merge_tag filters to add additional Merge Tags and replace their contents. Learn more about the filter.

• Fixed: PHP warning on review submission

• Fixed: Sorting by votes/ratings
  • A new "Recalculate Ratings" bulk form action was added to fix sorting for existing entries
• Fixed: Stars would incorrectly display in certain themes
• Fixed: Incorrect link to all comments in notification messages
• Fixed: Rating entries did not work from an embedded View
• Fixed: PHP 8 deprecation notices

• Added: It's now possible to rate entries from the Multiple Entries screen!
• Added: Fields now have icons in the "Add Field" picker
• Fixed: Ratings being created without attached form and entry IDs ("Form ID 0 Entry ID 0")
• Fixed: Reviews Link field doesn't process Merge Tags

• Fixed: PHP warning
• Updated: Russian, Turkish, and French translations (Thank you, Viktor S and Süha Karalar)

• Fixed: Star ratings were not being saved on iOS devices
• Updated: Polish and Russian translations (Thank you, @dariusz.zielonka and @awsswa59!)

Developer Updates:

• Added: gv_ratings_reviews_get_reviews_atts filter to modify the attributes passed to get_comments() when fetching reviews
• Added: gv_ratings_reviews_is_user_allowed_to_review filter to modify whether the user can leave a review. Return a WP_Error instance to modify the message shown to the user
• Updated: templates/review-form.php file now supports a WP_Error return value from GravityView_Ratings_Reviews_Helper::is_user_allowed_to_leave_review()

• Now requires GravityView 2.0
• Fixed: Compatibility with GravityView 2.0
• Fixed: Sorting by rating
• Fixed: View Settings not displaying
• Fixed: Error saving ratings when new entries are created
• Changed: Show other settings only when "Enable entry reviews" is checked
• Added: Spanish translation (thank you, Jose Usó!)

• Fixed: Issue where all comments are trashed when a single entry is trashed
• Fixed: Entry link not working on Comments page
• Updated translations: Russian, German, and Turkish - thanks, translators!

• Fixed: Fatal error when bulk deleting entries in the Admin
• Fixed: PHP notice when submitting a review with the option Hide ratings fields set
• Added: Chinese translation (thanks, Edi Weigh!)

• Updated: Requires GravityView 1.12 or higher
• Added: Setting to allow empty reviews: "Allow empty review text"
• Fixed: DataTables issues (sorting by rating, displaying vote field)
• Fixed: Issue in WordPress 4.4 with allowing comments with empty text
• Fixed: Improved compatibility with the Recent Comments Widget. New reviews will link to the original page where they were submitted.
• Fixed: Individual star ratings not being displayed properly (always one star)
• Fixed: Sorting by stars and votes
• Fixed: Existing entries may not accept reviews
• Fixed: Clear entry cache when rating is added
• Fixed: Allow users to leave comments on ratings. Before, commenting on a review this would cause a "you've already left a review" screen.
• Fixed: Allow overriding the review-form.php template
• Fixed: $screen not an object PHP error message
• Fixed: Removed extra whitespace on Reviews Link field
• Fixed: Issue with reviews not showing up
• Tweak: Moved the review_form() method from helper class to review class
• Tweak: Added white-space: nowrap; style to +/- rating form to improve readability for "No Rating"
• Tweak: Show that updates are available even when not using active license
• Tweak: Make sure WordPress is loaded before processing files
• Developer changes:
  • Reviews now store the referring post ID of the review. It's stored using the gv_post_id comment meta key. You can access it using the update_comment_meta() function and modify it using the get_comment_metadata filter.
  • Added second parameter ($create_if_not_exists, boolean) to GravityView_Ratings_Reviews_Helper::get_post_bridge_id()
  • Added gv_ratings_reviews_allow_empty_comments filter to enable/disable comments (return boolean)
  • Renamed comment_form_default_fields filter to gv_ratings_reviews_review_form_fields
  • Renamed comment_form_defaults filter to gv_ratings_reviews_review_form_settings
  • Added gv_ratings_reviews_js_vars filter to modify Javascript commenting and +/- voting text
  • Added gv_ratings_reviews_post_bridge_title filter to modify the Bridge Post title shown in the widget. Passes two args: title and entry array. This allows using Gravity Forms Merge Tags to modify the title values.

• Updated: Fetch templates using GravityView template system so that they can be overridden properly.
  • Removed the following template path filters: gravityview_entry_comments_template_path and gv_ratings_reviews_item_template
  • Moved templates directory location from /includes/templates/ to /templates/
• Fixed: Prevent ratings fields from displaying when commenting on reviews
• Fixed: Extension class fatal error when no other extension is active
• Updated: Turkish translation (thanks Süha Karalar!)

• Added: Possibility to sort the Ratings column Reviews Link using the sorting controls on a default table layout
• Added: Possibility to sort the View by the average rating (Filter & Sort view settings)
• Fixed: Conflicts with Jetpack comments
• Updated: Translations

• Fixed: Issue with reviews not displaying

• Updated: Translation files

• Added: Export review details (review title, text, and more) in when exporting entries from Gravity Forms
• Added: Support for GravityView 1.8 tabbed settings (coming soon)
• Fixed: Sorting entries by rating

• Added: Export Ratings & Votes columns in "Export Entries" screen
• Fixed: Editing Star and Voting ratings when editing a comment in the Admin
• Fixed: Delete Post Bridge when entry is deleted
• Fixed: Only show approved comments
• Fixed: Prevent underlined icons
• Tweak: Comment text sanitization improved
• Modified: Set comment type to gravityview

• Only use approved reviews in counts and displayed comments
• Add gravityview comment type

• Initial release