=== Wexofy Photo Reviews for WooCommerce ===
Contributors: wexofy
Tags: product reviews, photo reviews, woocommerce reviews, verified buyer, review images
Requires at least: 6.3
Tested up to: 7.1
Requires PHP: 7.4
WC requires at least: 8.0
WC tested up to: 9.9
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Photo reviews for WooCommerce: customer photos, verified-buyer badges, a star histogram with filters, "Helpful" votes and a lightbox.

== Description ==

Wexofy Photo Reviews turns the plain WooCommerce review box into a review section shoppers actually read. Customers attach photos to their review, buyers are recognised and badged, and the product page shows the rating at a glance with a histogram you can click to filter.

**Built on native WooCommerce reviews**

Reviews stay standard WordPress comments with the WooCommerce rating. Product stars, average ratings, your theme and Rank Math / Yoast schema keep working, and if you ever deactivate the plugin every review is still there.

**What you get**

* **Photo reviews** — up to 10 photos per review (3 by default). Photos are checked, downscaled and stripped of EXIF/GPS data before they are saved.
* **Verified buyer badge** — a review is matched by e-mail to a Completed order for that product.
* **Moderation you choose** — publish verified buyers straight away and hold the rest, hold everything, or let only buyers review.
* **Rating summary** — the average, a 5→1 histogram and "% would recommend". Click a bar to filter.
* **Filters and sorting** — by stars, "With photos", newest, highest, lowest or most helpful, with "Show more" loading.
* **"Helpful" votes** — one vote per visitor, and a "Most helpful" sort.
* **Lightbox** — full-screen photos with arrow and keyboard navigation.
* **Store reply** — answer a review publicly from the comment edit screen.
* **My account → My reviews** — customers see their reviews and whether they are published.
* **Spam protection without reCAPTCHA** — honeypot, minimum fill time, per-IP limit and a link filter, plus your WordPress moderation rules.
* **Works behind page caches** — the list renders on the server, the form and votes fetch fresh security tokens.
* **Star rating display fix** — optional: draw every star rating with the plugin's own stars when a theme or CSS optimiser hides them.
* **SEO** — adds the review photos to the WooCommerce product schema without duplicating it.
* **Shortcodes and blocks** — `[wxprev_reviews]` for page builders that hide the WooCommerce tabs, `[wxprev_summary]` for a compact rating anywhere.

**Want more reviews, automatically?**

[Wexofy Photo Reviews Pro](https://wexofy.com/plugins/wx-photo-reviews/) is a separate add-on that sends review request e-mails after an order is completed, rewards each review with a personal coupon (more for a photo or a video), adds video reviews, product questions & answers, a reviews wall for the home page and a store-wide rating. This free plugin is complete on its own and does not need it.

Wexofy is not affiliated with or endorsed by WooCommerce or Automattic.

== Installation ==

1. Install and activate the plugin (WooCommerce must be active).
2. Make sure reviews are on under **WooCommerce → Settings → Products** and for each product (Product data → Advanced → Enable reviews).
3. Open any product page: the Reviews tab now shows the new review block.
4. Optional: **WooCommerce → Settings → Photo Reviews** for moderation, photo limits and the other settings.

== Frequently Asked Questions ==

= Where are the reviews stored? =

As normal WooCommerce reviews (WordPress comments with a rating). Photos go to the Media Library. Nothing is locked into this plugin.

= My product page is built with a page builder and has no Reviews tab. =

Add the shortcode `[wxprev_reviews]` or the "Wexofy: product reviews" block where the reviews should appear.

= Who counts as a verified buyer? =

Someone whose e-mail (or account) has a Completed order containing the product.

= Does it work with a page cache? =

Yes. The review list is part of the cached page, and the form and "Helpful" button fetch fresh security tokens when the page loads.

= The stars on my product grid show as numbers. =

Turn on "Star rating display" under WooCommerce → Settings → Photo Reviews. It draws the stars with the plugin's own CSS, independent of the theme's star font.

= I used the earlier all-in-one "Wexofy Photo Reviews" plugin. Do I lose anything? =

No. On activation your settings, review photos, votes and store replies are carried over and the old plugin is switched off. Review e-mails, coupons, video, Q&A and the reviews wall are part of Photo Reviews Pro.

== Screenshots ==

1. The review block on a product page: rating summary, histogram, filters and photo reviews.

== Changelog ==

= 1.0.0 =
* First release on WordPress.org: photo reviews, verified-buyer badge, rating summary with histogram, filters and sorting, "Helpful" votes, lightbox, store reply, My reviews, spam protection, schema photos, star rating fix, shortcodes and blocks.
