=== Ultimate Reviews ===
Contributors: Rustaurius, EtoileWebDesign
Tags: review, ratings, WooCommerce reviews, product reviews, testimonial
Requires at least: 5.0
Tested up to: 7.0
Stable tag: 3.2.19
License: GPLv3
License URI:http://www.gnu.org/licenses/gpl-3.0.html

Best review plugin. Let visitors submit reviews and display them via shortcode or widget. Replace WooCommerce reviews and ratings. Require login, etc.

== Description ==

<a href='http://www.etoilewebdesign.com/ultimate-reviews-demo/'>Reviews Demo</a>

### Complete Reviews Solution

An easy to use product review plugin that lets visitors submit reviews for different products, events or anything else. Ultimate Reviews is easy to set up and includes two smart shortcodes, one that displays your reviews and one that displays a form that your visitors can use to submit reviews.

<strong>Includes Gutenberg blocks for displaying reviews and for the submit review form!</strong>

= Key Features =

* Accept and manage user reviews
* Display product reviews for one or all products
* Multiple rating systems, including points and percentage
* Set the maximum score for your product review and use either a text input, dropdown selection or number of stars for score input
* Filter reviews by score, product name and/or review author
* Restrict reviewable products to a predefined list, and drag-and-drop to re-arrange the list
* Flexible styling using the Custom CSS option

[youtube https://www.youtube.com/watch?v=IxM1mizhzek]

`
[ultimate-reviews]
`

Simply insert the shortcode above into any page to display your reviews.

Many straight-forward options are included that let you adjust review rating and scoring, add images and videos, restrict reviewable products, add review categories, change how reviews are displayed, and more.

= Additional Features =

The following are some of the other great features that are included with the Ultimate Reviews plugin:

* Allow users to upload an image with their review
* Allow users to upload a video with their review
* Options to display the date and author of the review
* Ability to flag reviews as a inappropriate
* Option to allow comments on reviews
* Review categories for simple organization and classification
* Review pagination
* Integration with <a href=“https://wordpress.org/plugins/ultimate-product-catalogue/“>Ultimate Product Catalog</a> plugin, allowing you to restrict reviews to only products in your catalog

`[submit-review]
`

Insert the shortcode above on any page to display a review submission form, allowing your WordPress site's visitors to leave reviews.

= WooCommerce Reviews Integration (Requires Premium) =

<a href='http://www.etoilewebdesign.com/ultimate-reviews-demo/shop/'>WooCommerce Reviews Demo</a>

Ultimate Reviews is now integrated with WooCommerce. Available in the premium version are options to replace the default WooCommerce product reviews tab as well as the ratings area on your WooCommerce product page with the reviews and ratings from this plugin. This will allow you to better manage your reviews, review WooCommerce products using Ultimate Reviews, and offer your visitors more customized reviews and ratings in your WooCommerce shop.

* Replace WooCommerce Reviews: Make it so the "Reviews" tab on the WooCommerce product page uses Ultimate Reviews instead of the default WooCommerce system
* Override WooCommerce Theme: Make it so the "Ratings" area under the product name on the WooCommerce product page is overwritten with the rating score from Ultimate Reviews
* Verified Buyers: Make it so that only those who have purchased a product can leave a product review
* Set a minimum and/or maximum number of days after purchase a verified buyer is able to leave a review
* Email Messages: Create one or more email messages that can be sent to users
* Review Reminders: Choose to send a reminder to review after an order has been set to a selected status for a certain amount of time.

[youtube https://www.youtube.com/watch?v=FLqehqw5k8E]

= Premium Features =

It’s never been easier to add review functionality to your site. From simple reviews, with one overall rating score, to in-depth reviews, with multiple fields and sub-ratings, you can customize Ultimate Reviews to perfectly suit your needs. All of this with multiple layout, styling and review ordering options.

The premium version includes many useful features such as:

* WooCommerce integration, including verified buyers and min/max days after purchase to leave a review
* Allow in-depth reviews and create additional review fields, such as value, appearance, quality, etc.
* Add in custom fields to the review that don't affect the score/rating, such as text, checkbox, radio button and drop-down fields
* Rich snippets / schema structured data for individual reviews and also for aggregate ratings in the reviews summary
* Detailed, customizable HTML emails that can automatically ask for reviews of each product in a WooCommerce order
* Reviews search shortcode using AJAX, so visitors can search reviews by keyword without reloading the page
* Option to make any review field filterable (ex. What store did you visit? What size did you buy? etc.) so visitors can find the most helpful reviews for them
* Infinite scroll for reviews
* Let visitors vote reviews up or down if they find them helpful (review karma). Sort reviews by karma.
* Require reviewers to be logged in, with available login options including WordPress and the <a href=“https://wordpress.org/plugins/front-end-only-users/“>Front-End Only Users</a> plugin
* Replace “Reviews” tab on WooCommerce product page with reviews from Ultimate Reviews
* Replace “Ratings” area on WooCommerce product page with ratings from Ultimate Reviews
* Multiple layout options for your reviews, including thumbnail (excerpt with read more link) and expandable layouts, in addition to the standard layout
* Require Admin Approval of reviews before they're displayed
* Require confirmation of a review submitter's email address
* Add a captcha to your review submission form to help prevent spam
* Group your reviews by product for better organization
* Weighted reviews: make certain reviews count for more towards the average rating
* Display summary statistics above product groupings
* Aggregate microdata for WooCommerce, Ultimate Product Catalog, and review display pages for rich review listings
* Dozens of options to customize the labels, fonts, colors, etc. of the plugin

<strong>** We are pleased to offer a free 7-day trial of the premium version, which users can use to test out all the features before buying the premium version! **</strong>

= Shortcodes =

* [submit-review]: displays a form that allows visitors to submit a review of a product that you or they specify
* [ultimate-reviews]: displays all reviews, or all reviews of a specified product
* Premium: [ultimate-review-search]: displays all reviews with a search box that lets users search for keywords in reviews (such as "Great product", "Customer service", etc.)
* Premium: [reviews-summary]: displays summary statistics for all reviewed products, which can then be clicked on to see individual reviews

For further information and purchasing options, please visit our <strong><a href="http://www.etoilewebdesign.com/plugins/ultimate-reviews/">WordPress reviews plugin</a></strong> homepage.

= Reviews Additional Languages =

* Czech
* French - Thanks to Julien R.

Have any questions? Please check out the support forum.

For help and support, please see:

* Our FAQ page, here: https://wordpress.org/plugins/ultimate-reviews/faq/
* Our installation guide, here: https://wordpress.org/plugins/ultimate-reviews/installation/
* Our documentation, here: https://www.etoilewebdesign.com/support-center/?Plugin=URP&Type=FAQs
* Our tutorial videos, here: https://www.youtube.com/playlist?list=PLEndQUuhlvSpw3HQakJHj4G0F0Gyc-CtU
* The Ultimate Reviews support forum, here: https://wordpress.org/support/plugin/ultimate-reviews

---------------------------------------------------------------------------------


== Installation ==

1. Upload the 'ultimate-reviews' folder to the '/wp-content/plugins/' directory
2. Activate the plugin through the 'Plugins' menu in WordPress

or

1. Go to the 'Plugins' menu in WordPress and click 'Add New'
2. Search for 'Ultimate Reviews' and select 'Install Now'
3. Activate the plugin when prompted

= Getting Started =

1. To allow visitors to submit reviews:
    * Place the [submit-review] shortcode in the content area of any page you've created and it will display a form allowing visitors to submit reviews
    * Use the 'product_name' attribute to limit the review form to one product
    * If desired, enable in-depth reviews and create new review fields ('Fields' area of the 'Options' tab) to allow your visitors to submit more detailed reviews

2. To display reviews:
    * Place the [ultimate-reviews] shortcode in the content area of any page you've created and it will display your reviews
    * Use the 'product_name' attribute to limit the displayed reviews to one product
    * Choose your desired review format in the 'Premium' area of the 'Options' tab, and review skin style in the 'Styling' area of the 'Options' tab (premium)

3. To create a new review from the back end:
    * Click on Reviews in the WordPress admin sidebar menu
    * Click on 'Add New'
    * Enter the review title in the title area and the review content in the main post content area
    * If you'd like, you can set a review image using the 'Featured Image' area
    * Set the review details (product name, score, author, etc.) using the 'Review Details' section under the main post content area
    * Click the 'Publish' button

4. To enable WooCommerce integration (premium):
    * Go to the 'WooCommerce' area of the 'Options' tab and choose whether you would like to replace WooCommerce reviews and/or score ratings with those from the Ultimate Reviews plugin. See our tutorial video for this here: https://www.youtube.com/watch?v=n_WLf1SXu9s.

5. Customize your reviews experience by making use of the many available settings and options, including choosing whether to have text or stars for score rating input, review images, restricting reviews to a specific set of products (that you define), email notifications (premium) and required login options (premium)

For a list of specific features, see the Ultimate Reviews description page here: https://wordpress.org/plugins/ultimate-reviews/.

For help and support, please see:

* Our FAQ page, here: https://wordpress.org/plugins/ultimate-reviews/faq/
* Our documentation, here: https://www.etoilewebdesign.com/support-center/?Plugin=URP&Type=FAQs
* Our tutorial videos, here: https://www.youtube.com/playlist?list=PLEndQUuhlvSpw3HQakJHj4G0F0Gyc-CtU
* The Ultimate Reviews support forum, here: https://wordpress.org/support/plugin/ultimate-reviews


---------------------------------------------------------------------------------


== Frequently Asked Questions ==

= How do I let visitors submit reviews for a product? =

You can add the shortcode [submit-review]  to your page. If you only want visitors to be able to submit a review for one particular product, add the attribute "product_name" and set it equal to the name of the product that you would like them to be able to review.

= How do I display reviews that have been submitted? =

* The shortcode [ultimate-reviews] lets you display all reviews that have been created. If you only want to display reviews for one particular product, add the attribute "product_name" and set it equal to the name of the product whose reviews you'd like to display.

= Can I redirect visitors to a thank you page after they submit a review? =

* Yes, you'd just need to add the "redirect_page" attribute to your shortcode. It would look something like: [submit-review redirect_page='http://www.example.com']

= How do I manage reviews or submit my own? =

* In the WordPress admin area, click on the "Reviews" menu item in the navigation bar. You can add, edit and delete reviews from there.

= How do I replace WooCommerce reviews with those from Ultimate Reviews? =

* You need to set to "Yes" the "Replace WooCommerce Reviews" option, which is found in the "WooCommerce" area of the "Options" tab.

= How do I make it so that only people who have bought a product in WooCommerce can leave a review? =

* You need to set to "Yes" the "Verified Buyers" option in the "WooCommerce" area of the "Options" tab. There you can also set the minimum number of days a verified buyer has to wait after making a purchase before they can review as well as the maximum number of days after a purchase that a verified buyer can leave a review.

= What are in-depth reviews? =

* In-depth reviews allow you to divide your reviews into multiple sections by adding new review fields in the 'Fields' area of the 'Options' tab. Each 'Review Line' field has its own score input as well as the ability to turn on an explanation, which allows reviewers to elaborate on their score.

= Can I add custom fields to a review that do not affect the score? =

* This is definitely possible and can also be done in the 'Fields' area of the 'Options' tab by choosing any option other than 'Review Line' for the 'Type' of field (e.g. checkbox, radio button, etc.).

= Can I restrict what visitors are allowed to review (e.g. only specific products)? =

* Yes, by setting the "Restrict Product Names" option to "Yes" and/or the "Product Name Input Type" option to "Dropdown," you can then use the "Products List" section to define the products (or anything else) that you'd like visitors to be able to review.

= How do I integrate the Ultimate Product Catalog plugin? =

* You need to set the "UPCP Integration" to "Yes" and then set the "Restrict Product Names" option to "Yes" and/or the "Product Name Input Type" option to "Dropdown." You can then also set the "Autocomplete Product Names" option to "Yes" and the name field in your review form will be automatically completed with product names from your product catalog as the user types.

= Is it possible to re-order my reviews? =

* Currently you can choose between ascending or descending ordering by either Submitted Date, Rating or Review Title. You can also group your reviews by product with the ability to order them (ascending or descending) by product name.

= How do I customize the styling and layout of my reviews? =

* You can customize the plugin by adding code to the "Custom CSS" box in the "Basic" area of the "Options" tab. For example to change the font of the review title, you might want to add something like:

.ewd-urp-review-title { font-family:"Palatino Linotype", "Book Antiqua", Palatino, serif; }

In the premium version you can choose between Standard, Thumbnail and Expandable review layouts as well as use the "Styling" area of the "Options" tab, which has a built-in color picker for color fields and more!

= What are summary statistics? =

* When you choose to group your reviews by product, you can enable either full or limited summary statistics. These display at the top of the product grouping and show the average score as well as a breakdown (bar graphic and numbers) of how many ratings each score has.

= Is it possible to attach an image or video to a review. =

* This is possible. Just go to the "Basic" area of the "Options" tab and set "Review Image" or "Review Video" to "Yes".


== Screenshots ==

1. The image review format
2. The thumbnail review format, also showing summary statistics enabled
3. The large circle graph review skin with the score in the middle
4. The small circle graph review skin
5. The new review filtering section
6. The stars review skin
7. The hearts review skin
8. The thumbs review skin
9. The color bar review skin
10. The simple bar review skin
11. The expandable review format
12. Reviews with the review karma feature enabled
13. Reviews showing the "flag review as inappropriate" feature
14. The submit review form
15. WooCommerce review integration
16. WooCommerce rating and review integration on the WooCommerce product page
17. The reviews tab for the "Ultimate Product Catalog Plugin"
18. The plugin dashboard
19. The admin area showing the review title and the product being reviewed
20. The basic review options page
21. The premium review options page
22. The WooCommerce review options page
23. The "Fields" area of the "Options" tab
24. The "Ordering" area of the "Options" tab
25. The "Labelling" area of the "Options" tab
26. The "Styling" area of the "Options" tab


== Changelog ==

= 3.2.19 (2026-05-18) =
- Fix for certain custom field (in-depth field) values not displaying correctly.
- Fix for division by zero error.
- Fix for review edit screen sometimes not loading correctly. 
- Fixed deprecated notices/code.
- Compatible with WordPress 7.0.

= 3.2.18 (2026-04-17) =
- Fix for fatal error related to score calculation.

= 3.2.17 (2026-02-05) =
- Fix for reported Patchstack vulnerability.

= 3.2.16 (2025-12-02) =
- Tested with WordPress 6.9 and WooCommerce 10.3.

= 3.2.15 (2025-05-30) =
- Security update - Added escaping.

= 3.2.14 (2025-04-29) =
- Tested with WordPress 6.8.

= 3.2.13 (2024-11-25) =
- Corrected issue causing review score graphic to not show correctly in certain instances.
- Tested with WordPress 6.7.

= 3.2.12 (2024-07-16) =
- Tested with WordPress 6.6.

= 3.2.11 (2024-05-16) =
- Fix for review author not displaying.

= 3.2.10 (2024-04-04) =
- Tested for compatibility with WP 6.5 and PHP 8.2, and eliminated/fixed deprecated notices associated with this.

= 3.2.9 (2024-01-23) =
- Updating the filtering of output content for the review body.

= 3.2.8 (2023-11-07) =
- Tested for WordPress 6.4 and WooCommerce High-Performance Order Storage compatibility/support.

= 3.2.7 (2023-08-08) =
- Tested for WordPress 6.3 compatibility/support.

= 3.2.6 (2023-05-04) =
- Fixed an issue with the type value in the microdata always using Product instead of what was selected via the Items Reviewed option.

= 3.2.5 (2023-03-30) =
- Updated blocks for compatibility with WordPress 6.2.
- Fixed warning about view count being non-numeric.

= 3.2.4 (2023-03-15) =
- Fixed an issue causing the view count to not be updated when using certain review formats.

= 3.2.3 (2023-03-10) =
- Fixed an issue causing a Save Changes button to not appear on the settings page.

= 3.2.2 (2023-01-04) =
- Fixes a potential fatal error on the settings page.

= 3.2.1 (2023-01-03) =
- Update to the settings page to correct an issue that could cause an error to display for checkbox options.

= 3.2.0 (2022-12-15) =
- Added quick links to the admin about page to re-run the walk-through, view tutorial videos and suggest a feature.
- Fixed issue causing alternating background color setting to not be applied.
- Added an option to choose the alternating background color.
- Fixed an issue where, in certain instances, the review text was not appearing on the single post page.
- Tested with PHP 8.1, updated deprecated function use and updated code to remove warnings that were appearing when submitting a review or importing reviews.

[See changelog for all versions](https://www.etoilewebdesign.com/changelogs/ultimate-reviews.txt).