Review Count & Star Rating

开发者	shahzaibhassan
更新时间	2026年9月8日 12:25
PHP版本:	7.4 及以上
WordPress版本:	7.1
版权:	GPLv2 or later
版权网址:	版权信息

下载

1.0.0 1.0.1 1.0.2

详情介绍:

If your rating and review count are typed into a dozen pages, they are wrong the moment the count changes. Review Count & Star Rating gives you one place to set them, and every page that uses a shortcode or the block updates together. It works with any review platform. Add as many sources as you like, one per platform or one per branch, and each keeps its own figures. Typing the figures in is a first class way to use this plugin. Most review platforms publish no free way to read a business score automatically, so a plugin that insists on an API simply cannot support them. Here, entering the numbers by hand is the normal path, and automatic syncing is an option on the platforms that offer it. What you get

One screen for every review source on the site.
Shortcodes for the rating, the count, the count rounded down, stars, a full badge, and a link to your review page.
A block for the block editor, and a widget for Elementor.
Combined figures: total reviews and a count weighted average rating across every platform at once, correct even when platforms score out of different maximums.
Part filled stars drawn as shapes, so a 4.3 does not round up to five stars and the display does not depend on which emoji font the visitor has.
Optional automatic syncing from Google, once a day, in the background.

Built so the numbers stay right

Page caches are cleared when the figures change. Without that, a site behind a caching plugin keeps serving yesterday's numbers and looks broken.
A bad fetch cannot wipe your numbers. If a sync comes back with a lower review count or a rating that jumped, the figure is held for you to approve rather than published.
Nothing goes stale in silence. If a source stops syncing, its fetched figures are dropped after a window you choose and the figures you typed take over. Site Health reports how long each source has gone without a sync.
The front end never makes an HTTP request. Figures are read from a single small autoloaded option. Syncing happens on a schedule, never during a page load.
Your API key is not autoloaded. Credentials live in an option that is only read in the admin and on cron, never on a front end request.

Shortcodes Add source="key" to any of these to name a source. Without it, the default source is used.

[rvnum_rating] the rating on its own
[rvnum_count] the exact review count
[rvnum_count_rounded step="25"] the count rounded down, never up
[rvnum_stars] stars, including part filled ones
[rvnum_badge] name, rating, stars and count together
[rvnum_link text="Read our reviews"] a link to your review page
[rvnum_label] the platform name
[rvnum_total] every source added together
[rvnum_average] every source averaged, weighted by review count

WP-CLI wp rvnum list wp rvnum sync wp rvnum sync --source=google wp rvnum set google --rating=4.9 --count=231

安装:

Upload the plugin to /wp-content/plugins/bpers-review-count-and-rating, or install it from the Plugins screen.
Activate it.
Open Review Count & Star Rating in the sidebar.
Enter your rating and review count, and save.
Put a shortcode or the block wherever the figures should appear.

屏幕截图:

升级注意事项:

1.0.2 Sidebar entry shortened to Review Stars and given its own icon. Settings and figures are untouched. 1.0.1 Now called Review Count & Star Rating — look for that in the sidebar. Smaller star markup on the front end. Your settings and figures are untouched. 1.0.0 Initial release.

常见问题:

Do I need a Google API key?

No. Typing the figures in is the default and works for every platform. The API key is only needed if you want a Google source to update itself once a day.

Which platforms can sync automatically?

Google, through the Places API. Every other platform in the list is there for figures you enter yourself, because they either publish no public API for a business's own aggregate score or put one behind a paid plan. The plugin says so on screen rather than offering a setting that cannot work.

I changed the number but the page still shows the old one.

That is a page cache. The plugin clears the caches of the common caching plugins automatically, and you can turn that off under Display and sync. If your cache is somewhere else, such as at your CDN, hook the rvnum_values_changed action to clear it.

My figures stopped updating.

Automatic syncing rides on WP-Cron, which only fires when someone visits the site and is disabled outright on some hosts. Check Tools, then Site Health, where this plugin reports how long each source has gone without a sync. On a server where you can schedule commands, wp rvnum sync is more reliable.

Can I show reviews from several platforms added together?

Yes. [rvnum_total] adds up every source's review count, and [rvnum_average] averages the ratings weighted by how many reviews each has. Platforms scoring out of ten are converted before averaging.

Does this add review schema for search results?

No, deliberately. Google does not show review rich results for a business marking up reviews about itself, and doing it anyway carries a risk of a manual action rather than a benefit. If you want that markup, add it with a dedicated schema plugin and decide knowingly.

Can I add a platform that is not in the list?

Yes, two ways. Pick "Other platform" and set the name and scale yourself, or write a class against Rvnum_Provider_Interface and add it through the rvnum_providers filter.

更新日志:

1.0.2

The sidebar entry is now called Review Stars so it fits on one line.
The sidebar icon is a custom star badge instead of the generic dashicon.
The full name still shows on the plugin page, the settings heading and the block.

1.0.1

Now called Review Count & Star Rating. The sidebar entry, the block and the Elementor widget all carry the new name. No settings, shortcodes or figures are affected.
Star ratings are drawn from one shape referenced ten times instead of ten copies of it, which halves the markup a star row adds to a page. Nothing about how the stars look changes.

1.0.0

Initial release.