Freemius

designplug

<p>ReviewStars displays a Google Places star rating and total review count via a shortcode: <code>[reviewstars]</code>.</p>
<p>It is built as a design tool: you can style the output in the admin and use Preview Mode to design without an API key or Place ID, which is useful for staging sites, page builders, and client approval.</p>
<h3>Free build features</h3>
<ul>
<li>Shortcode: <code>[reviewstars]</code></li>
<li>Google Places rating and review count using your own API key</li>
<li>Caching via WordPress transients</li>
<li>Configurable front-end auto-refresh</li>
<li>Preview Mode with custom preview rating and review count</li>
<li>On-click behavior: open your Google listing or “Write a review”</li>
<li>Optional language parameter for the Google Places API</li>
<li>Style controls for spacing, typography, review count background, Google icon placement, and separators</li>
</ul>
<p>The WordPress.org build includes only the free functionality listed here. Additional paid functionality is delivered in a separate plugin package outside WordPress.org and is not included in this package.</p>
<h4>Style editor</h4>
<p>Control spacing, typography and icon placement without custom CSS:</p>
<ul>
<li>Toggle: show/hide review count and review text</li>
<li>Stars font size</li>
<li>Review text font size and font weight</li>
<li>Optional review text color</li>
<li>Number spacing: padding, margin, and vertical adjustment</li>
<li>Number typography: font size, font weight, and optional color</li>
<li>Optional number background: solid or gradient background, padding, radius, and border width</li>
<li>Google icon: show/hide, position, gap, icon size, and separator styling</li>
</ul>
<h3>External Services</h3>
<p>This plugin connects to the following third-party services:</p>
<p>1) <strong>Google Places API (Google Maps Platform)</strong><br />
Used to retrieve the rating and review count for the configured Place ID. Requests are made when the shortcode is rendered, when the admin “Test API settings” button is used, and when live refresh is enabled.<br />
Service: https://developers.google.com/maps/documentation/places/web-service/overview<br />
Terms: https://cloud.google.com/maps-platform/terms<br />
Privacy: https://policies.google.com/privacy</p>
<p>2) <strong>Freemius SDK (optional)</strong><br />
The plugin bundles the Freemius SDK for optional account, opt-in, and commercial upgrade flows. The free plugin functionality works without opting in to Freemius. If you opt in or use Freemius account features, data may be processed by Freemius according to their policies.<br />
Privacy: https://freemius.com/privacy/<br />
Terms: https://freemius.com/terms/</p>
<h3>Shortcodes</h3>
<pre><code>[reviewstars]
</code></pre>
<p>Optional attributes:</p>
<ul>
<li><code>refresh_ms="300000"</code> – override refresh interval in milliseconds</li>
<li><code>preview="1"</code> – force preview output without API calls</li>
<li><code>rating="4.8"</code> – preview rating</li>
<li><code>reviews="1250"</code> – preview review count</li>
</ul>


ReviewStars

Displays a modern Google Places rating badge with style controls, caching, auto refresh, and optional preview mode.

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.

ReviewStars vs Five-Star Ratings Shortcode