Woo Easy Review

A modern, feature-rich review system for WooCommerce with dual review modes, photo uploads, rating analytics, and full admin controls.

Version: 1.0.0
Author: absoftlab
Requires WordPress: 5.8+
Requires PHP: 7.4+
WooCommerce: 5.0 – 8.5

Features

• Dual Review Modes — Open (anyone) or Verified Purchase (phone-verified buyers only)
• Star Ratings — 1–5 star rating with animated UI
• Review Title & Content — Optional title with full review body
• Photo Uploads — Customers can attach up to 10 images (JPG, PNG, GIF, WebP)
• Helpful / Not Helpful Votes — Cookie-based voting on each review
• AJAX Pagination — "Load more" button for smooth browsing without page reload
• Admin Review Panel — Approve, reject, or delete reviews with search and filter
• Auto-Approve Option — Publish reviews instantly or hold for manual moderation
• Email Notifications — HTML email alert sent to admin on every new review submission
• HPOS Compatible — Fully compatible with WooCommerce High-Performance Order Storage

Requirements

Installation

1. Upload the woo-easy-review folder to /wp-content/plugins/
2. Activate the plugin from Plugins → Installed Plugins
3. WooCommerce must be installed and active
4. Go to Easy Reviews → Settings to configure the plugin

Settings

Navigate to WP Admin → Easy Reviews → Settings

Review Mode

Moderation

• Auto-approve reviews — When ON, reviews publish immediately. When OFF, each review requires manual approval from the admin panel.

Photo Uploads

• Maximum Image Size — Per-image file size limit (1–20 MB, default: 2 MB)
• Maximum Photos per Review — How many images a customer can attach (1–10, default: 5)

Email Notifications

• Enable notifications — Toggle email alerts on/off
• Notification email — Address to receive new review alerts (defaults to site admin email)

Display

• Reviews per Page — Number of reviews loaded initially; more load via the "Load more" button (default: 6)

Admin Panel

WP Admin → Easy Reviews → All Reviews

• Filter reviews by status: All / Pending / Approved / Rejected
• Filter by product or keyword search
• Approve, reject, or delete reviews with one click (AJAX, no page reload)
• Status counts shown in tab bar

How Verified Purchase Mode Works

1. Customer enters their phone number on the product page
2. Plugin checks WooCommerce orders for a completed order containing the product with that phone number
3. If verified, the review form unlocks with the customer name pre-filled
4. On submission, purchase is re-verified server-side to prevent bypassing
5. Each phone number can only submit one review per product

File Structure

woo-easy-review/
├── woo-easy-review.php          # Plugin bootstrap & constants
├── includes/
│   ├── class-wer-activator.php  # Activation / deactivation hooks
│   ├── class-wer-db.php         # Database layer (custom table)
│   ├── class-wer-admin.php      # Admin menu, settings, review list
│   ├── class-wer-frontend.php   # WooCommerce tab & asset enqueue
│   └── class-wer-ajax.php       # AJAX handlers (verify, submit, vote, load)
├── templates/
│   ├── review-section.php       # Product page review section wrapper
│   ├── review-form.php          # Customer-facing review submission form
│   ├── review-item.php          # Single review card template
│   ├── admin-reviews.php        # Admin review list page
│   └── admin-settings.php       # Admin settings page
└── assets/
    ├── css/
    │   ├── wer-frontend.css     # Frontend styles
    │   └── wer-admin.css        # Admin panel styles
    └── js/
        ├── wer-frontend.js      # Frontend interactions (submit, vote, load more)
        └── wer-admin.js         # Admin interactions (approve, reject, delete)

Changelog

1.0.0

• Initial release
• Open and Verified Purchase review modes
• Photo upload support
• Admin panel with moderation controls
• Email notification system
• Helpful/Not helpful voting
• AJAX pagination
• WooCommerce HPOS compatibility

License

GPLv2 or later — https://www.gnu.org/licenses/gpl-2.0.html