Woocommerce - Connector documentation

Woocommerce is a plugin for the Wordpress CMS that allows you to integrate an e-commerce solution into the CMS. Our Verified Reviews connector for Woocommerce is available for download on our website or on the marketplace.

Once the connector is installed and configured, everything is automatic, and Verified Reviews communicates directly with your e-commerce solution.

• Automatic retrieval of orders and review requests: The connector sends us your latest orders directly. Our platform then retrieves the orders for which we need to send review requests, based on the settings configured during the setup described later in this document.
• Display of product reviews on your site: The connector allows you to display your product reviews collected on our platform directly on your product pages.
• Display of the Verified Reviews rating widget: You can display a floating widget on your site. This widget shows your average overall Verified Reviews rating to your visitors, reassuring potential customers about the quality of your services.

Connector installation and configuration

Downloading the connector archive

The connector is available for download from:

WooCommerce module configuration

To configure the module in the WooCommerce environment, please go to the 'Verified Reviews' menu via the site's admin interface.

Configuration Section

Configuration WPML

In the case of multilingual sites, our connector is compatible with the WPML plugin.

The default multilingual configuration follows the following behavior:

• Each platform retrieves orders in the language that corresponds to it, allowing you to send request emails in the language of your customer (e.g., on the ES site, the order will be retrieved from the platform http://opiniones-verificadas.com) and to collect reviews in the languages of the pages.
• The FR product pages will then display the reviews collected on http://avis-verifies.com, the ES pages will display those from http://opiniones-verificadas.com, and so on for each language.

Example :

Google Shopping Configuration

To allow Verified Reviews to retrieve additional data about your products (necessary for sending the product review feed to Google Shopping):

• Please go to the WordPress back office in the "Verified Reviews" menu.
• In the "Configuration" section you will find the following three fields: Brand, MPN and GTIN.
• Please select from the list the corresponding attribute.

Click on « Save ».

If you don't have the possibility to assign attributes, it means you first have to create them in your back office. To do that, go to the Products > Attributes section:

Create each necessary attribute next:

The created attributes are displayed in an adjacent list.

The created attributes will be displayed in an adjacent list: Then go back to the module configuration page. You should see the list of attributes created when you click on the selection fields.

Select the attribute corresponding to each information: MPN, GTIN, Brand and then click on "Save".

In order for us to retrieve this information automatically when we retrieve orders from your customers, it is necessary for each product sheet to have this information fully completed.

Design Section

« Export manual » Section

Automatic order retrieval only retrieves orders created after the module installation. All orders placed prior to installation, regardless of any subsequent status changes, are considered “not to be retrieved”.

We offer a tool, however, to be able to make a first manual export of orders that will allow you to generate your first reviews quickly by polling the customers of your orders already placed. This tool will allow you to download a CSV file containing the orders and upload it directly to our platform.

Go to the "Verified Reviews" tab in your back office to access the orders export.

Retrieving the configuration

This step will allow us to retrieve the configuration of your Wordpress site in order to set up our module according to it.

• Click "Save Website config" to check the connection between Verified Reviews and Wordpress.
• If a "success" message appears and green checkmarks appear in the right section "Module Status", the module is correctly configured. If another message appears, check the previous configurations and if the problem persists, contact Verified Reviews support by going to: "Config> Access Support".

Automatic order retrieval

In order to be able to send review requests to your customers, you must configure the "Automatic Order Retrieval" section.

• Activate automation: if 'yes', our engine will come each night to retrieve the orders for which we must survey customers. This is the main condition to start collection of your orders.
• When should we ask for your customers' feedback :
  • When creating the order by selecting "At the Order": in this case ALL orders will be retrieved (including canceled, refunded orders etc.)
  • By clicking on "Change Order Status" you can set a specific order status (or multiple) . If you choose this option, you must select the status(es) from the list of available statuses.

Review Collection 

This step will allow you to configure the review requests. So all you need to do is fill out the form following the instructions. If you have any problems, hover over the "?" to get help.

• Delay before review request is sent: Choose how much time after the chosen event above that the request for review will be sent by Verified Reviews to your customer. This corresponds to the number of days between the moment the order is retrieved by our services and the sending of the review request.
• Email extensions: by default allows you not to sent request to customers of marketplaces. We have already added default extensions (the extension is what comes after the @). You can add more to the end, separated by a semicolon ';'.
• Retrieve reviews on your products: Check "yes" to retrieve product reviews.
• Show product reviews: Check "yes" if you want to show the reviews collected on your product pages.

Configuring rich snippets 

This section concerns Rich Snippets (or enriched snippets) which allow for more information to be provided to search engines, thus improving your SEO. Rich Snippets are structured data that will indicate to search engines that your product has reviews and allow them to know the number of reviews and the average rating.

• If you want to activate product rich snippets: Choose "yes" if you want to add the structured data of your product reviews to your product pages.
• Does your WordPress/WooCommerce theme already include Rich Snippets: Choose "yes" if your product page already includes the Product tag, we will then only integrate the AggregateRating (rating) and Reviews (reviews) tags. If your product page does not include the Product tag, then choose "no", we will integrate all the tags necessary for Google to detect the product.
• What types of snippets do you want: There are two ways to integrate your rich snippet "Microdata" or "JSON-LD". If you already have rich snippets, make sure to use the same format. Generally, the format used in WordPress is JSON-LD.

Widgets display

You can paste the code corresponding to the floating widget you created. For more details, you can check the section “Display of site reviews” of this document.

Click on "Send this configuration". Our platform communicates directly with the module to save this configuration.

You are now automated, you can track review requests sent to your customers from "Stats > Reporting - Review Requests".

First order export

To quickly get your first reviews, the Verified Reviews module integrates an order export function that allows you to generate a properly formatted CSV file that can be directly uploaded via your Verified Reviews acount. The first order export allows you to quickly generate the first reviews by polling customers of your already placed orders.

Go to the back office of your store and go to the "MANUAL EXPORT" section in the connector configuration page.

Options details :

• Since - until : you can retrieve orders up to 12 months (as defined in our Terms of Use).
• Retrieve product reviews: select "Yes" if you want to retrieve product reviews for these orders (essential if you want to survey your products).
• Export orders with status: you can select one or more retrieval statuses.

Once you have retrieved the CSV generated by clicking the "Export" button at the bottom left, you can go directly to the orders download area via the following URL : https://www.avis-verifies.com/index.php?page=mod_upload_commandes.

You must upload the CSV and associate the fields with the columns of the CSV file. Be sure to follow the tutorial and check the information provided before validating the order import.

If you want to retrieve product reviews, the csv id_product column must be associated with the "Product Reference" field. If you do not select the correct column, the collected product reviews will not show up.

Automatic order retrieval

General procedure

We retrieve your orders according to the configuration you set in your Verified Reviews account > Collect reviews > Configure my Woocommerce module. You can track the retrieved orders in your account in Stats > Reporting - Review requests/ Product Reviews / Delayed Product Reviews.

When we also retrieve the product details, the product reference is the product ID (wordpress post ID). If a review is posted about the product, this review will be associated with the product ID in your Verified Reviews account. Then this review will be synchronized to your site and will be displayed on the product page corresponding to this product ID.

Our order retrieval cron runs every 6 hours on your site to check if there are any new orders to retrieve.

Retrieval Hooks

This part of the documentation covers the use of "hooks" and functions of our connector to which they are linked.

In order for our connector to be 100% functional, the following hooks must be present in your theme.

• add_action('woocommerce_thankyou') : This hook is used as the woocommerce_thankyou action to mark orders. It is present in case the woocommerce_thankyou action has not been executed, to avoid missing orders.
• add_action('woocommerce_checkout_order_processed') : This hook is triggered upon confirmation of an order. This allows us to mark the passage of a new order, to retrieve it at a later time according to the configuration previously made, and to trigger the sending of a request for review.

Google Shopping

In order to be able to share your product reviews with Google Shopping, we need the GTIN_EAN (Europe) or GTIN_UPC (US, Canada) which is the most precise data for Google or, if necessary, the brand + MPN pair. It is also necessary to provide brand and MPN even if you have GTINs: the more information we can provide about your products to Google, the easier it will be for Google to associate the reviews with the products.

During automatic order retrieval, we will automatically fetch Google Shopping information as long as it is correctly filled out in the product pages of the WordPress back-office catalog. For more information about the necessary configuration, please refer to the section Configuration.

Display of Website reviews

Updating website widgets

Once you have collected more than three site reviews, you can add our floating widget to your website directly through the module.

Tip: a floating widget will always be visible, regardless of the user's scroll.

• Access your Verified Reviews account and click on My Account. « Display reviews > integrate my widgets ».
• Choose the widget that you prefer, set it as a floating widget then choose the display, the position and the type of opening of the certificate, and finally click on "Create the widget".

You can either combine or separate the widgets, for example a floating widget for Desktop and mobile or one for desktop and a different one for mobile.

A floating widget that will show up on both desktop and mobile.

A floating widget that will show up on desktop

A floating widget that will show up on mobile

• The widget you just created will appear at the top of the page in the "MY WIDGETS" section, click on "Integrate" and copy the code from the first box "Widget code recovery" (unless otherwise stated).

• To add the widget script via the connector, go to the "Integration" section then "Configure my Woocommerce module" and scroll down to the "Widget Display" section.
• Select "Yes" for the question "Do you want to display the floating widget?" and paste the previously copied script into the corresponding box.

If you have created different widgets, e.g. one floating for Desktop and another for mobile, simply copy and paste both scripts one after the other.

To finish, click "Send this configuration".

Check on your site that the widget appears correctly (clear the cache if necessary).

Widgets modification 

To modify an already created widget, go to the "Display reviews> Integrate my widgets > My Widgets" section and make the desired changes to the widget of your choice then click "Update". We have cache on widgets, the changes will not appear immediately on your site.

Integrating the Iframe Widget

Once you have collected more than three website reviews, you can add an iframe to your website that directly displays the website reviews you have collected.

Access your Verified Reviews account and click on "Display reviews > Integrate my widgets" then choose either the "Vertical iFrame Widget" or "Horizontal iFrame Widget" section.

1. Choose the widget you prefer and click on the "Create my Widget" button, then copy the iFrame code and paste it into the location of your site where you want to display it. Unlike the widget, the iframe is not sent in the module configuration.
2. You can customize some features of the iframe with the different options presented under the code, then click the "Update" button.
3. If you want to customize the CSS of the iframe, you can add your CSS rules in the "Custom CSS" block, then click on the "Update" button.

A cache is present on the iframes. It is possible that your customization will not be visible immediately.

Product review display

• On your Verified Reviews account, go to the "Collect reviews" section then "Configure my module".
• In the "Product Options" section, select "Yes" for the following two questions:
  • Do you want to get reviews on your products?
  • Do you want to display product reviews on your product pages?
• Cliquez sur « Envoyer cette configuration».

Note: For any new product review published, there is a 24-hour delay for it to appear on your website.

To check the display of product reviews, go to "Reviews>Product Reviews - Published", choose a review dated more than 24 hours ago and check its display on your website. You can then click on the "small arrow icon" to directly open the product page.

Technical recommandations 

This documentation presents the options available in the latest version of the module. It is always recommended to update your module to benefit from new features/bug fixes and to regularly check the connection with your module on our platform.

Module update

If your module has been customized (overrides, module files modified, etc.), make sure to make a copy of the files before updating and to test the update on a staging site before updating on your main site.

FAQ