Configuring the Shopper Approved Reviews Addon
page last edited on 23 April 2018
To start using the Shopper Approved addon make sure it is installed and enabled in the My addons section of your X-Cart store Admin area.
If not, the addon can be obtained via the X-Cart App Store.
To install the addon, follow the steps described in Installing Addons from the X-Cart App Store.
- Connecting X-Cart to Shopper Approved
- Editing the Reviews Page in X-Cart
- Configuring Shopper Approved Forms in X-Cart
- Submiting Datafeed to Shopper Approved
Connecting X-Cart to Shopper Approved
Before you start using the addon, you need to connect your X-Cart store to the Shopper Approved service. This can be done using the addon settings page that can be accessed from the My Addons section of your store Admin area:
The Shopper Approved settings page offers a store admin to either sign up for Shopper Approved (if no account has been registered so far) or to connect to Shopper Approved manually with an existing account.
- If you do not have a Shopper Approved account yet:
- Hit Sign Up;
- Fill in the fields in the pop-up;
Click Sign Up.
The system will automatically create a Shopper Approved account for you, email you the Shopper Approved account credentials and link your X-Cart store to Shopper Approved by submiting your Shopper Approved Site ID, API Token and domain to X-Cart.
The credentials to access the Shopper Approved dashboard will be sent to the main store administrator email address as configured via the Site administrator e-mails setting in the Contact information section (Store setup -> Contact information) of your X-Cart store Admin area. Make sure this setting has been adjusted properly; otherwise you will not be able to get your Shopper Approved dashboard credentials.
- If you have an existing Shopper Approved account:
- Click the button ‘Connect with existing account’;
- Fill in the fields in the pop-up:
- Click Save changes to submit the settings.
Editing the Reviews Page in X-Cart
Once enabled, the Shopper Approved Reviews addon creates a static page titled Read our reviews; that page is aimed at promoting verified reviews you gain through the Shopper Approved addon.
You can edit it to your liking in the Content -> Pages section of the Admin area (see more info in Managing Content and Service Pages). It is also possible to add the merchant reviews widget to any other static page.
The Read our reviews static page may appear empty until you receive your first reviews and approve them via the Shopper Approved dashboard.
Configuring Shopper Approved Forms in X-Cart
Further addon setup can be done in the Shopper Approved section (Content -> Shopper Approved) of your X-Cart store Admin area.
This section provides two tabs:
- Product and Category pages
On the Product and Category pages tab, you can configure the following settings:
- Use Shopper Approved widget instead of the default one: If this option is enabled, the widget will display the reviews submitted via the Shopper Approved addon only; any reviews submitted earlier will not be available to customers.
- Star size: Regular/Big
- Maximum number of reviews to display: Specify the number of reviews you require (from 3 to 20).
- Date format: Select the date format you require.
More settings affecting the reviews on your store’s product and category pages can be found in the Product -> Code section of your ShopperApproved dashboard at “Step 2. Select Your Options”.
Merchant Review Survey The Merchant Review Survey tab of the Shopper Approved section of your X-Cart store Admin area enables you to control the options pertaining to a brief survey which can be added onto the thank you page for your customers. Depending on your business needs, the survey can be enabled or disabled. It is also possible to specify whether comments should be mandatory.
More survey related settings can be found in the Merchant -> Surveys section of your ShopperApproved dashboard. For example, you can specify a period in days for a follow-up email with a link to the survey to be sent to customers who completed checkout at your store.
Submiting Datafeed to Shopper Approved
Since ShopperApproved uses the Google feed data format, you will need to install and enable the Google Product Feed addon and generate a data feed using it.
To generate data feed use Generate a feed and sync the settings link on any Product Review addon related page in your X-Cart store Admin area:
The data feed will be automatically imported to Shopper Approved, and you will be able to find a link to it in the Dashboard -> Product -> Integration section at ShopperApproved.
Once the Google data feed has been submitted to ShopperApproved, your product reviews should become available in the ShopperApproved dashboard where you will be able manage them further.
The reviews will be updated automatically every time you re-generate the Google feed in X-Cart.
Provided a customer survey has been enabled via the addon settings, your customers will be prompted to provide feedback after placing an order in your X-Cart store. They will see a pop-up screen on the invoice page in the storefront where they will be able to rate their customer experience and answer the survey questions.
It is also possible to leave a feadback on a product directly on the product details page in the storefront. A buyer can use the Reviews tab of a product details page for the purpose:
All approved reviews are published in the Reviews tab of a related product details page.
Help make this document better
This guide, as well as the rest of our docs, are open-source and available on GitHub.