The FacetWP Star Rating Add-On is a specialized extension for the FacetWP plugin. Its primary purpose is to allow users to filter WordPress content (posts, products, etc.) based on an average star rating (e.g., “4 stars and up”).
Unlike many rating plugins, this add-on is primarily a filtering tool, not a voting system, though some integrations allow for both.
This is EXACTLY the same product as distributed by the developer. Sales Page
Filtering Logic: Uses “Greater than or equal to” logic. Selecting 4 stars will show results with an average rating of 4, 4.5, or 5.
Data Compatibility: * WooCommerce: Native support for the standard WooCommerce average rating field.
Custom Fields: Can pull data from any numeric custom field (e.g., ACF, Meta Box, or Pods) containing a value between 1 and 5.
Dynamic UI (AJAX): Filters update instantly without a page refresh, as with all FacetWP facets.
Customizable Icons: * Built-in support for Stars, Star Outlines, and Hearts.
Supports custom SVG icons and FontAwesome icons via developer hooks.
Ghost Ratings: Features a “Ghost” mode which allows you to show five empty stars even if a particular rating level has zero matching results, maintaining a consistent UI.
To use this add-on, your WordPress environment generally needs to meet the following:
FacetWP Core: You must have the main FacetWP plugin installed (this is a premium plugin).
PHP Version: $PHP \geq 7.4$ (though $8.1+$ is recommended for modern WordPress builds).
WordPress Version: $WP \geq 5.8+$.
Data Input: You must have a numeric value ($1$ to $5$) stored in your database for the facet to index.
Create the Facet: Go to Settings > FacetWP > Facets and add a new facet.
Select Type: Choose Star Rating from the dropdown.
Choose Data Source: Select Average Rating (for WooCommerce) or a custom numeric field.
Display: Use the generated shortcode [facetwp facet="your_facet_name"] in your page builder (Elementor, Bricks, Gutenberg) or theme template.
Re-index: Click the Re-index button in FacetWP settings so the plugin can map your rating data.
The add-on provides several CSS-based styling hooks. You can customize:
Base Color: The color of the stars in their inactive/unselected state.
Selected Color: The color when a user selects a specific rating.
Hover Color: Feedback color when a user’s mouse is over the stars.
