=== Site Reviews ===
Contributors: geminilabs, pryley
Donate link: https://ko-fi.com/pryley
Tags: reviews, ratings, testimonials, woocommerce, product reviews, business reviews, stars, star ratings, elementor
Tested up to: 6.1
Stable tag: 6.5.1
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, mark reviews as verified, 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.

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 website.
2. [View a live demo](https://demo.site-reviews.com)

= 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.
- __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
- __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
- __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, 4 CAPTCHA options (FriendlyCaptcha, hCaptcha, 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__: Mark reviews as verified
- __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 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 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 Product purchases.
- __[Review Themes](https://niftyplugins.com/plugins/site-reviews-themes/)__: Create custom review designs with a drag-and-drop builder, and display your reviews in a carousel or grid.

= Third Party Plugin Support =

Site Reviews is officially compatible with the following plugins:

- [Akismet](https://wordpress.org/plugins/akismet/)
- [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/)
- [Litespeed Cache](https://wordpress.org/plugins/litespeed-cache/)
- [Loyalty Program for WooCommerce](https://advancedcouponsplugin.com/woocommerce-loyalty-program/)
- [Members](https://wordpress.org/plugins/members/)
- [Ninja Forms](https://ninjaforms.com/)
- [Oxygen Builder](https://oxygenbuilder.com)
- [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/)
- [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/)
- [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 Requirements =

- MySQL 5.6 or greater
- PHP 7.2 or greater
- WordPress 5.8 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/).

== Screenshots ==

1. The "All Reviews" page.
2. Add-ons provide additional functionality to Site Reviews
3. The "Edit Review" page.
4. Site Reviews has full support for the new Blocks Editor and includes custom blocks for each of the shortcodes.
5. If you are still using the Classic page editor, you can use the Site Reviews  dropdown button to easily add any of the shortcodes.
6. Site Reviews includes three widgets.
7. Site Reviews includes a Help page with answers to frequently asked questions and complete documentation for all available shortcode options.
8. The "General" settings page.
9. The "Reviews" settings page.
10. The "Submissions" settings page.
11. The "Schema" settings page.
12. Easily add a custom translation for any text in the plugin.
13. Export/import the plugin settings, and perform various other tasks.
14. If you experience any issues with the plugin, the console logger is the first pace to look.
15. View information about the configuration of your server, your website, and the Site Reviews plugin.
16. This is what the Slack notifications look like.

== Upgrade Notice ==

= 6.0 =

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

== Changelog ==

= 6.5.1 (2023-02-23) =

- Fixed copy/pasting of shortcode examples from the Shortcodes documentation
- Updated Shortcodes documentation

= 6.5.0 (2023-02-21) =

- Added date and status options to the Export Reviews tool
- Added new "Single Review" block to display a single review
- Added new "Single Review" Elementor widget to display a single review
- Added new "Single Review" widget to display a single review
- Added new [site_review] shortcode to display a single review
- Fixed ability to press Enter when writing a response to a review using the inline editor on the All Reviews admin page
- Fixed button loading in the review form
- Fixed compatibility with Multilingual plugins (you should now be able to translate addons)
- Fixed compatibility with Object Cache plugins (you should now be able to save the settings if you weren't able to before)
- Fixed compatibility with WordPress Multisite
- Fixed HTML entities from breaking translations in the Strings settings
- Fixed PHP 8.1 deprecation notices
- Fixed PHP errors when changing the maximum rating with an unsupported filter hook
- Fixed support for rendering reviews with custom fields (Review Forms addon) and themes (Review Themes addon) using the helper functions
- Fixed the visibility of the Import Product Reviews tool
- Improved sanitization of form values and helper function arguments
- Improved the System Info report
- Renamed the "site-reviews/rest-api/reviews/properties" hook to "site-reviews/rest-api/reviews/schema/properties"
- Renamed the "site-reviews/rest-api/summary/properties" hook to "site-reviews/rest-api/summary/schema/properties"
- Updated Action Scheduler to v3.5.4

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