Introduction

We love making things easy for you! This is why we are putting loads of effort to develop plugins, add-ons and modules for widely used platforms, which you can use to make integration an issue of a few clicks. 

In this article you can find how to integrate e-satisfaction.com on Cs-Cart by using the CS-Cart add-on that our team developed for you to use.

Information Needed

Gather all the required data as pointed out in the Web Integration article, in the section "Information Needed".

Step 1: Preparation

Before you do anything else, you must find and download the correct add-on package, from the following link: https://github.com/esatisfaction/esat-cs-cart

Step 2: Upload

The next step is to login to CS-Cart (with admin rights) and locate the add-ons section. In CS-Cart 4.10 this page looks like the following snapshot:

In this page you can see on the top right section the "+" button. Click it and upload the pack that you have downloaded previously.

Step 3: Configure IDs

After successfully installing the add-on, you should be able to see the "e-satisfaction" add-on on your list. Clicking on it you should see all the settings needed:

The configurations / settings that need to be filled in this page are the following:

Final check

After going through all these steps mentioned above, you should be up and running and the questionnaires should be displayed, collecting feedback from your customers. If you face any  issues in collection and you have cross checked that you completed the above mentioned steps correctly, please see these articles to make a quick troubleshooting. 

Of course we are always here to help and you can Submit a request or just using the chat box you see on the right.

Push Metadata

Browse

In order to add extra metadata for your Browse questionnaire, you should edit the following file:

~/design/themes/responsive/templates/addons/esatisfaction/hooks/index/head_scripts.post.tpl

You should add the following script and add all the extra needed metadata like the following example:

<script>
    Esat.updateMetadata("BROWSE-QUESTIONNAIRE-ID", {
        responder: {
            "metadata_name": "metadata_value"
        },
        questionnaire: {
            "metadata_name": "metadata_value"
        }
    });
</script>

NOTE: You should add the metadata at the Application Settings panel in the e-satisfaction Dashboard first, if they do not exist already.

Checkout

In order to add extra metadata for your Checkout questionnaire, you should edit the following file:

~/design/themes/responsive/templates/addons/esatisfaction/hooks/checkout/order_confirmation.post.tpl

You should edit the metadata script and add all the needed metadata like the following example:

{if $addons.esatisfaction.enabled == 'Y'}
    <div id="esat-checkout-questionnaire-container"></div>
    <br/>
    <script>
        // Update metadata
        Esat.updateMetadata('{$addons.esatisfaction.checkout_questionnaire_id}', {
            responder: {
                "email": '{$order_info.email}',
                "phone_number": '{$order_info.phone}',
                "metadata_name": "metadata_value"
            },
            questionnaire: {
                "transaction_id": '{$order_info.order_id}',
                "transaction_date": '{$order_info.timestamp|date_format:"`$settings.Appearance.date_format`, `$settings.Appearance.time_format`"}',
                "metadata_name": "metadata_value"
            }
        });
    </script>
{/if}

NOTE: You should add the metadata at the Application Settings panel in the e-satisfaction Dashboard first, if they do not exist already.