Docs    Facebook

How to use the Reviews extension to display Facebook page reviews or recommendations

Plugin Version 4.0 and above

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.

If you have the Smash license or All Access Bundle which include all our Facebook feed extensions, after installing and activating the Custom Facebook Feed Extensions plugin, you’ll also need to go to WordPress Dashboard > Facebook Feed > Extensions and activate the individual extensions that you would like to use:

2) Under Facebook Feed > All Feeds you can choose to create a new Feed. When selecting the Feed Type, select Reviews.

3) Add a new source, or select one you have previously added. The Source Access Token used for the Reviews Feed is the same as your normal Page Source if you have already added one.

4) Using the </> Embed button, get the correct shortcode and add it to your page where you want to display the Reviews feed.

Change an existing feed

If you want to change an existing feed to instead display reviews, go to Facebook Feed > All Feeds > Select edit for the relevant page > Settings > Feed Type > click Change, select Reviews, and Save. The Feed will now be updated in the location where you have previously added the shortcode.

Customization

Once the extension is installed, you can edit the Reviews feed to change which type of reviews you want to display. To do this edit the feed you want to adjust, and go to Settings > Filters. Here, you will be able to toggle the following settings:

  • Show only reviews with a rating
  • Hide negative recommendations
  • Hide reviews with no text

Different Filtering options for reviews

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 or use an HTML or Code Block, so that it is rendered as HTML.

Below Plugin Version 4.0

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:
    Comments Box SVG iconsUsed for the like, share, comment, and reaction icons

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

support

Couldn’t find your answer in the docs?

Contact Support

Was this article helpful?