Documentation - Customer Reviews

01 — Introduction

What the plugin does

ReviQuo extends WooCommerce’s native product-review system. Review text, ratings, approval state, author information, and purchase verification remain in WordPress comments and WooCommerce APIs.

01

Capture richer stories

Record webcam video, upload existing videos, and add up to five product photos.

02

Stay in control

Moderate media reviews, set required-media rules, and capture customer consent.

03

Build trust anywhere

Use native reviews, reusable displays, Elementor, Gutenberg, shortcodes, or REST.

02 — Before you begin

Requirements & compatibility

WPWordPressVersion 6.8 or later

PHPPHPVersion 7.4 or later

WooWooCommerceInstalled and active

HTTPSSecure connectionRequired for camera access

03 — Feature access

Free and Pro at a glance

Core collection and display tools are included in both plans. Pro adds advanced layouts, trust signals, structured data, and unlimited reminder rules.

FeatureFreePro

Webcam & video upload✓✓

Up to five photos✓✓

List review display✓✓

Grid & masonry layouts—✓

Verified customer badge—✓

Unlimited reminder rules1 rule✓

04 — Getting started

Installation & first-time setup

Keep WooCommerce’s familiar review workflow and layer ReviQuo’s media features on top.

1
Prepare WooCommerce
Install and activate WooCommerce, then enable product reviews and ratings under WooCommerce → Settings → Products.
2
Install ReviQuo
Install it from Plugins → Add New or upload the product-reviews directory, then activate it.
3
Configure the experience
Open ReviQuo → Review Settings and work through General, Storefront, Appearance, Recording Modal, and Email reminders.
4
Run a real test
Submit a review in a private browser window, then verify media, moderation, email delivery, public display, and mobile layout.

05 — Configuration

Review settings

The plugin settings live under ReviQuo → Review Settings. Every setting is enforced server-side where required—not only hidden in the interface.

GeneralStorefrontAppearanceRecording modal

●

Webcam recording

Let customers record in-browser with a live preview. Free supports 1–2 minutes; Pro supports 1–10 minutes.

Requires HTTPS and camera permission

↑

Video file upload

Accept existing MP4, WebM, or MKV files with filename, preview, clear, and independent required-file validation.

MP4 and WebM have widest playback support

▧

Photo upload

Accept JPEG, PNG, GIF, and WebP in multiple selections, with thumbnails and removal before submit.

Maximum five photos per review

✓

Consent checkbox

Add required editable consent text and save the site-local submission timestamp as review metadata.

Adapt the wording to your jurisdiction

Storefront display

Rating summaryAverage, stars, count, and five-to-one-star histogramFree

Review filtersFilter currently rendered reviews by rating or attached mediaFree

Rich snippetsEnrich WooCommerce JSON-LD with review images and video objectsPro

Verified badgeShow a styled badge when WooCommerce confirms product ownershipPro

Appearance & recording modal

Style record, video upload, photo upload, modal action buttons, and the verified badge. Controls include colors, hover states, labels, icons, borders, radius, typography, spacing, and sizes. The modal also supports title styling, backdrop color and opacity, background color, and a 0–30px radius.

Reset settings

Restores capture, display, consent, and reminder defaults and cancels scheduled reminders. It does not delete reviews, media, saved displays, reminder history, or customer opt-outs.

06 — Customer experience

From review form to storefront

Customers stay on the standard WooCommerce product page throughout the experience.

1Rate & writeChoose stars and enter review text

→

2Add mediaRecord, upload video, or attach photos

→

3ModerateApprove through the media review screen

→

4Build trustShow galleries, badges, filters, and lightbox

Moderating media reviews

Open ReviQuo → Reviews to search, sort, paginate, and manage reviews with video or photo metadata. The screen shows author details, product, rating, first-video preview, media counts, date, and status.

ApproveUnapproveMark as spamNot spamMove to trashRestore

07 — Reusable displays

Show reviews anywhere

Create named display configurations under ReviQuo → Review Shortcode, then reuse them without duplicating settings.

ListFree and Pro

GridPro

MasonryPro

Choose the source

Current product — uses the product page context.
Selected products — choose published top-level products.
All products — query all approved product reviews.

Control the layout

1–4 columns for desktop, tablet, and mobile.
Card gap, radius, background, text, accent, and star colors.
1–24 reviews per load and four sort orders.

Shortcode

[reviquo id="123"]

GGutenberg blockDynamic block with refresh, alignment, anchor, and product preview context.

EElementor widgetUses the same server renderer, filters, lightbox, responsive layout, and Load More.

↗AJAX Load MoreEach display instance keeps independent filters and pagination state.

08 — Automation

Email review reminders

Send status-based review requests with delayed delivery, reusable templates, and signed unsubscribe handling.

Order status changesA configured WooCommerce trigger matches

Reminder is queuedSender and template are saved as a snapshot

Safety checks runOrder, opt-out, email, and products are revalidated

Email is sentImmediately or through WordPress Cron

Each rule includes

Enable switch and order-status trigger.
Delay from 0 to 365 days.
Required subject and HTML-capable message.
Live preview with sample customer data.

Delivery safeguards

Once per order and rule.
Cancel on Cancelled or Refunded.
Honor hashed customer opt-outs.
Hourly fallback processes missed Cron events.

Available placeholders

{customer_name}{order_number}{order_date}{site_name}{site_url}{products_list}{unsubscribe_link}

09 — Headless storefronts

Read-only REST API

Approved, top-level WooCommerce reviews on published products are available under /wp-json/sktpr/v1. Customer emails, IP addresses, user agents, and unapproved comments are never returned.

GET/reviewsPaginated reviews across all or selected products

GET/reviews/{id}One approved review

GET/products/{product_id}/review-summaryAggregate product rating data

GET/review-displaysPublished saved displays

GET/review-displays/{id}/reviewsReviews using a display’s saved query

Example request

GET /wp-json/sktpr/v1/reviews?product_id=123&rating=5&media=true&per_page=12

Review query parameters

product_idOne product ID

product_idsComma-separated or array values

pageMinimum 1

per_page1–100

ratingInteger 1–5

mediaOnly reviews with media

ordernewest, oldest, highest, lowest

Your site remains responsible for REST cache headers, CORS policy, rate limiting, and CDN behavior.

10 — Privacy & retention

Know where every record lives

ReviQuo works with WordPress’s existing data model and adds focused metadata, options, saved displays, and reminder records.

DataStorage

Review text, author, status, dateWordPress comments

RatingWooCommerce rating comment meta

Video and photo URLsPlugin comment meta

Consent timestampsktpr_gdpr_consent comment meta

Uploaded filesWordPress Media Library

Saved displaysPrivate sktpr_review_sc posts

Reminder historysktpr_email_reminders custom table

Opt-outsHMAC hashes in sktpr_email_optouts

Export Personal Data

Exports Product Review Media and Review Reminder Emails, including media URLs, consent timestamp, product, order, status, and schedule information.

Erase Personal Data

Deletes review media attachments and metadata, removes reminder rows and cron events, but retains the unreadable opt-out hash.

11 — Developer reference

Identifiers, hooks & assets

NamespaceSKTPREVIEW

Version constantSKTPR_VERSION

Shortcodereviquo

Blocksktpr/reviews

Elementor widgetsktpr-product-reviews

REST namespacesktpr/v1

Public extension points

PHP

add_filter( 'sktpr_video_duration_unit', function ( $unit ) {
    return $unit;
} );

add_filter( 'sktpr_templates_folder', function () {
    return 'product-reviews';
} );

add_action( 'pr_fs_loaded', function () {
    // License-dependent integration code.
} );

Build from source

npm installnpm run devnpm run watchnpm run productionnpm run zip

Source lives under dev/admin/, dev/public/, and dev/blocks/reviews/. Compiled assets are written to matching folders under assets/; edit source, not compiled files.

12 — Troubleshooting

Common issues, clear fixes

Start with the symptom below, then work through the checks in order.

The record button is missing

Enable Webcam recording, confirm product reviews are active, use a single-product page, and verify the theme applies WooCommerce review-form filters.

The browser cannot access the camera

Use HTTPS or localhost, allow camera and microphone, close competing apps, and try a current browser with MediaRecorder support.

An uploaded video is not attached

Prefer MP4 or WebM, check WordPress and PHP upload limits, allowed MIME types, security rules, Media Library, and multipart form data.

A media review is not public

Check Pending, Spam, and Trash; approve it when auto-approval is off; clear caches; verify the theme executes WooCommerce review hooks.

Filters or Load More do not respond

Check console errors, jQuery, public.min.js, admin-ajax.php access, and cache or firewall rules affecting unauthenticated AJAX.

Reminder emails are late or missing

Confirm the master switch, rule, status change, valid email, reviewable products, opt-out state, Cron, SMTP logs, and order notes.

13 — Ready to ship

Launch checklist

Complete this list on a staging store before inviting customers to submit media.

Your review experience is ready.

Run one final order-to-review test, verify it on a real mobile device, then start collecting customer stories.

Back to top ↑

Customer reviews thatspeak for themselves.

What the plugin does

Capture richer stories

Stay in control

Build trust anywhere

Requirements & compatibility

Free and Pro at a glance

Installation & first-time setup

Review settings

Webcam recording

Video file upload

Photo upload

Consent checkbox

Storefront display

Appearance & recording modal

From review form to storefront

Moderating media reviews

Show reviews anywhere

Choose the source

Control the layout

Email review reminders

Each rule includes

Delivery safeguards

Read-only REST API

Review query parameters

Know where every record lives

Export Personal Data

Erase Personal Data

Identifiers, hooks & assets

Public extension points

Build from source

Common issues, clear fixes

Launch checklist

Your review experience is ready.

Customer reviews that
speak for themselves.