Consentl pour Shopware 6

Le plugin Consentl pour Shopware 6.6 et 6.7 place la bannière en premier dans <head>, remplace la barre de cookies et synchronise les groupes de cookies.

Chargeur en premier dans <head>

Oui

Télécharger

consentl-shopware-1.1.1.zip · Version 1.1.1 · 164 KB · SHA-256

Le plugin Consentl connecte votre boutique Shopware à Consentl. Il enregistre la clé du site par canal de vente, imprime le chargeur comme premier élément de <head>, remplace la barre de cookies de Shopware et transmet chaque choix aux groupes de cookies de Shopware, afin que la liste de souhaits, les éléments YouTube, Google Analytics et d’autres fonctionnalités le suivent. Les textes, les couleurs, les régions et les enregistrements de consentement se gèrent dans le tableau de bord Consentl.

Prérequis

• Shopware 6.6 ou 6.7, PHP 8.2 ou ultérieur.
• Un compte Consentl (forfait Free disponible).

Installation

À partir du fichier zip (Téléchargements) :

1. Dans l’administration, allez dans Extensions → Mes extensions → Charger une extension (« Upload extension ») et choisissez le fichier zip, ou exécutez sur le serveur :

bin/console plugin:zip-import consentl-shopware-<version>.zip
bin/console plugin:install --activate ConsentlConsent
bin/console cache:clear

2. Installez et activez Consentl, puis videz le cache.

Le script storefront du plugin est copié dans public/bundles/consentlconsent/ lors de l’activation ; exécutez bin/console assets:install si vous déployez sans le cycle de vie des plugins.

Connecter votre site

Ouvrez Extensions → Mes extensions → Consentl → Configurer. Les réglages s’appliquent par canal de vente et héritent de « Tous les canaux de vente ».

• Se connecter à Consentl vous connecte, vous permet de choisir ou de créer le site et enregistre la clé pour le canal de vente sélectionné.
• Ou collez la clé du site (sk_ + 24 caractères) depuis le tableau de bord et enregistrez.

Configuration

Groupes de cookies. Les groupes de Shopware correspondent aux catégories Consentl : techniquement requis → strictement nécessaires, fonctionnalités de confort → préférences, statistiques → mesure d’audience, marketing → marketing. Les autres groupes sont associés par mot-clé ou utilisent la catégorie de repli. Lorsqu’un visiteur décide, le plugin écrit les mêmes cookies que Shopware écrirait lui-même (wishlist-enabled, youtube-video, google-analytics-enabled, …) et annonce le changement, afin que les extensions à l’écoute des changements de consentement réagissent sans rechargement. Les liens vers les paramètres de cookies de Shopware ouvrent les préférences Consentl.

Widgets. Le bloc Shopping Experiences Consentl (catégorie Texte) avec les éléments déclaration relative aux cookies, formulaire de demande relative aux données personnelles et formulaire de rétractation. Dans les thèmes, vous pouvez aussi utiliser les includes Twig :

{% sw_include '@ConsentlConsent/storefront/consentl/widget.html.twig' with { consentlType: 'declaration' } %}
{% sw_include '@ConsentlConsent/storefront/consentl/settings-link.html.twig' %}

consentlType peut valoir declaration, request ou withdrawal.

Vérifier le fonctionnement

1. Affichez le code source de votre storefront : <head> commence par <script src="https://api.consentl.com/v1/loader.js?k=…&l=de">.
2. La barre de cookies de Shopware n’apparaît plus ; la bannière Consentl, si.
3. Refusez tout : les cookies google-analytics-enabled, wishlist-enabled et youtube-video ne sont pas déposés et Google Analytics ne se charge pas. Acceptez la mesure d’audience : google-analytics-enabled=1 est déposé sans rechargement.

Pour les développeurs

Dans Twig, {% if consentl_allowed('marketing') %}…{% endif %} vérifie une décision enregistrée. Il ne voit que le cookie consentl (et non les valeurs par défaut de la région) et est évalué lors du rendu de la page : les pages issues du cache HTTP de Shopware ne sont donc pas réévaluées. Préférez le blocage côté client : <script type="text/plain" data-consentl="analytics">…</script>.

Limites

• Conserver la barre de cookies de Shopware (remplacement désactivé) fait fonctionner deux interfaces de consentement ; ne l’utilisez que pour une transition.
• Shopware 6.7 comprend son propre formulaire de demande de révocation (rétractation). Utilisez soit le formulaire de rétractation de Shopware, soit celui de Consentl, mais pas les deux.
• Le processus de connexion utilise l’hôte de l’administration comme domaine ; ajoutez vos domaines de storefront dans le tableau de bord Consentl s’ils sont différents.

Guides associés

• PrestaShop
• Magento 2
• Google Tag Manager

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