Using Trusted Shops with Magento

The new plugin is compatible with the following versions of your shop system:
 
  • from 2.3.7 on
Your version is not compatible? In that case, you can continue to use your current plugin for the time being. Please keep in mind, however, that we will discontinue technical support for the plugin you have been using up to now on 8 February 2023. After this date, technical problems may occur.
We therefore recommend that you update your shop system as soon as possible and switch to the new plugin afterwards.

A new plugin has been available for Magento since September 2022. Therefore, there are two installation options:

Installation option 1: You already use a Trusted Shops plugin for Magento.

  1. First, uninstall your previously used plugin with the help of the section on “Uninstallation”.
  2. Then, install the current plugin with the help of the section on “Installation”.

Installation option 2: You have not used a Trusted Shops plugin for Magento yet.

  1. Skip the section on "Uninstallation".
  2. Install the current plugin with the help of the section on “Installation”.

Uninstallation

  1. Open the command prompt of your Magento server.
  2. Open the root directory of your Magento installation.
  3. From the root directory, run the following command to enable maintenance mode and temporarily restrict access to the frontend:
    php bin/magento maintenance:enable
  4. Run the following command to disable the plugin and delete the view files created by the plugin:
    php bin/magento module:disable Trustedshops_Trustedshops --clear-static-content
  5. The plugin is now deactivated. Run the following commands to uninstall the plugin:
    composer remove trustedshops/trustedshops
    php bin/magento setup:upgrade
  6. Run the following command to check if the uninstallation was successful:
    php bin/magento module:status Trustedshops_Trustedshops
    If the uninstallation was successful, the following message will appear:
    Trustedshops_Trustedshops : Module does not exist
  7. Execute the following command to exit maintenance mode:
    php bin/magento maintenance:disable

Your previously used plugin has been successfully uninstalled. Now follow the "Installation" section to install the current plugin.

Installation

To get started, download your free Trusted Shops Extension for Magento here. You can then install the extension using the composer provided by Magento. We explain how to use the composer to integrate an extension into Magento here.

To integrate the Trustbadge into your shop, you will first need to open your Magento backend. In the main navigation on the left side you will find the menu item "Stores" (01_16x16.png). Click on this to open another menu. Within this menu you need to select the menu item "Configuration" (02_16x16.png).

Magento_01_EN.png

This opens a new navigation menu on the left side. Within this menu, select the item "Trusted Shops" (01_16x16.png). A drop-down menu will then appear. Click on the menu item "Configuration" (02_16x16.png).

Magento_02_EN.png

Login

 

You must be a member of Trusted Shops in order to use the plugin. Not a member yet? Then click on the link "Not yet a customer?" in the top right corner of the login screen. After clicking, you will be redirected to our website where you will find information on membership options.
1 - EN_Not yet a customer.png

To log in to the plugin, you need individual access data – the API client credentials. The API client credentials are not identical to your access data for the eTrusted Control Centre. Below, you will learn how to create your API client credentials and log in to the plugin with them.

  1. Open the plugin. The login screen appears.
  2. Click on "Request".
    2 - EN_Request Pfeil.png
  3. The eTrusted login page appears in a new browser tab. Enter your username (01_16x16.png), password (02_16x16.png), and click "Log in" (03_16x16.png).
    3_EN_Login CC.png
  4. The overview "Copy your client credentials" appears in a pop-up window. Click on the top blue document icon to copy your Client ID to your cache.
    4 - EN_Copy Client ID CC.png
  5. Switch to the browser tab with the plugin login page. Insert the cached Client ID into the field "Client ID" by right-clicking and selecting "Insert".
    5 - EN Client ID einfügen.png
  6. Switch to the pop-up window with the overview "Copy your client credentials". Click on the blue document icon below to copy your Client Secret to your cache.
    6 - EN_Copy Secret CC.png
  7. Switch to the browser tab with the plugin login page. Insert the cached Client Secret into the field "Client Secret" (01_16x16.png) by right-clicking and selecting "Insert". Click "Connect" (02_16x16.png).
    7 - EN_Secret and connect button.png
The following step does not apply if your Trusted Shops registered sales channel can be definitively assigned to an eTrusted channel. In this case, the plugin will open directly.
  1. A pop-up window will appear. Link your sales channels registered with Trusted Shops (e.g. different language shops, domains) to the corresponding eTrusted channel using the drop-down menus (01_16x16.png). Then click "Save" (02_16x16.png).
    8 - EN_Channel Mapping.png
You must link at least one of your sales channels to eTrusted to be able to click on "Save". We advise you to link all of your sales channels to eTrusted before starting the configuration. Otherwise, the settings you have made will not be visible in your shop. You can change your links at any time via the tab "Settings" within the plugin.

You have successfully logged into your plugin and linked the channels.

Configuration

Next, we will show you how you can display the Trustbadge® technology and configure it according to your individual requirements:

Display the Trustbadge, integrate Buyer Protection & collect reviews

02_EN.png

Unique Trustbadge® technology makes it so simple to collect, manage and display customer reviews in your shop. You can also easily integrate your Trustmark and offer Buyer Protection.

  1. Within the plugin, open the tab "Trustbadge".
    9 - EN_Trustbadge Settings.png
  2. In the drop-down menu "Channel selected" (01_16x16.png), select the sales channel for which you want to carry out the configuration.
You have the option of configuring individual settings for each of your sales channels. The configuration made for one channel will not be applied to your other sales channels. Do not forget to configure your other channels as well.
  1. Check that the switch is set to "active" (02_16x16.png). This setting activates the Trustbadge.
  2. You now have several options for the Trustbadge configuration:
    • Select "Standard" (03_16x16.png). In this case, the Trustbadge is displayed on the lower right corner of your shop in desktop view, and in the lower left corner of your shop in mobile view. If you would like to change this placement, you have various options:
      • Click on the drop-down menu "Placement for desktop users" (04_16x16.png). This allows you to decide whether the Trustbadge should be displayed on the right or left side in desktop view.
      • Click on the drop-down menu "Placement for mobile users" (05_16x16.png). This allows you to decide whether the Trustbadge should be displayed on the right or left side in mobile view.
      • Enter a number of pixels in the input fields "Move up by" (06_16x16.png). This allows you move the Trustbadge up by the desired number of pixels in the respective display.
    • Select "Edit integration code" (07_16x16.png). In this case, you can manually edit the Trustbadge code.
Manual editing of the code opens up more possibilities for you to adapt the integration, and display the Trustbadge in your shop to further suit your individual needs. Doing this requires advanced knowledge of code. In this article, we explain all the settings options you can configure using the Trustbadge code: How do I adapt the Trustbadge® to my requirements?
  1. Click "Save changes" (08_16x16.png).

Now, test the functioning of your Trustbadge. To do this, place a test order in your shop. When the Trustcard appears at the end of your order, you have successfully integrated the Trustbadge into your shop, Buyer Protection is active and reviews will be collected.

03_EN.png

Display Service and Product Reviews in your shop

Numerous widgets are available to display your collected reviews and your overall rating in your shop. The widgets are customisable and the selection is constantly expanding.

This article provides an overview of all available widgets: How do widgets look like on my website?
Please note that the widgets intended for displaying Product Reviews are only available if you have booked Product Reviews.
  1. Within the plugin, open the tab "Widgets".
If widgets are already set up for the selected sales channel, they will be displayed in the box "Current widgets". If you have not yet configured widgets, the box will be empty.
  1. Click on "Create a new widget". A pop-up window will appear.
    13 - EN_Create a new widget.png
  2. Click on "Go to eTrusted" and log into the eTrusted Control Centre. The eTrusted Control Centre's widget library appears.
    14- EN_Go to etrusted CC pop up.png
  3. Select a widget and click on the corresponding button "Create". The widget’s configuration overview appears.
    15 - EN.png
  4. Configure the widget according to your wishes. Then click on "Create widget code".
    16 -EN_Widget-Code erzeugen (Pfeil) (CC).png
  5. Return to the plugin. Click on "Reload list". The widget just generated is now listed in the box "Current widgets".
    14a - EN_Widget Reload list.png
Are there no widgets are listed in your box? Then please use the drop-down menu "Channel selected" in the top left corner to check whether the correct sales channel has been selected.
  1. Use the drop-down menu "Location" (01_16x16.png) to determine the pages and position in your shop on which the widget should appear.
  2. Are you currently configuring a Product Review widget? If yes, also use the drop-down menu "Product id" (02_16x16.png) to determine which product label the widget should use to identify the products.
    17 - EN_Widget_1_full review list.png
Would you like to see the widget before integrating it into your shop? Then move your cursor over the eye symbol (03_16x16.png) to see an example of the widget.
  1. Click on "Save changes".

You have now successfully integrated the widget into your shop.

A whole range of information about your widgets is provided within the box "Current widgets" . To make it easier for you to work with this information, we explain the structure of the box in the following figure and table.

18 - EN_Widget_2_mini stars.png

01_16x16.png Widget Here you will find the name of the widget, as used in the eTrusted Control Centre.
02_16x16.png Product id In order to collect and display product reviews, eTrusted must be able to uniquely identify the products offered in your shop. At this point, you determine which product identification should be used. This setting is therefore only relevant if you want to display product reviews in your shop.
03_16x16.png Status

At this point of the line-up, you will be informed of the status of your widget. There are two possibilities:

  • Integrated: The widget has been successfully integrated into your shop.
  • Action required: The widget is not sufficiently configured. One possible cause for this announcement may be that no placement has been determined for the widget yet. Another reason may be that a widget previously placed in the eTrusted Control Centre has been deleted.
04_16x16.png Content Here you can find out which types of reviews are displayed via the respective widget.
05_16x16.png Location

The placement of the widget within your shop is determined here. Possibilities include product pages, the checkout page, and the header or footer, for example.

Optimised sending of review invites

Adjust the sending time of review invites

Once you have activated the Trustbadge, reviews are collected automatically. By using the plugin, you have the option of adapting the sending time of review invites to your needs. Link the dispatch time to one of the order statuses stored in your shop system.

For touchpoints outside the "Checkout", you must ensure that all recipients have effectively consented to their email address being sent to Trusted Shops in order to be reminded to submit a review. Get more info here: Consent for review invites

EN.png

  1. Within the plugin, open the "Review Invites" tab (01_16x16.png).
  2. Scroll to the "Send review invites at the right time to collect more and better reviews" area.
  3. Use the "Service reviews" drop-down menu (02_16x16.png) to select the order status to which you want to link the sending time of your service review invites.
  4. Use the "Product reviews" drop-down menu (03_16x16.png) to select the order status to which you want to link the sending time of your product review invites.
To be able to collect Product Reviews, you must first book them. Click on "contact our sales team" (04_16x16.png) if you want to book product reviews.
  1. Click on "Save" (05_16x16.png).

You have now successfully linked the sending time to an order status.

As soon as the order status is reached, a sending delay starts. The length of the sending delay is based on data from Trusted Shops for the optimal sending time. After the sending delay has expired, the review invite is sent.

Would you like to decide yourself how much time should pass between reaching the order status and sending the review invite? Then create an invite rule in the eTrusted Control Centre. This article can help you: How to send invites to my customers automatically?

Manually send review invites

If you do not want to collect your reviews automatically, or you want to manually invite customers to submit reviews in addition to the automated sending of invitations, you can use the Review Collector. To do this, you need a CSV file with data on the customers you would like to send review invites to. You can create this CSV file using the plugin.

  1. Within the plugin, open the tab "Review Invites".
  2. Scroll to area "Send Review Invites for previous orders".
  3. Use the selection field "Export orders" (01_16x16.png) to define the period for which order data is to be exported.
  4. Do you also want to collect product reviews manually? Then the CSV file must include data about the ordered products. To do this, set the "Include product data" (02_16x16.png) switch to green.
  5. Click "Export" (03_16x16.png). The CSV file is downloaded.
    EN-2.png
  6. Log in to the eTrusted Control Centre.
  7. Use the Review Collector with the help of this article: How can I manually invite customers for review with the Review Collector?

Additional settings options

Link sales channels to eTrusted

  1. Within the plugin, open the tab "Settings".
  2. Scroll to area "Channel settings".
  3. Link your sales channels (e.g. different language shops) to the corresponding eTrusted channel using the drop-down menus (01_16x16.png).
  4. Click on "Save changes".
    22_-_EN_Setting.png

Unlink Trusted Shops

If you unlink your shop system from Trusted Shops, all settings will be lost. You cannot undo the deletion.
  1. Within the plugin, open the tab "Settings".
  2. Scroll to area "Disconnect Trusted Shops".
  3. Click on "Disconnect".
    23_-_EN_Setting_disconnect.png

Was this article helpful?

9 out of 23 found this helpful