readme.txt

=== Site Reviews ===
Contributors: geminilabs, pryley
Donate link: https://ko-fi.com/pryley
Tags: reviews, ratings, testimonials, product reviews, business reviews
Tested up to: 6.7
Stable tag: 7.2.6
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Site Reviews is a complete review management solution for your website that is designed to work in a similar way to Amazon, Tripadvisor, and Yelp.

== Description ==

Site Reviews is a complete review management solution for your website that is designed to work in a similar way to Amazon, Tripadvisor, and Yelp. The plugin provides blocks, shortcodes, and widgets, along with full documentation.

You can pin your best reviews so that they are always shown first, request review verification, require approval before new reviews are published, require visitors to be logged-in in order to write a review, send a custom notification when reviews are submitted, respond to reviews, and a lot more!

Site Reviews provides more features and options than almost every other free review plugin, and the support provided on the WordPress forum is excellent.

= Try a Live Demo =

1. [Try Site Reviews](https://tastewp.com/plugins/site-reviews/?ni=true&redirect=index.php%3Fpage=site-reviews-welcome%26tab=getting-started) for yourself on a demo server.
2. [View a demo website](https://demo.site-reviews.com)

= Watch a Tutorial =

https://www.youtube.com/watch?v=H5HdMCXvuq8

= Current Features =

- __Actively Developed and Supported__
- __Asian Language Support for Excerpts__
- __Assign Reviews__: Reviews can be assigned to Categories, Posts, Pages, Custom Post Types, and Users.
- __Avada Support__: Use the native Avada Fusion Builder elements in the Fusion Builder.
- __Avatars__: Provided by the WordPress Gravatar service
- __Backup and Restore__: Export/Import your settings and custom text strings, and use the WordPress Export and Import tools to backup your reviews.
- __Bayesian Ranking__: Easily sort pages with assigned reviews by rank (using the bayesian algorithm) in your custom WP_Query
- __Blacklist__: Block review submissions which contain specific words, phrases, IP addresses, names, and emails
- __Developer Friendly__: Designed for WordPress developers with over 200 hooks and convenient functions
- __Discord Integration__: Receive notifications in Discord when a review is submitted
- __Documentation__: FAQ and documenation for all shortcodes and functions
- __Editor Blocks__: Use the custom editor blocks in the Gutenberg editor
- __Elementor Support__: Use the native Elementor Widgets in the Elementor editor
- __Form Styles__: Match the review form with popular themes and form plugins
- __GamiPress Support__: Site Reviews integrates with GamiPress allowing you to award points when someone writes or receives a review
- __Import Third-Party Reviews__: Includes a built-in CSV importer
- __JSON-LD Schema__: Display your reviews and ratings in search results
- __Members Only__: Require users to be logged in before submitting a review
- __Multilingual Support__: Integrates with Polylang and WPML allowing you to assign reviews to all languages of a multilingual page (note: translating reviews is not supported)
- __Multisite Support__: Fully supports network/multisite websites
- __myCRED Support__: Site Reviews integrates with myCRED allowing you to award points when someone writes or receives a review
- __Notifications__: Send notifications to one or more emails when a review is submitted
- __Pagination__: Display a set number of reviews per-page with AJAX
- __Privacy__: Integrates with the WordPress privacy tools
- __Rating Summaries__: Display a summary of your review ratings from high to low.
- __Relative Dates__: You decide the date format that is displayed in your reviews
- __Responses__: Write responses to your reviews
- __REST API__: Access your reviews from remote websites and applications using the API.
- __Restrictions__: Require approval before publishing reviews and limit review submissions by email address, IP address, or username
- __Review Limits__: Prevent people from submitting more than one review per day (based on IP address, email, or username). Works with review assignments. 
- __Shortcodes__: Configurable shortcodes complete with full documentation
- __Slack Integration__: Receive notifications in Slack when a review is submitted
- __SPAM Protection__: Includes 5 layers of protection from spam! Built-in Honeypot, 6 CAPTCHA options (Cloudflare Turnstile, FriendlyCaptcha, hCaptcha, Procaptcha, reCAPTCHA v2 Invisible, and reCAPTCHA v3), Akismet, Blacklist, and Review limits
- __Templates__: Use the Site Reviews templates in your theme for full control over the HTML
- __Translations__: Easily change any text of the plugin to your own in the settings.
- __Verify Reviews__: Automatically request verification of new reviews
- __WooCommerce Support__: Site Reviews integrates with your WooCommerce Products

= Site Reviews Premium =

If you need even more features, [Site Reviews Premium](https://niftyplugins.com/plugins/site-reviews-premium/) gives you access to all of our paid addons, and offers faster and more personalised support. Premium addons include:

- __[Review Actions](https://niftyplugins.com/plugins/site-reviews-actions/)__: Allow people to upvote, report, and translate your reviews.
- __[Review Authors](https://niftyplugins.com/plugins/site-reviews-authors/)__: Update your reviews from the frontend.
- __[Review Filters](https://niftyplugins.com/plugins/site-reviews-filters/)__: Sort, filter, and search your reviews.
- __[Review Forms](https://niftyplugins.com/plugins/site-reviews-forms/)__: Create custom review forms with over 20 field types, field conditions, and individual review templates.
- __[Review Images](https://niftyplugins.com/plugins/site-reviews-images/)__: Add images with captions to your reviews, and display a gallery of your review images.
- __[Review Notifications](https://niftyplugins.com/plugins/site-reviews-notifications/)__: Create and schedule custom review notifications with conditions, and send reminder emails for WooCommerce purchases.
- __[Review Themes](https://niftyplugins.com/plugins/site-reviews-themes/)__: Display your reviews in a carousel or grid and create custom review designs with a drag-and-drop builder.

= Third Party Plugin Support =

Site Reviews is officially compatible with the following plugins:

- [Akismet](https://wordpress.org/plugins/akismet/)
- [Avada Fusion Builder](https://avada.com/)
- [BuddyBoss](https://www.buddyboss.com/)
- [BuddyPress](https://buddypress.org/)
- [Divi](https://www.elegantthemes.com/gallery/divi/)
- [Elementor](https://elementor.com/)
- [Endurance Cache](https://github.com/bluehost/endurance-page-cache/)
- [GamiPress](https://wordpress.org/plugins/gamipress/)
- [GeneratePress](https://generatepress.com/)
- [hCaptcha](https://wordpress.org/plugins/hcaptcha-for-forms-and-more/)
- [Hummingbird Performance](https://wordpress.org/plugins/hummingbird-performance/)
- [JetWooBuilder For Elementor](https://crocoblock.com/plugins/jetwoobuilder/)
- [Litespeed Cache](https://wordpress.org/plugins/litespeed-cache/)
- [Loyalty Program for WooCommerce](https://advancedcouponsplugin.com/woocommerce-loyalty-program/)
- [Members](https://wordpress.org/plugins/members/)
- [myCRED](https://mycred.me/)
- [Ninja Forms](https://ninjaforms.com/)
- [NitroPack](https://wordpress.org/plugins/nitropack/)
- [Oxygen Builder](https://oxygenbuilder.com)
- [Perfect Brands for WooCommerce](https://wordpress.org/plugins/perfect-woocommerce-brands/)
- [Polylang](https://wordpress.org/plugins/polylang/)
- [RankMath Pro](https://rankmath.com/)
- [Schema and Structured Data for WP](https://structured-data-for-wp.com/)
- [Schema Pro](https://wpschema.com/)
- [SEOPress](https://wordpress.org/plugins/wp-seopress/)
- [Search & Filter Pro](https://searchandfilter.com/)
- [SiteGround Optimizer](https://wordpress.org/plugins/sg-cachepress/)
- [Speed Booster Pack](https://wordpress.org/plugins/speed-booster-pack/)
- [Swift Performance](https://swiftperformance.io/)
- [Thrive Architect](https://thrivethemes.com/architect/)
- [W3 Total Cache](https://wordpress.org/plugins/w3-total-cache/)
- [WooCommerce](https://wordpress.org/plugins/woocommerce/)
- [WooCommerce Loyalty Points and Rewards](https://www.flycart.org/products/wordpress/wployalty)
- [WooRewards](https://wordpress.org/plugins/woorewards/)
- [WP Fastest Cache](https://www.wpfastestcache.com/)
- [WP Rocket](https://wp-rocket.me/)
- [WP Super Cache](https://wordpress.org/plugins/wp-super-cache/)
- [WP-Optimize](https://getwpo.com)
- [WPForms](https://wordpress.org/plugins/wpforms-lite/)
- [WPML](https://wpml.org/)
- [Yoast Duplicate Post](https://wordpress.org/plugins/duplicate-post/)

= Open Source =

[Follow plugin development on Github.](https://github.com/pryley/site-reviews/)

= Attribution =

Images adapted from [freepik](https://www.freepik.com).

== Installation ==

= Minimum Plugin Requirements =

- MySQL 5.6 or greater
- PHP 7.4 or greater
- WordPress 6.1 or greater

= Automatic installation =

Automatic installation is the easiest option -- WordPress will handle the file transfer, and you won’t need to leave your web browser. To do an automatic install of Site Reviews, log in to your WordPress dashboard, navigate to the Plugins menu, and click “Add New.”

In the search field type “Site Reviews,” then click “Search Plugins.” Once you’ve found it, you can view the plugin details such as the point release, rating, and description. Install it by clicking “Install Now,” and WordPress will take it from there.

= Manual installation =

Manual installation method requires downloading the Site Reviews plugin and uploading it to your web server with a FTP application. The WordPress codex contains [instructions on how to do this here](https://wordpress.org/support/article/managing-plugins/#manual-plugin-installation).

= Updating =

Automatic updates should work smoothly, but we still recommend you back up your site.

If you encounter issues with your reviews after an update, go to the Site Reviews Tools page and run the "Migrate Plugin" tool. That should return things to normal.

== Frequently Asked Questions ==

= How do I use Site Reviews? =

Once Site Reviews is installed, you can read the "Getting Started" page by clicking the Help icon on the top-right corner of any of the Site Reviews admin pages.

= I need help with something else =

All documentation can be found in the "Help & Support" page of the plugin. If your question is not answered there, please create a new topic in the [WordPress support forum](https://wordpress.org/support/plugin/site-reviews/).

= Where do I report security bugs? =

You can report any security bugs found in the source code of this plugin through the [Patchstack Vulnerability Disclosure Program](https://patchstack.com/database/vdp/site-reviews). The Patchstack team will assist you with verification, CVE assignment and take care of notifying the developers of this plugin.

== Screenshots ==

1. The "All Reviews" page.
2. The "Edit Review" page.
3. Site Reviews provides Gutenberg blocks, Elementor Widgets, and Shortcodes.
4. Premioum addons provide additional functionality to Site Reviews
5. Site Reviews provides a Help page with complete shortcode documentation and answers to frequently asked questions.
6. General settings.
7. Settings for displaying reviews.
8. Settings for review form submissions.
9. Settings for JSON-LD Schema (rich snippets)
10. Change any public-facing text of the plugin here.
11. WooCommerce integration settings
12. Import/export reviews, plugin settings, and perform various other tasks.
13. If you experience any issues with the plugin, the plugin Console is the first place to check.
14. This is what Discord notifications look like.
15. This is what Slack notifications look like.

== Upgrade Notice ==

= 7.0.0 =

This update requires a minimum of PHP 7.4 and WordPress 6.1. There are a few potentially breaking changes, so please make sure to read the plugin's changelog and Upgrade Guide after updating.

== Changelog ==

= 7.2.6 (2025-02-16) =

- Fixed a PHP Error triggered when the "%s Star | %s Stars" text is missing the placeholder tags in the Settings > Strings page.

= 7.2.5 (2025-02-12) =

- Fixed a XSS vulnerability in the review form.

= 7.2.4 (2025-02-11) =

- Fixed a PHP notice that could be triggered when other plugins use the gettext_default filter hook incorrectly.
- Fixed a PHP notice that could be triggered when other plugins use the the_editor filter hook incorrectly.
- Fixed mimetype checking for some server configurations.
- Fixed the "Delete data on uninstall" setting.
- Fixed the documentation for the `glsr_get_ratings` function.
- Fixed the `glsr_update_review` function to allow updating assigned_terms.
- Fixed the form signature validator when hooks are used to modify the request before a review is created.
- Fixed the Friendlycaptcha validator.
- Fixed the number of stars in the rating field when an invalid text translation is used.
- Fixed the Settings defaults fallback.
- Fixed the Site Reviews > Tools page from throwing an error when the WordPress Site Health > Info page crashes (this can happen on a misconfigured server or a server which runs out of available processes).

= 7.2.3 (2024-10-31) =

- Fixed broken HTML in FAQ documentation.
- Fixed compatibility with the User Activity Log plugin.
- Fixed validation of plugin settings which prevented some addon settings from saving correctly.

= 7.2.2 (2024-10-25) =

- Fixed form validation to catch manually modified hidden fields

= 7.2.1 (2024-10-24) =

- Added global color support to the Elementor widgets.
- Added [Prosopo Procaptcha](https://prosopo.io/) integration.
- Added [Ultimate Member](https://ultimatemember.com/) integration.
- Added support for Range fields ([Review Forms](https://niftyplugins.com/plugins/site-reviews-forms/) addon required).
- Added support for responsive custom fields ([Review Forms](https://niftyplugins.com/plugins/site-reviews-forms/) addon required).
- Fixed compatibility with WooCommerce block themes.
- Fixed license key masking when an addon is deactivated.
- Fixed responsive setting fields.
- Fixed WooCommerce product rating counts when using the Import Product Reviews tool to revert a product ratings migration.

= 7.1.1 (2024-09-27) =

- Fixed the review count in pagination and the rating summary when multiple post assignments are used

= 7.1.0 (2024-09-26) =

- Added "Resend Verification Email" button to reviews.
- Added the previous major version to the Rollback tool (i.e. you can now rollback from v7 to v6).
- Updated the addon update checker to use the WordPress update hooks.
- Updated the review exporter to support images (Review Images addon required) and custom fields (Review Forms addon required).
- Updated the review importer to support images (Review Images addon required), custom fields (Review Forms addon required), and skip already imported reviews.
- Fixed compatibility with the Enfold theme's duplicate post feature.
- Fixed multilingual taxonomy integration.
- Fixed some visual inconsistancies in the admin.
- Fixed the review count in the dashboard widget.

= 7.0.18 (2024-08-16) =

- Fixed a potential PHP error when normalizing rating arrays

= 7.0.17 (2024-08-11) =

- Fixed a PHP deprecated notice
- Fixed metabox styling
- Fixed the Custom ID option in Rating Summary block

= 7.0.16 (2024-07-16) =

- Fixed Elementor widget style settings

= 7.0.15 (2024-07-09) =

- Fixed aria-label usage on star ratings (fixes Google PageSpeed report errors)
- Fixed mime_type check of CSV files

= 7.0.14 (2024-07-08) =

- Fixed Assigned Users metabox value when the user's display name is empty
- Fixed Author metabox value when the author is anonymous

= 7.0.13 (2024-07-06) =

- Fixed autoload of settings
- Fixed Date fields
- Fixed Initials avatars with Cyrillic letters
- Fixed WooCommerce rating styles
- Improved mimetype check for uploaded files

= 7.0.12 (2024-06-23) =

- Updated the maximum supported WooCommerce version

= 7.0.11 (2024-06-07) =

- Fixed average rating and ranking values of assigned posts/terms/users when a review's rating is changed
- Fixed CSS for custom rating star images
- Fixed CSV import when file contains malformed UTF-8 characters
- Fixed execution order of the "site-reviews/review/responded" hook
- Fixed FlyingPress compatibility
- Fixed page scroll when expanding excerpts of long reviews
- Fixed "verified owner" value when importing WooCommerce Product reviews

= 7.0.10 (2024-05-13) =

- Fixed the "Contact Form 7" plugin style

= 7.0.9 (2024-05-10) =

- Fixed addon activation
- Fixed class option in review forms
- Fixed "Optimise Your Database Tables" tool

= 7.0.8 (2024-05-07) =

- Fixed role capabilities for Review Forms and Review Themes addons

= 7.0.7 (2024-05-06) =

- Fixed filter hooks for custom fields

= 7.0.6 (2024-05-05) =

- Fixed compatibility with [FacetWP](https://facetwp.com/) debug mode

= 7.0.5 (2024-05-04) =

- Fixed database permission error
- Fixed Hard Reset migration button
- Fixed list of available rollback plugin versions
- Fixed Pixel avatar generation
- Fixed rollback tool
- Fixed settings migration
- Queued plugin migration instead of running it immediately. Hopefully this will fix the update issues people are experiencing.

= 7.0.0 (2024-05-03) =

- ✨ Added the Review Actions addon
- 🚨 Requires all installed addons to be updated!
- 🚨 Requires at least PHP v7.4
- 🚨 Requires at least WordPress v6.1
- 🚨 Moved CSS variables from `:root {}` to `body {}`.
- Added an example CSV file that can be downloaded on the Import Reviews tool
- Added [Avada](https://avada.com/) Fusion Builder Elements
- Added Dashboard widget
- Added exponential-backoff strategy to API calls
- Added IP address detection tool settings
- Added [JetWooBuilder](https://crocoblock.com/plugins/jetwoobuilder/) integration
- Added Migrate Product Ratings to the Import Roduct Reviews tool (allows third-party plugins to filter products by rating)
- Added Reviews metabox to WooCommerce product pages
- Added [SEOPress](https://wordpress.org/plugins/wp-seopress/) integration
- Added style controls to Elementor widgets
- Added support for conditional fields in review forms (Review Forms addon required)
- Added support for multilingual categories
- Added support for SQLite databases
- Fixed bulk-delete of scheduled actions
- Fixed compatibility with the Cookie Cracker plugin
- Fixed Discord notifications for reviews with more than 2000 characters
- Fixed display of rating stars in review revisions
- Fixed Divi button style
- Fixed excerpts in cases when the PHP Intl extension is misconfigured
- Fixed pinned reviews when the WooCommerce integration is enabled
- Fixed review dates from converting the date to the site's timezone
- Fixed {review_link} notification tag
- Fixed SQL error when filtering reviews by "No author"
- Fixed validation message setting with WPML/Polylang
- Fixed [WooRewards](https://wordpress.org/plugins/woorewards/) integration
- Removed the email and IP address values from the review in javascript responses
- Removed the Site Reviews widgets from the Legacy Widget block
- Updated Action Scheduler to v3.7.4
- Updated plugin documentation

[See changelog for all versions](https://raw.githubusercontent.com/pryley/site-reviews/main/changelog.txt).