=== Breview – WooCommerce Order Reviews & Verified Buyer Ratings ===

Contributors: mswebarts, msshohan
Tags: woocommerce, reviews, product reviews, order reviews, verified reviews
Requires at least: 5.5
Tested up to: 7.0.1
Requires PHP: 7.4
Stable tag: 1.2.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Collect verified WooCommerce product reviews from the order page after purchase — just like Amazon, eBay & AliExpress. Boost trust and conversions.

== Description ==

**Breview brings the review experience of major marketplaces to your WooCommerce store.** Customers leave product reviews right from the completed order page, so every review comes from a real, verified buyer — increasing trust, social proof, and sales.

Traditionally, big e-commerce sites let customers order, receive the product, and then review it directly from their order. The default WooCommerce review system doesn't work this way — it's really just a comment form with a rating attached. Breview remasters that workflow the way it should work on every WooCommerce store.

**Why store owners choose Breview:**

* **Verified buyers only** — only customers who actually purchased and completed an order can review, and only once per purchase.
* **Higher review volume** — automatic email reminders prompt customers to review after their order completes.
* **Better on-page conversion** — reviews display on product pages with fast Ajax loading and pagination.
* **Works with your theme** — styling adapts automatically, no configuration required.
* **Multi-vendor ready** — full Dokan marketplace compatibility.

[youtube https://youtu.be/_8OHFfId_10]

### Free Features

1. Remastered, marketplace-style review workflow
2. Review form on the order page after order completion
3. Ajax form submission
4. Ajax pagination for reviews
5. Review moderation
6. Automatic email reminder for completed orders
7. Override-able template structure
8. Review submission form validation settings
9. Automatic style adaptation based on your theme
10. Dokan multi-vendor compatible

### [Upgrade to Pro](https://www.mswebarts.com/products/breview/)

1. Ability to add a review title
2. Multiple custom review list header designs
3. Multiple custom review designs
4. Multi-criteria ratings
5. Attaching images to reviews ( Upcoming )
6. Ability to filter reviews ( Upcoming )
7. More header and list designs ( Upcoming )
8. Style customization ( Upcoming )

### Documentation and Support

* For documentation and tutorials, visit our [Documentation](https://www.mswebarts.com/docs-category/breview/).
* Have a question? Visit the [Plugin's Support Forum](https://wordpress.org/support/plugin/breview).
* For more about features, FAQs, and the Pro version, see [Breview – Better Review System for WooCommerce](https://www.mswebarts.com/products/breview/).

### Happy User of Breview?

* Like our [Facebook Page](https://www.facebook.com/mswebarts).
* Learn from our tutorials on our [YouTube Channel](https://www.youtube.com/@mswebarts).
* Please [leave us a 5-star review](https://wordpress.org/support/plugin/breview/reviews/?rate=5#new-post) — it really helps! :)

== Installation ==

This section describes how to install the plugin and get it working.

**Method One – WordPress Admin (recommended)**

1. Download the plugin zip file.
2. Go to your WordPress admin dashboard -> Plugins -> Add New.
3. Click the "Upload Plugin" button.
4. Upload the downloaded plugin zip file.
5. Click "Activate".

Once activated, go to MS Web Arts -> Breview from the admin menu to control all plugin settings.

**Pro Tip:** If you see any PHP warning on your site's frontend, go to MS Web Arts -> Breview and click the Save Settings button.

**Method Two – FTP / File Manager**

1. Download the plugin zip file.
2. Connect to your hosting via FTP or your host's File Manager.
3. Navigate to your WordPress installation directory -> wp-content -> plugins.
4. Upload the uncompressed plugin folder (if using FTP) or the zip file (if using cPanel — you must extract it after upload).
5. Go to WordPress admin dashboard -> Plugins -> Installed Plugins -> Activate Breview.

Hope the installation was as smooth as the plugin works!

== Frequently Asked Questions ==

= Does Breview replace the default WooCommerce review system? =

Breview adds a marketplace-style workflow that lets verified buyers review products from their completed order page. It complements WooCommerce by ensuring reviews come from real purchasers, and displays those reviews on your product pages.

= Does it work with any WordPress theme? =

Yes. Breview automatically adapts its styling to your active theme, so reviews look native to your store with no extra configuration.

= Is Breview compatible with multi-vendor marketplaces? =

Yes. Breview is fully compatible with the Dokan multi-vendor marketplace.

= Can customers review a product more than once? =

No. Each customer can review a purchased product only once per completed order, ensuring authentic, verified reviews.

= How do I remove PHP warnings in the review tab? =

The review tab may show a warning after you activate the plugin. Go to your WordPress admin panel -> MS Web Arts -> Breview and click the Save Settings button. This saves the settings to the database and clears the warnings.

= How can I update the plugin? =

You can update Breview using WordPress's automatic and manual update options.

= Do I need to use both the free and pro versions? =

No. If you've purchased the Pro version (1.2.0 or above), you don't need the free version. From version 1.2.0 the free and pro versions are separate, and activating Pro automatically deactivates the free version.

== Screenshots ==

1. Add a review directly from the order page
2. Add review popup on the order page
3. Breview settings page
4. Review header designs
5. Review list designs
6. Multi-criteria ratings

== Changelog ==

= Version 1.2.4 ( minor update ) =
* Admin settings improvements ( global )
* Removed global CDN CSS and JS and used local
* Readme fixes

= Version 1.2.3 ( minor update ) =
* Admin settings improvements ( global )
* Serving global CSS and JS from CDN
* Minor bug fixes

= Version 1.2.2 ( minor update ) =
* Fixed add review popup not showing or mispositioned
* Other minor fixes

= Version 1.2.1 ( minor update ) =
* Fixed review completion reminder not sending
* Other minor fixes

= Version 1.2.0 ( major update ) =
* WordPress 6.5 compatibility
* Settings panel improvements
* Fixed add review and show review modal not showing
* Other minor fixes

= Version 1.1.2 =
* WordPress 6.3 compatibility
* Fixed disabled completed-order email still sending
* Minor bug fixes

= Version 1.1.1 =
* WordPress 6.2 compatibility

= Version 1.1.0 ( major update ) =
* Added option to display single rating only when multi-rating is enabled
* Introduced template structure
* Added review title field
* Implemented form submission setting on product page
* Improved settings panel
* Added custom review list header designs
* Added custom review list designs
* Other minor bug fixes and improvements

= Version 1.0.2 =
* Fixed max characters allowed setting
* Added min characters allowed setting
* Fixed JS text translations

= Version 1.0.1 =
* Added multi-criteria rating
* Added comment moderation setting
* Fixed auto-update not getting pushed
* Minor updates to the settings panel
* Fixed review submission validation
* Fixed other minor issues

= Version 1.0.0 =
* Dokan compatibility
* Ajax review form submission
* Ability to toggle review form on product page
* Send review request email once the order is completed