TABLE OF CONTENTS
Introduction
The following steps apply to recent versions of Adobe/Magento Commerce. If you are using a legacy version of Magento, your process may differ.
Note, assistance of the Feefo support team is necessary for configuring a data source. Please use live chat or contact support@feefo.com
How to apply the Feefo integration
- Apply a review code snippet to your main theme.
- Apply a Feefo product reviews code snippet to your product theme.
- Create an access token to connect a data source to pull all sale information marked as complete and updated within the last day into Feefo to create review requests.
- This access token has full permissions and does not expire. Both methods can be installed manually on development and live domains, providing an integration that is not reliant on the plugin and not affected by an outdated version.
Multi-store setup
To generate a data source to collect order information, Feefo require the store domain, access token, and store Id of the store(s) where order collection for the generation of feedback request emails are wanted.
Generating Feedback Requests
To generate feedback request emails by connecting your Magento instance to Feefo to upload sale information, you need an Access Token. Here’s how to create it:
Steps to Create an Access Token
- In Magento, using the navigation bar on the left, select System > Extensions > Integrations.
- Choose Add New Integration.
- Enter Integration Info:
- Name: Feefo
- Password: Use the password you use to log into Magento.
- No other fields are required by default.
- Under the API tab, change the dropdown for Resource Access to Custom and manually select all tick-boxes (choosing ALL will no longer work).
- Save the integration.
- Activate and Allow if authorisation is required.
- Copy the Access Token and send it to Feefo in plain text.
Token Expiration Settings
Ensure your Access Tokens do not expire after 4 hours:
- Go to Stores.
- Click Configuration.
- Then go to Services.
- Select Oauth.
- Choose Access Token Expiration.
- Amend the expiration to 0 (zero) to remove it altogether.
For Magento 2.4.4 or later, ensure the setting Allow OAuth Access Tokens to be used as standalone Bearer tokens is enabled
- Go to Stores.
- Click Configuration.
- Then go to Services.
- Select Oauth.
- Choose Consumer Settings.
- Amend the expiration to 0 (zero) to remove it altogether.
If using a multi-store instance, retrieve your numerical store IDs from Stores > All Stores.
If a firewall is configured, whitelist Feefo's IP range or set up a PTR for services.feefo.com:
- 35.197.217.47
- 35.197.212.84
- 35.242.181.73
- 34.105.171.51
- 34.89.34.212
Provide the following details to Feefo:
-
-
Magento admin domain
-
Access token
-
Admin email address (used to create the access token)
-
Numerical store ID
-
Preferred upload frequency (default is daily)
-
Feefo Review Integration Widgets
The integration of Feefo review widgets depends on the level of customisation and access to your website. You will need admin-level access to Adobe/Magento Commerce and knowledge of injecting code snippets.
Slide-out Reviews Tab
The Feefo API request and Slide-out Reviews Tab use the following code snippet. Replace MERCHANTID with your unique Feefo merchant identifier.
<script type="text/javascript" src="https://api.feefo.com/api/javascript/MERCHANTID"></script>
<div id="feefo-service-review-floating-widgetId"></div>
To add the Slide-out Reviews Tab through Adobe/Magento Commerce:
-
Navigate to Content > Design > Configuration.
-
Locate your Website or Default Store View and click Edit under the Action column.
-
Under Other Settings, find the HTML Head section.
-
Insert the above code snippet (with your MERCHANTID) in the Scripts and Style Sheets section.
-
Click Save Configuration.
On-page Product Reviews and Product Stars
Feefo provides widgets for displaying Product Stars and On-page Product Reviews.
Product Stars Snippet
This snippet should be placed near the Add to Cart button.
<div class="feefo-review-badge-wrapper-product"></div>
On-page Product Reviews Snippet
For child (basic) products, place this code under the product description:
<div id="feefo-product-review-widgetId" class="feefo-review-widget-product" data-product-sku=""></div>
For parent (grouped) products, use the following code:
<div id="feefo-product-review-widgetId" class="feefo-review-widget-product" data-parent-product-sku=""></div>
Note: The SKU variable may differ based on your Magento setup.