print

Integrating TRUENDO CMP with Magento

Introduction#

This guide provides step-by-step instructions on how to integrate the TRUENDO Consent Management Platform (CMP) into your Magento website. TRUENDO CMP helps you manage cookies and user consent in compliance with privacy regulations like GDPR. By following this guide, you'll be able to install the TRUENDO plugin from a zip file, configure it, and ensure enhanced data privacy on your Magento site.

1. Prerequisites#

Before you begin, ensure you have the following:

  • Access to Your Magento Server: Ability to upload files and run command-line commands.
  • Magento Version: Ensure you're running a compatible version of Magento.
  • TRUENDO Account: If you don't have one, you'll need to create it and obtain your Site ID.

2. Plugin Installation#

A. Download the TRUENDO Plugin

  1. Download the ZIP File:

    • Download the TRUENDO plugin for Magento from here.
    • Save the truendo_cmp-1.0.0.zip file to a location accessible from your Magento server.

B. Create the Required Directory

  1. Access Your Magento Root Directory:

    • Use SSH or FTP to access your Magento installation's root directory.

  2. Create the Directory Structure:

    • Navigate to app/code/.

    • Create the following directories if they do not already exist:

      app/code/truendo/integration

      • You can create directories using the command line:

        mkdir -p app/code/truendo/integration

C. Unzip the Plugin

  1. Unzip the Plugin Files:

    • Unzip the contents of truendo_cmp-1.0.0.zip into the app/code/truendo/integration directory.

    • Example command:

      unzip truendo_cmp-1.0.0.zip -d app/code/truendo/integration

    • Ensure that the files are properly placed within the integration directory.

D. Enable the TRUENDO Extension

  1. Navigate to the Magento Root Directory:

    • Ensure you are in the root directory of your Magento installation.

  2. Run the Following Commands to Enable the Extension:

    php bin/magento module:enable Truendo_Integration
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:clean
php bin/magento cache:flush

    • Explanation of Commands:

      • module:enable Truendo_Integration: Enables the TRUENDO module.
      • setup:upgrade: Updates the Magento database schema and data.
      • setup:di:compile: Compiles dependency injection configurations.
      • cache:clean: Cleans the cache types.
      • cache:flush: Flushes the cache storage.

  3. If Running in Production Mode:

    • If your Magento is running in production mode, run the following command:

      php bin/magento deploy:mode:set production

3. Configuration#

A. Copy Your Site ID

  1. Log In to the TRUENDO Console:

  2. Access the Integration Script:

    • Select your organization and website.
    • Go to the "Banner" section in the left menu.
    • Scroll down to "Integration via Script".

  3. Copy Your Site ID:

    • Your Site ID is displayed in the integration script.
    • Copy the Site ID for use in Magento.

B. Enter the Site ID in Magento

  1. Log In to Your Magento Admin Panel:

    • Navigate to your Magento admin URL, typically https://yourdomain.com/admin.
    • Log in with your admin credentials.

  2. Navigate to TRUENDO Integration Settings:

    • From the Admin sidebar, go to:

      Stores -> Configuration -> TRUENDO -> Integration Settings

  3. Paste Your Site ID:

    • In the Site-ID input field, paste the Site ID you copied from the TRUENDO Console.

  4. Save Configuration:

    • Click on "Save Config" to apply the changes.

4. Verifying the Integration#

To ensure TRUENDO CMP is correctly integrated:

  1. Clear Cache:

    • In the Magento Admin, go to:

      System -> Cache Management

    • Click "Flush Magento Cache" and "Flush Cache Storage".

  2. Visit Your Website:

    • Open your Magento storefront in a browser.

  3. Check for the Consent Banner:

    • The TRUENDO consent banner should appear upon visiting the site.

  4. Test Consent Functionality:

    • Interact with the consent banner by accepting or customizing your preferences.
    • Ensure that your choices are respected (e.g., non-essential cookies are blocked if you decline them).

  5. Use Developer Tools:

    • Open your browser's developer tools.
    • Check the Network and Application/Storage tabs to see which scripts and cookies are loaded.

5. Additional Resources#

  • TRUENDO Support:

  • Documentation and Guides:

  • Magento Documentation:

    • For more information about managing Magento modules, visit Magento DevDocs.

6. Conclusion#

By following this guide, you have successfully integrated TRUENDO CMP into your Magento website. This ensures that your site complies with privacy regulations and respects user consent preferences. The TRUENDO plugin simplifies consent management, allowing you to focus on your e-commerce operations.

Thank you for choosing TRUENDO CMP for your consent management needs.

End of Guide

×