Universal Product Review Summary Badge

WHAT IT DOES

This script extracts and displays product review data on any e-commerce site, giving you a quick visual summary of customer feedback. When you visit a product page, the script scans for review elements—star ratings, average rating, and review count—and displays a prominent badge near the product title or price. The badge shows the average rating out of 5, a visual star display, the total review count, and an optional sentiment label (Excellent, Good, or Poor). The badge is color-coded: green for ratings 4.5 and above, yellow for 3.5-4.5, and red for below 3.5. The badge updates dynamically as you navigate or select product variations. A toggle lets you enable or disable the badge.

WHERE IT RUNS

The script runs on all websites (*://*/*), making it truly universal. It works on product pages from Amazon, Walmart, Target, Best Buy, eBay, and any other e-commerce site. It supports both desktop and mobile views.

HOW TO USE

After installation, the settings panel appears on the left side of the screen with the gear emoji (⚙️). Open the panel to configure the script:

- The "Show review summary badge" toggle enables or disables the badge.

- Toggle "Show sentiment label on badge" to display a sentiment label (Excellent/Good/Poor) next to the rating.

- Click "Refresh badge" to manually re-scan the page for review data.

The badge appears automatically on product pages. It shows the rating, stars, review count, and optional sentiment label.

TECHNICAL SECTION — REAL MECHANISM

The script detects product pages by scanning for common e-commerce elements like .average-rating, .rating-value, .star-rating, .product-rating, .review-count, and .ratings-count. It extracts the average rating by looking for text patterns like "4.5 out of 5" or standalone numbers between 0 and 5. It uses multiple selectors to handle different site layouts: .a-icon-alt for Amazon, .review-number for general sites, [itemprop="ratingValue"] for schema.org markup, and aria-label attributes with "star" in the label. The review count is extracted using selectors like .review-count, .ratings-count, .total-reviews, and [itemprop="reviewCount"]. The star display is generated by calculating the number of full stars, half stars, and empty stars from the rating. The sentiment is determined by the rating threshold: 4.5+ is "Excellent," 3.5-4.5 is "Good," and below 3.5 is "Poor." The badge is inserted near the product title or price using DOM insertion. A MutationObserver watches for DOM changes and updates the badge when the page updates.

THE PANEL

The settings panel is built with BotGentz's BGPanel component. It is draggable via its header, allowing you to reposition it anywhere on the screen. The panel snaps to the left edge by default but can be moved freely. Click the gear emoji to collapse the panel into a small bubble, and click the bubble to expand it again. The panel remembers its position per page session. Press the Escape key to quickly close or minimize the panel. The panel includes a status flash bar that provides visual feedback when settings are changed or actions are performed. All settings save automatically via GM_setValue.

PLEASE NOTE

This script requires the free BotGentz browser extension to run. It does not function as a standalone Chrome extension and does not use chrome.* APIs. The script works on most e-commerce sites, but some sites may use non-standard HTML structures that prevent automatic extraction. The badge only shows the overall rating and count—it does not analyze individual review text. The sentiment label is a simple categorization based on the rating number. The script stores only your preferences via GM_setValue. No data is sent externally—all data is stored locally in your browser. The script never reads or writes password fields, hidden inputs, or file inputs. All DOM operations use safe methods (style properties, textContent, appendChild) and never use innerHTML.