/admin/ecommerce/reviews. The review system can be toggled on or off globally from Admin → Settings, overridden per product, or replaced entirely with a third-party widget such as Trustpilot or Yotpo.
Storefront Ratings & Feedback
Fractional Star Ratings
Site Store Pro renders average ratings with precise fractional stars — the star track is drawn as an SVG with a clip path set to the exact decimal percentage of the average score. For example, an average rating of 4.3 renders as 4 full stars and a 30%-filled fifth star — not rounded to a whole number.Sorting Options
Customers can sort the review list by:Interactive Star Submission Form
The review submission form is an Alpine.js hover component that provides real-time star highlighting as the customer moves their cursor. The form collects:XSS Sanitization
Before any submitted review is written to the database, all HTML tags and script elements are stripped from the input. This prevents stored XSS attacks via review content.Global & Product-Level Configuration
- Global On/Off Switch
- Third-Party Review Widget
- Per-Product Toggle
Navigate to Admin → Settings (
/admin/settings) to toggle the review system on or off sitewide.When the global switch is OFF:- No review forms are rendered anywhere on the storefront
- Existing reviews are hidden from all product pages
- The admin moderation panel remains accessible
Turning the global switch back ON immediately restores all previously approved reviews to the storefront.
Admin Moderation
Global Reviews Panel
GET /admin/ecommerce/reviews
The sitewide reviews panel provides:
View All Reviews
Browse all submitted reviews across every product in your catalog
Search
Search reviews by customer name, content, or product
Filter by Product
Narrow the list to reviews for a specific product
Filter by Approval Status
Show only pending, approved, or unapproved reviews
- Approve — makes the review visible on the storefront
- Unapprove — hides the review from the storefront (preserves the record)
- Edit — modify the review content (e.g. fix formatting, remove personal information)
- Delete — permanently removes the review
Per-Product Reviews Panel
An embedded reviews table is also available directly inside the product edit form. This panel shows only reviews for that specific product and supports the same approve, unapprove, edit, and delete actions — without navigating away from the product editor.Average Rating Recalculation
Site Store Pro automatically recalculates thereviews_rating field on the parent Product record after any of the following admin actions:
1
Review Approved
When a review is approved, it is included in the average rating calculation and
reviews_rating is updated immediately.2
Review Unapproved
When a review is unapproved, it is excluded from the average and
reviews_rating is recalculated without it.3
Review Deleted
When a review is deleted,
reviews_rating is recalculated across the remaining approved reviews.The
reviews_rating value on the Product model always reflects only approved reviews. Pending and unapproved reviews have no effect on the displayed star rating.