Freemius

Chris J. Zähller

<p>Add accessible, attractive 5-star ratings anywhere on your site with a simple shortcode. The plugin uses Font Awesome icons via their SVG + JavaScript method.</p>
<h3>Acknowledgement</h3>
<p>This plugin is based on <a href="https://github.com/hlashbrooke/WordPress-Plugin-Template" rel="nofollow ugc">Hugh Lashbrooke’s Starter Plugin</a>, a robust and GPL-licensed code template for creating a standards-compliant WordPress plugin.</p>
<h3>PRO only features</h3>
<ul>
<li>Google Rich Snippets for Products, Restaurants, & Recipes</li>
<li>Custom icon sizes</li>
<li>Custom icon and text colors</li>
<li>Choice of HTML <code><i></code> or <code><span></code> elements in HTML output</li>
<li>Change maximum rating (from 3 – 10)</li>
<li>Change minimum rating (0.0, 0.5, or 1.0)</li>
<li>Shortcode generator</li>
<li>Show/hide numeric text</li>
<li>Locale aware decimal separator</li>
<li>Options reset button</li>
</ul>
<h3>Usage Examples</h3>
<p>[rating stars="3.0"] (Displays 3 stars out of 5)<br />
[rating stars="2.5"] (Displays 2½ stars out of 5)<br />
[rating stars="4.0"] (Displays 4 stars out of 5)<br />
[rating stars="5.5"] (Incorrect usage but will display 5 stars out of 5)</p>
<p>In the 2nd example, the raw output will be like this before processing:</p>
<pre><code><span class="fsrs">
  <span class="fsrs-stars">
    <i class="fsrs-fas fa-fw fa-star"></i>
    <i class="fsrs-fas fa-fw fa-star"></i>
    <i class="fsrs-fas fa-fw fa-star-half-alt"></i>
    <i class="fsrs-far fa-fw fa-star"></i>
    <i class="fsrs-far fa-fw fa-star"></i>
  </span>
  <span class="hide fsrs-text fsrs-text__hidden" aria-hidden="false">2.5 out of 5</span>
  <span class="lining fsrs-text fsrs-text__visible" aria-hidden="true">2.5</span>
</span><h3>Translations</h3>
</code></pre>
<p>* English: Default language, always included</p>
<p>Would you like to help translate Five-Star Ratings Shortcode into your own language? <a href="https://translate.wordpress.org/projects/wp-plugins/five-star-ratings-shortcode" rel="nofollow ugc">You can do that here!</a></p>
<h3>Dependencies</h3>
<p>This plugin includes these third-party libraries in its package.</p>
<ul>
<li><a href="https://github.com/FortAwesome/Font-Awesome" rel="nofollow ugc">Font Awesome 5</a></li>
</ul>


Five-Star Ratings Shortcode

Simple lightweight shortcode to add 5-star ratings anywhere.

JS Morisset

<p></p>
<p><strong>Includes a 5 Star Rating in Schema markup:</strong></p>
<ol>
<li>If the Schema markup does not have an ‘aggregateRating’ property.</li>
<li>If Google allows an ‘aggregateRating’ property for that Schema type.</li>
</ol>
<p>Google allows an ‘aggregateRating’ property for these Schema types and their sub-types:</p>
<ul>
<li>Book</li>
<li>Course</li>
<li>Event</li>
<li>HowTo (includes Recipe)</li>
<li>LocalBusiness</li>
<li>Movie</li>
<li>Product</li>
<li>SoftwareApplication</li>
</ul>
<p>If the Schema type in the Document SSO metabox is not one of these types (or one of their sub-types), then a 5 star rating cannot be added, as doing so would trigger an error in the Google search console. <a href="https://developers.google.com/search/docs/advanced/structured-data/review-snippet" rel="nofollow ugc">See Google’s Review snippet documentation for additional information.</a></p>
<p></p>
<h3>WPSSO Add Five Stars is a Fallback Solution</h3>
<p>The Google’s Review Snippet technical guidelines reminds us to:</p>
<blockquote>
<p><a href="https://developers.google.com/search/docs/advanced/structured-data/review-snippet#technical-guidelines" rel="nofollow ugc">Make sure the reviews and ratings you mark up are readily available to users from the marked-up page. It must be immediately obvious to users that the page has review content.</a></p>
</blockquote>
<p>The WPSSO Add Five Stars add-on includes a 5 star rating <em>if the document Schema markup does not already have an ‘aggregateRating’ property</em>. It is always preferable to include actual ratings and reviews from your visitors and/or customers in the webpage. The WPSSO Add Five Stars add-on can be used in combination with any of the following third-party plugins and service APIs, or the <a href="https://wordpress.org/plugins/wpsso-ratings-and-reviews/" rel="ugc">WPSSO Ratings and Reviews</a> add-on.</p>
<p><strong>Suggested Rating and Review Plugins and Services:</strong></p>
<p>The <a href="https://wordpress.org/plugins/wpsso/" rel="ugc">WPSSO Core plugin</a> supports a selection of plugins that provide ratings and reviews:</p>
<ul>
<li>WP-PostRatings</li>
<li>WP Product Review</li>
<li>Yotpo Social Reviews for WooCommerce</li>
<li>WooCommerce</li>
<li><a href="https://wordpress.org/plugins/wpsso-ratings-and-reviews/" rel="ugc">WPSSO Ratings and Reviews</a></li>
</ul>
<p>The <a href="https://wpsso.com/" rel="nofollow ugc">WPSSO Core Premium plugin</a> also supports a selection of remote service APIs that provide ratings and reviews:</p>
<ul>
<li>Judge.me (Ratings and Reviews)</li>
<li>Shopper Approved (Ratings and Reviews)</li>
<li>Stamped.io (Ratings and Reviews)</li>
</ul>
<h3>WPSSO Core Required</h3>
<p>WPSSO Add Five Stars is an add-on for the <a href="https://wordpress.org/plugins/wpsso/" rel="ugc">WPSSO Core plugin</a>, which creates extensive and complete structured data to present your content at its best for social sites and search results – no matter how URLs are shared, reshared, messaged, posted, embedded, or crawled.</p>

WPSSO Add Five Stars for Google Rich Snippets

Add a 5 star rating and review from the site organization if the Schema markup does not already have an 'aggregateRating' property.

Five-Star Ratings Shortcode vs WPSSO Add Five Stars for Google Rich Snippets