Ayasoftware Advanced Reviews

New Features

Verified Purchase Detection

• Automatically links reviews to Magento orders using customer ID, email, and product SKU
• Displays a Verified Purchase badge on confirmed reviews
• Captures the exact variant (child SKU) the customer purchased
• Records order ID, purchase date, and variant summary for reference
• Configuration option to require verified purchase before a review can be submitted

Extended Review Fields

• Pros & Cons — structured positive and negative point fields alongside the main review body
• Recommends — "Would you recommend this product?" yes/no selector
• Usage Period — free-text field ("Example: 2 weeks") to indicate how long the product was used
• All extended fields are optional and individually configurable

Review Image Uploads

• Customers can attach up to 10 images per review (configurable)
• Allowed formats: JPG, JPEG, PNG, WebP, GIF (configurable)
• Per-image size limit configurable (default 2 MB)
• Thumbnail gallery on the review list with full-size lightbox
• Images stored under pub/media/ayasoftware/advancedreviews/{review_id}/
• Admin can view uploaded images directly in the review edit form

Helpful Votes

• "Helpful" and "Not Helpful" vote buttons on each review
• Vote counts stored per review and exposed via GraphQL

Merchant Response

• Store administrators can post a public reply to any review
• Response, author name, and timestamp displayed below the review
• Editable from the Magento admin review edit form

Star Rating Rounding

• Three configurable modes: Native (Magento default), Round All (visual + SEO), Round Visual Only (preserve raw value for schema)
• Separate visual star display and SEO rating value to support structured data accuracy

Review Preview on Catalog Pages

• Displays an excerpt of the most recent approved review on category, search results, and advanced search pages
• Preview word limit configurable (set to 0 to disable)
• Applied via a plugin on ReviewRenderer — no theme modifications required

Spam Protection

• Three provider options: Akismet, Cloudflare Turnstile, Google reCAPTCHA v3
• Configurable action when spam is detected: mark as pending or reject outright
• Spam rejection logging
• Cloudflare Turnstile theme selection (Auto / Light / Dark)
• reCAPTCHA minimum score threshold configurable
• Option to reuse existing Magento reCAPTCHA configuration

Store Owner Email Notifications

• Sends an email to the store owner when a new review is submitted
• Separate notification template for new reviews; reserved template for future comment notifications
• Configurable sender identity and recipient address
• Review source (storefront / admin / GraphQL) included in the notification

Mail After Purchase

• Configurable automated review request emails after an order reaches the selected status
• Configurable delay threshold (default 14 days after purchase)
• Multi-product order support with configurable interval between emails and maximum email count
• Sort order for multi-product emails: Most Expensive or Least Reviewed
• Customizable email template with customer name, product name, image, and direct review link

Admin Review Management

• Extended review edit form with all advanced fields (verified purchase info, pros, cons, usage period, recommends, merchant response)
• Read-only fields for verified purchase details and helpful vote counts
• Image gallery visible directly in the admin form

AI Review Summaries

• New AI Features section in admin configuration with Claude, OpenAI, and Gemini provider support
• Per-provider model selection with obscured API key storage
• Generates per-product review summaries automatically via an hourly cron job
• Summaries are cached (default 24 hours, configurable) and displayed on the product page
• Minimum-reviews threshold before a summary is generated, and a cap on how many review texts are sent per product for cost control

Trustpilot Sync

• New integration under Stores → Configuration → Ayasoftware → Advanced Reviews → Third-Party Integrations
• Imports product reviews from Trustpilot via the Trustpilot API (API key and business unit ID)
• CLI command: advancedreviews:sync:trustpilot

GraphQL API

Extended the native ProductReview type with an advanced_review field covering:

• verifiedpurchase, purchasedsku
• usage_period, recommends, pros, cons
• source
• helpfulcount, nothelpful_count
• merchantresponse, merchantresponseauthor, merchantresponse_at
• images — array with url, filename, mimetype, file_size

Extended CreateProductReviewInput to accept advanced_review input (pros, cons, usage period, recommends).

System Configuration

New configuration section at Stores → Configuration → Ayasoftware → Advanced Reviews with eight groups:

• General — module enable/disable, review count display, minimum review length, star rounding mode, review preview word limit
• Media — image upload toggle, max files, max file size, allowed extensions
• Store Owner Notifications — recipient, sender, notification toggles and templates
• Mail After Purchase — enable, sender, template, threshold days, max emails, interval, product sort order
• Spam Protection — provider selection, API keys, action on detection, logging
• AI Features — AI summary enable/disable, provider and model selection, API keys, review thresholds, cache duration
• Third-Party Integrations — Trustpilot sync enable/disable, API key, business unit ID
• About — name, version, documentation link

Compatibility

• Magento Open Source and Adobe Commerce 2.4.x
• PHP 8.1+
• Extends native MagentoReview and MagentoReviewGraphQl — does not replace core review tables or workflows
• Works with the default Luma theme; uses standard layout XML and block/template overrides

Initial release

Features

• Rich review metadata: pros, cons, usage period, recommendation value, and merchant responses
• Review image uploads with configurable limits, maximum file size, and allowed extensions
• Verified purchase matching against existing customer orders
• Catalog review summary renderer with configurable review count display and star-rating rounding
• Store owner email notifications for new reviews
• Mail After Purchase review request configuration and email template
• Spam protection with Akismet, Cloudflare Turnstile, or Google reCAPTCHA (reject or mark-pending)
• Advanced Review fieldset on the admin review edit form
• GraphQL: advanced_review field on ProductReview and CreateProductReviewInput extension