Overview

The Reviews extension allows you to display reviews from your Facebook Page on your WordPress site. Please note, you can only display reviews from a Facebook page that you are an admin of.

Below is an example of using the Reviews extension to display Facebook Page reviews.

Facebook reviews WordPress plugin

Shortcode used above:

[custom-facebook-feed type=reviews]

See the How to use tab above for directions on how to use the extension.

How to use

Setup

  1. Upload and install the extension plugin zip file. Extensions are installed just like any other WordPress plugin. You can follow the same process used when uploading and installing the Custom Facebook Feed Pro plugin.
  2. Obtain an Access Token by clicking the “Log in and get my Access Token” button on the plugin’s Settings page and then after approving the plugin, select the Facebook page that you wish to display reviews from.
  3. Once you have your Access Token then copy and paste it into the “Reviews Access Token” field which is added to the plugin’s Settings page.
  4. To display reviews simply set the Post Type to be “reviews”, as shown in the following shortcode:
    [custom-facebook-feed type=reviews]

Customization

Once the extension is installed, some customization settings will be added to the following location:

Facebook Feed > Customize > General > Reviews

You can choose to display only reviews which have received a specific rating, change the size of the star icons, and edit the “View all Reviews” text.

General review post customization

If you want to customize the general parts of the review posts (eg: background colors, text, links, etc) then you can do so by using the “Post Style” settings on the plugin’s “Customize” settings page.

Displaying your total Facebook Page rating

Unfortunately, Facebook’s API doesn’t include the total star rating for your page, however, you can manually display this on your page by adding the following to your page above the shortcode:

5.0 <i class="fa fa-star"></i><i class="fa fa-star"></i><i class="fa fa-star"></i><i class="fa fa-star"></i><i class="fa fa-star"></i>

This will display a 5 star total rating. You can change the number of stars by editing the code. Be sure to copy and paste it into the “Text” tab of the page editor so that it’s rendered as HTML.

Shortcode

The table below shows the available shortcode options for the Reviews extension:

Shortcode Options

Name Attribute Options Description Example
Display reviews type reviews Display reviews in your feed type=reviews
Show reviews rated reviewsrated 1-5 Show reviews with these ratings reviewsrated="4,5"
Hide negative reviews hidenegative true
false
Hides any negative recommendations hidenegative=true
Star icon size starsize Any number The size of the star icons starsize=18
“View all Reviews” text reviewslinktext Any text The text to use for the link reviewslinktext="See all"
Hide reviews with no text reviewshidenotext true
false
Choose whether to hide reviews with no text in them reviewshidenotext=true
API retrieval method reviewsmethod auto
batch
all
Most users should leave this set as “Auto” and only change it if directed by a member of the support team. reviewsmethod=batch
Page Access Token pagetoken The Access Token for the Facebook page you want to display reviews from. Note: this shortcode option only needs to be used if displaying multiple review feeds from different Facebook pages, otherwise you can set it on the main plugin Settings page. pagetoken=xxxxx

 

Change Log

= 1.1.1 =
* Fix: Fixed an issue with avatars of review authors sometimes not displaying

= 1.1 =
* New: Added a setting to hide negative recommendations
* New: Now supports the “Boxed” post style and “Box Shadow” setting added in v3.7 of the Custom Facebook Feed Pro plugin

= 1.0.5 =
* New: Supports recommendations
* Fix: Now displays the avatars of people leaving reviews
* Tweak: Replaced link to the reviewers profile with link to the reviews page instead

= 1.0.4 =
* New: Added the ability to filter reviews by word/phrase. Just use the `filter` and `exfilter` shortcode settings.
* Tweak: Increased size of Reviews Access Token field so entire token is visible
* Fix: Updated directions in the tooltip on how to get a Reviews Access Token
* Fix: Removed broken image if avatar not available

= 1.0.3 =
* Fix: The wrong number of posts would sometimes be displayed when only showing reviews with certain star ratings or when choosing to only show reviews that contain text
* Fix: The `offset` shortcode option wasn’t working correctly with reviews
* Fix: Fixed an issue where the text length setting wouldn’t be applied to the review text
* Tweak: Updated the plugin updater script to reduce requests on the WordPress Plugins page

= 1.0.2 =
* New: Added a setting that allows you to hide reviews that don’t include any text

= 1.0.1 =
* Fix: Fixed an issue where line breaks in the review text was being converted to HTML line break tags
* Fix: Fixed an issue where 1 star checkbox on the settings page wouldn’t stay enabled

= 1.0 =
* Launched the Reviews extension