wpDiscuz – Reviews

Description

wpDiscuz Reviews transforms your wpDiscuz-powered comment sections into a full-featured review system — with rating input, rich average displays, structured data, and WooCommerce compatibility — all managed from a single settings tab inside wpDiscuz.

Half-Point Rating Input

Visitors submit ratings using a smooth half-point selector embedded directly inside the wpDiscuz comment form. No separate form, no page reload. Two rating schemes are supported — 5-point and 10-point — and you can switch between them at any time without losing existing data. Six icon shapes give you full control over the look:

• Filled star
• Outline star
• Filled heart
• Outline heart
• Filled thumbs up
• Outline thumbs up

Icon size is freely adjustable from 12 px to 64 px. You can restrict who can leave reviews by user role and post type, keeping your review sections relevant and clean.

Review Headline

Reviewers can add a short headline to their review — a title that summarises their opinion before the full comment body. The headline field appears alongside the rating input, and you can make it required or optional, set a minimum character count, and cap it with a maximum length (up to 200 characters). A live character counter keeps writers informed as they type. Headlines are displayed prominently above the review text, making the thread easier to scan at a glance.

Five Average Score Display Modes

The aggregate rating renders automatically above or below the comment form — your choice. Five distinct display modes let you match the design to your site:

• Distribution — a breakdown bar for each score level showing how many reviews landed there
• Numeric — the average score, total review count, and an icon row in a clean layout
• Compact — a condensed single-line summary for tight spaces
• Pill — a small inline badge, great for card layouts
• Icons — the icon row alone, with no numeric label

The score can be shown as a raw number (e.g. 4.5 / 5) or as a percentage. Live previews of every mode are built into the settings panel so you can pick the right one without guessing.

Real-Time Rating Filter

Filter buttons are injected into the wpDiscuz comment thread, letting visitors instantly browse reviews by rating group. Counts update in real time after any submission or edit — no page reload required. The filter works in two modes: cumulative (show all reviews at N stars and above) or exact (show only that star level), switchable via a filter hook.

Verified Purchase Badge

Reviews from confirmed buyers are automatically marked with a Verified Purchase badge on WooCommerce product pages. On any other post type the badge reads Verified and can be toggled manually from the admin comment list with a single click — no editing individual comments. Admins can also bulk-verify or bulk-unverify reviews from the comment screen. The badge text is filterable if you need a custom label.

Review Gate — Require Purchase Before Reviewing

On WooCommerce product pages you can require that a user has purchased the product before they can submit a review. When the gate is active, unqualified visitors see a clear message instead of the rating form. The gate is configurable per post type, so you can apply it selectively without affecting other content.

My Reviews Tab

A My Reviews tab is added to the wpDiscuz user settings modal. Logged-in users can see every review they have ever submitted, paginated via AJAX. No separate profile page or custom query needed — it just works inside the existing modal users already know.

Three Shortcodes — Embed Reviews Anywhere

• [wpdiscuz_reviews] — a card list of reviews for any post. Configurable by post ID, review count, sort order (rating or date), avatar display, and verified-badge visibility.
• [wpdiscuz_reviews_avg] — the average score block for any post by ID. Drop it into sidebars, headers, or landing pages.
• [wpdiscuz_reviews_top_rated] — a ranked list of your highest-rated content. Filter by post type, minimum average rating, and minimum review count to surface only the posts that truly earned their stars.

Schema Markup (JSON-LD) for Rich Snippets

The addon outputs AggregateRating structured data automatically so search engines can display star ratings directly in results. It detects your active SEO plugin and integrates cleanly without duplicating schema blocks:

• Yoast SEO — injects into Yoast’s existing Article, WebPage, and Product schema pieces
• Rank Math — injects into Rank Math’s JSON-LD graph at the matching schema type
• Standalone fallback — outputs a self-contained <script type="application/ld+json"> block when neither plugin is active

Full WooCommerce Compatibility

Product pages always use a 5-point rating scale regardless of your global scheme setting, matching what WooCommerce shoppers expect. Ratings sync automatically with WooCommerce’s own average and review count, keeping the native product stars accurate. Existing WooCommerce reviews can be imported into the addon in one click from the Tools panel, with zero risk of duplicates.

Dashboard Settings

Every option lives under Dashboard > wpDiscuz > Settings > Reviews Tab. Settings are grouped by concern — Rating Input, Average Score, Display, Permissions, Shortcodes, and Schema Markup — so you never have to hunt for an option.

Installation and Configuration

• This addon installs like any other plugin for WordPress. Access to the wpDiscuz Reviews addon is provided immediately after purchase. Upon completing checkout, you may log in at gVectors.com — we will also email you a link to the login page. Then download the installation package.
• Navigate to Dashboard > Plugins > Add New and upload the addon ZIP file, then activate it.
• Once active, go to Dashboard > wpDiscuz > Settings > Reviews Tab to begin configuration.
• It will ask you to activate with the license key you received via email or in your account page. Insert the key and activate it.

If for some reason you cannot install this plugin using the WordPress plugin upload system, use this alternative method. Unzip, then upload the /wpdiscuz-reviews/ folder to your /wp-content/plugins/ directory using an FTP application such as FileZilla. Make sure you do not have double /wpdiscuz-reviews/wpdiscuz-reviews/ directories nested inside each other — correct this before continuing. Then go to Dashboard > Plugins and activate the wpDiscuz Reviews addon.