Plugin Version 4.0 and above 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: 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: 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.Setup
Displaying your total Facebook Page rating
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>
Below Plugin Version 4.0
Setup
- 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.
- 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.
- 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.
- To display reviews simply set the Post Type to be “reviews”, as shown in the following shortcode:
Load more
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 |
