Consentl pour Magento 2 / Adobe Commerce

Module Consentl pour Magento et Adobe Commerce 2.4.6 à 2.4.8 : chargeur juste après <meta charset>, passerelle Cookie Restriction Mode, widgets CMS. Luma et Hyvä.

Chargeur en premier dans <head>

Oui

Télécharger

consentl-module-consent-1.1.0.zip · Version 1.1.0 · 201 KB · SHA-256

Le module consentl/module-consent connecte votre boutique Magento à Consentl. Il enregistre la clé du site par site web ou par vue de magasin, insère le chargeur directement après <meta charset>, relie chaque choix au Cookie Restriction Mode de Magento et fournit des widgets CMS. La conception de la bannière, les textes en 34 langues, les règles régionales et les règles de blocage se gèrent dans le tableau de bord Consentl.

Prérequis

• Magento Open Source ou Adobe Commerce 2.4.6, 2.4.7 ou 2.4.8 ; PHP 8.1 à 8.4 selon ce que prend en charge votre version de Magento.
• Thèmes Luma ou Hyvä ; le Full Page Cache intégré et Varnish sont pris en charge.
• Un compte Consentl (forfait Free disponible).

Installation

À partir du fichier zip (Téléchargements) : décompressez-le dans app/code/Consentl/Consent/, de sorte que composer.json se trouve à la racine de ce dossier, puis exécutez :

bin/magento module:enable Consentl_Consent
bin/magento setup:upgrade
bin/magento setup:di:compile              # production mode
bin/magento setup:static-content:deploy   # production mode
bin/magento cache:flush

Avec Composer : composer require consentl/module-consent dès que le paquet sera publié, puis les mêmes commandes.

Connecter votre site

Allez dans Stores → Configuration → Consentl → Consentement aux cookies et sélectionnez d’abord le périmètre (la clé et la langue peuvent différer par site web ou par vue de magasin).

• Se connecter à Consentl vous connecte ou crée un compte gratuit, vous permet de choisir ou de créer le site pour le domaine de cette boutique et vous ramène avec la Clé de site enregistrée et Consentl activé. Le lien de retour n’est valable que dans la même session d’administration.
• Ou collez la clé (sk_ + 24 caractères) et réglez Activer Consentl sur Oui.

Videz le Full Page Cache après l’enregistrement si votre configuration ne le fait pas automatiquement.

Configuration

• Langue de la bannière : Automatique associe la langue de la vue de magasin à la langue Consentl la plus proche (de_AT → de, pt_BR → pt-BR, nb_NO → nb). Vous pouvez aussi imposer une langue.
• Passerelle vers le Cookie Restriction Mode (recommandée si vous utilisez les modules Google Analytics ou Google Tag de Magento) :
  1. Réglez Stores → Configuration → General → Web → Default Cookie Settings → Cookie Restriction Mode sur Yes.
  2. Réglez Synchroniser les choix Consentl avec le mode de restriction des cookies sur Oui.
  3. Réglez Masquer l’avis de cookies natif de Magento sur Oui.
  4. Facultatif : Recharger la page après le premier consentement, afin que les modules Google de Luma démarrent sur le même affichage de page plutôt que sur le suivant.
• Avancé : conservez la position du chargeur Premier élément de <head>.

Widgets CMS (Content → Pages / Blocks → Insert Widget) :

Tout <a href="#consentl">…</a> dans un bloc CMS rouvre aussi les préférences.

Vérifier le fonctionnement

1. Affichez le code source de la page : le chargeur vient directement après <meta charset>. Sur Luma, la configuration RequireJS en ligne de Magento se trouve au-dessus ; elle ne charge rien.
2. Avec la passerelle activée : avant tout choix dans une région opt-in, le cookie user_allowed_save_cookie n’est pas déposé ; après l’acceptation d’une catégorie, il est déposé pour votre site web.
3. Les pages restent mises en cache : la sortie ne contient aucune donnée propre au visiteur.

Content Security Policy

Le module autorise https://api.consentl.com dans la liste blanche CSP de Magento et n’imprime aucun JavaScript en ligne : il fonctionne donc avec la CSP du checkout en mode restrictif de la version 2.4.7+ et avec les thèmes CSP de Hyvä.

Pour les développeurs

Consentl\Consent\ViewModel\Consent::allows('marketing') lit le cookie consentl, uniquement pour les contextes non mis en cache (checkout, compte client, AJAX). Sur les pages mises en cache, conditionnez les balises dans le HTML avec <script type="text/plain" data-consentl="marketing">…</script>.

Limites

• Les scripts qu’une autre extension imprime au-dessus de <meta charset>, ou les scripts en ligne qu’un thème place avant le contenu de head, s’exécutent avant Consentl.
• Le module Magento_GoogleTagManager d’Adobe Commerce (code source fermé) n’a pas été vérifié avec la passerelle. Utilisez Consent Mode (à partir du forfait Pro, activé dans le tableau de bord) : Consentl définit les valeurs par défaut et les mises à jour, et les balises GTM les respectent.
• Magento ne dispose que d’un seul indicateur d’opt-in : la passerelle le définit donc dès qu’une catégorie facultative est accordée.
• Sur Hyvä, si l’avis de cookies propre à Hyvä apparaît encore, supprimez-le dans votre thème avec <referenceBlock name="cookie_notices" remove="true"/> dans Magento_Cookie/layout/default.xml.
• La désinstallation laisse les valeurs de configuration sous consentl/* dans core_config_data ; supprimez-les avec bin/magento config:delete si nécessaire.

Guides associés

• Shopware 6
• PrestaShop
• Google Tag Manager

Vous êtes bloqué ? Écrivez à support@consentl.com — nous répondons en anglais les jours ouvrables.