This article documents the code changes needed to add the Feefo Places Plugin into the merchant's web page.

To integrate the Feefo Places Plugin into a website, add the following code snippet to the relevant web pages. Note that if a 'Display=Inline’ is defined in the above preferences, the plugin position will be determined by where the element referring to the plugin is located in the web page. If a 'Display=Fixed’ is chosen, the position will be determined by the options 'Position' and 'Offset'.

  1. The first step is to include the plugin into the web page:
    <!-- Include the Feefo Places Plugin -->
    <script type='text/javascript' src='https://api.feefo.com/api/assets/js-places-integration/feefo-js-places-integration.js'></script>
    

  2. The second step is to add a page element to anchor the plugin to:
    <!-- Include the Feefo Places Plugin -->
    <div id="FPI_Destination"></div>

  3. The last step is to configure the plugin. This code must be added just before the closing </body> tag of your webpage:
    <!-- Initialise the Plugin -->
    <script type='text/javascript'>
    
    // Configure the plugin
    var feefo = new Feefo.PlacesIntegration({
    
    // Outputs debug logs
    debug: true,
    	
    // Where to place the plugin
    destination: document.getElementById('FPI_Destination'),
    
    // Merchant identifier
    merchantIdentifier: 'example-retail-merchant',
    });
    
    // Show the plugin
    feefo.init();
    
    // Close the script
    </script>
    


    Where:

    • debug = option to display the plugin debug logs in the browsers console. Values can be true (display debug logs) or false (do not display debug logs).
    • destination = this is a Document Object Model (DOM) reference to an element in the merchant website where the plugin will be inserted. In the above example, replace FPI Destination with the correct element id.
    • merchantIdentifier = the merchant’s unique Feefo identifier. This is used to fetch the merchant’s preferences for the Feefo Places Plugin. In the example above, replace example-retail-merchant with the correct merchant identifier.
    • feefo.init() = the call that render’s the plugin on the merchant website. If not included, the plugin will be hidden. For example, the plugin can be hidden until $(document).ready() or after a certain action has been performed.
Setting Up Feefo Places