Plugin Documentation

Welcome to the plugin

Business Reviews Bundle is a first WordPress plugin with ability to merge business reviews from several Google, Facebook or Yelp places between each other and show a summary rating. It is also an easy and fast way to integrate business reviews right into your WordPress website through Widgets or Shortcodes.

Please see Introduction Video to understand how it works. Also you can find most common answers and solutions for most common questions and issues in next tabs.

Common Questions

Is that a one time or annual fee?

The new Business Reviews Bundle plugin has an annual subscription payment model and as long as the subscription is available, a license for priority support and auto updates will also be valid.

I can't download the plugin, there's a folder, not a zip file.

Most likely you downloaded the plugin from Safari browser and it automatically unpacked to the folder. Unfortunately, Safari has this sometimes unusable feature for the archive files. Just pack this folder back to the file (/business-reviews-bundle/ -> /business-reviews-bundle.zip) and upload zip in wp-admin.

If I cancel my subscription, will the license be vaild?

The subscription is used only for license, in order for it to be automatically renewed and the plugin always has the latest update. If you cancel the subscription, the license will also canceled. However, if you still want to cancel the subscription, you can do this a few days before the subscription is renewed so that the license is active for a year.

Do you offer refunds?

Sure! Here’s the simplest way to describe our 'Refund Policy': if you’re not happy, request a refund within 30 days of purchase and we’ll refund your purchase without any questions.

Can I continue to use the plugin if my subscription past due?

Yes, sure the plugin will continue to work. However, the license for priority support and plugin's auto updates expired and you will not get updates or support.

Is the plugin compatible with the latest version of PHP? I saw warnings about the compatibility with PHP 7 in the checker plugin.

Yes, the plugin is absolutely compatible with PHP 7 and by the way, we are using PHP 7 on the demo site.

The warnings come from the code which is needed for compatible with old versions of PHP (< 5.0) which is sometimes found in some users and without this code, the plugin will not work.

The problem is that the plugin which you’re using to test compatibility with PHP 7 cannot understand that this code is not used under PHP 7 or greater. The compatibility plugin just search some keywords which deprecated in the latest version PHP and show warnings about it (without understanding that this is not used).

Rich Snippets

Google does not guarantee that your structured data will show up

Google does not guarantee that your structured data will show up in search results even if structured data is marked up and can be extracted successfully according to the testing tool. Link to Google source.

We recommend to enable Rich Snippets for Summary Rating

If you select Summary Rating, please make sure that the option Show Summary Rating is enabled in the Header Options panel at Collection Builder.

Rich Snippets will not if the collection shows only reviews

Rich Snippets will not added without at least one business header (if only reviews are shown) and following mandatory fields: image, name, reviews count.

Rich Snippets is not for homepage

Google does not index Rich Snippets on homepages, it is a limitation of Google, not specifically the plugin.

We recommend to enable Rich Snippets for one page

Don not place a widget or shortcode with enable Rich Snippets option on the each page of the site because in this case Google might consider a schema markup as duplicate content. Just select a single page (except a homepage) and place such shortcode there.

Test before going live

Test the page in the Google Structured Data Testing Tool before published.

Google Platform

I can't connect my Google Place.

Please check that you correctly found the Place ID of your Google business. It should look like ChIJ3TH9CwFZwokRI... This instruction helps to find any Place ID regardless of whether it has a physical address or it is an area: how to find Place ID of any Google business.

I have some error messages about the Google API key.

Please make sure that your correctly created the Google Places API key with Places API library and without any restrictions (IP or Referrer). It should look like AIzaSyB3k4oWDJPF... Here is detailed instruction: how to create Google API key.

Why I see only 5 reviews even in this Business version?

The plugin uses the Google Places API to get your reviews. The API only returns the 5 most helpful reviews. When Google changes the 5 current most helpful the plugin will automatically add the new one to your database. Thus slowly building up a database of reviews. Unfortunately, it is a limitation of Google, not specifically the plugin.

I got new reviews, but these do not show in the plugin.

The plugin can only download what Google returns in their Places API. It is usually the 5 Most Helpful (not newest) reviews. You can check what the API returns by entering your Google Place ID and API key in this url:

https://maps.googleapis.com/maps/api/place/details/json?placeid=YOUR_PLACE_ID&key=YOUR_GOOGLE_API_KEY

I chose Most Recent sorting, but see the same reviews.

The Google Places API which used in the plugin does not pass a sort parameter and instantly return 5 most helpful (not recent) reviews. The sorting feature in the plugin sorts these 5 (or more when it will be available) reviews by recent or other sort methods.

Why I see 5 reviews count in the based section?

The Google Places API which used in the plugin does not return information about the total number of reviews and the plugin can't get this value. However, the plugin has a special option for Google places Total number of reviews and you can type the total count manually.
Google reviews count

How to create Google Places API key

1. Go to your Google Console

2. Click 'Create Project' or 'Select Project' button

3. Create new project or select existing

4. On the project page click 'ENABLE APIS AND SERVICES'

5. Type 'Places API' in the search area

6. Select the first result 'Places API' and click 'ENABLE' button

7. On the 'Places API' page select 'Credential' tab and 'Create credential' / 'API key' option

8. Copy created API key, paste to this setting and save

Video instruction

Facebook Platform

How many reviews the plugin shows?

The plugin uses a Facebook Graph API to show your reviews and there is no limitation on the number of reviews, as in Google or Yelp. The plugin shows all Facebook reviews.

I can't connect my Facebook Page.

Please check:

  • Your Facebook account has an admin right for the page;
  • Your browser supports(has enabled) Cookies for external websites;
  • Your Facebook page is public and visible for all countries.

When I connect Facebook, the popup closed and there's needed FB page(s)

Try to remove our integration WidgetPack from Facebook integration list https://facebook.com/settings?tab=business_tools and then re-connect Facebook page(s). You should see the popup where you need to allow all permission requests.

I have error message: Error validating access token: The session has been invalidated...

The plugin uses a Facebook Graph API to show your reviews and if connected FB account changed the password or invalidate the session, such error message will appear. Please re-connect your Facebook page(s) in the Collection Builder again.

Yelp platform

How I can connect my Yelp business?

You just need to find your business page on Yelp, for instance https://yelp.com/biz/benjamin-steakhouse-new-york-2 and copy & paste this link to the Link to Business field and connect.

I can't connect my business.

Please check that your business has at least one review for use in the plugin, if so, check the Yelp API key that it is correctly fetched by instruction: how to create Yelp API key.

Why I see only 3 reviews even in this Business version?

The plugin uses the Yelp API to get your reviews. The API only returns the 3 most helpful reviews. When Yelp changes the 3 current most helpful the plugin will automatically add the new one to your database. Thus slowly building up a database of reviews. Unfortunately, it is a limitation of Yelp, not specifically the plugin.

How to create Yelp API key

1. If you do not have a free Yelp account (not a business), please Sign Up Here

2. Under the free Yelp account, go to the Yelp developers page and create new app

3. Copy API Key to this setting and Save

Video instruction

Request to Support

If you need support

You can contact us directly by email support@richplugins.com and would be great and save us a lot of time if each request to the support will contain the following data:

  • 1. Clear and understandable description of the issue;
  • 2. Direct links to your reviews on: Google map, Facebook or Yelp;
  • 3. Link to the page of your site where the plugin installed;
  • 4. Better if you attach a screenshot(s) (or screencast) how you determine the issue;
  • 5. The most important: please always copy & paste the Debug Information from the settings page of the plugin (Advance tab) to your initial request.