Iubenda logo
Générer dès maintenant

Documentation

Sommaire

Cookie Solution – Guide d’installation de l’extension Magento

Cette extension simplifie l’intégration de la Cookie Solution et réduit ainsi de façon drastique le nombre de modifications à apporter au code de votre site.

Elle affiche un bandeau cookies entièrement personnalisable, génère de façon dynamique une politique relative aux cookies qui correspond aux services utilisés sur votre site, conserve les preuves des préférences des utilisateurs et assure la gestion complète du consentement aux cookies (y compris le blocage des widgets et des cookies tiers les plus courants jusqu’à l’obtention du consentement) pour vous permettre de vous conformer au RGPD, à la directive ePrivacy et à la loi CCPA

  • Nous proposons des extensions à la fois pour les versions 1.9.x et 2.x de Magento. Toutefois, la version 1.x de Magento n’est plus prise en charge depuis le 30 juin 2020. En ce qui concerne la version 2.x, notre extension est compatible avec Magento Open Source (édition Magento Community) et Magento Commerce (éditions Magento Enterprise et Magento Enterprise Cloud).
  • Nos extensions fonctionnent mieux avec la version 5.5 ou les versions plus récentes de PHP.

Fonctionnalité

  • Notre extension vous permet de bloquer automatiquement ou manuellement les scripts qui peuvent installer des cookies jusqu’à l’obtention du consentement, sans toucher directement à votre code.
  • Elle peut détecter où se trouvent les utilisateurs, réserver le blocage préalable et les demandes de consentement aux cookies aux seuls utilisateurs se trouvant dans l’UE (où il s’agit d’une obligation légale) et exécuter normalement les scripts qui installent des cookies dans les régions où la législation vous y autorise toujours.
  • Les scripts qui installent des cookies sont réactivés de manière asynchrone une fois le consentement recueilli.
  • Cette extension gère l’affichage du bandeau cookies et de la politique relative aux cookies. Personnalisez entièrement l’apparence et les couleurs du bandeau cookies pour l’assortir à la marque de votre site si nécessaire.
  • Elle est conforme à la loi de la Californie sur la vie privée des consommateurs (CCPA).
  • Elle enregistre les préférences des utilisateurs en matière d’utilisation des cookies et affiche des pages sans bandeau cookies aux utilisateurs qui ont déjà donné leur consentement.
  • Notre extension est compatible avec la version 2.0 du Cadre de transparence et de consentement (TCF) de l’IAB.
  • Elle vous permet de donner à vos utilisateurs un contrôle précis sur leurs préférences à l’égard des catégories de finalités (p.ex. fonctionnalités de base, amélioration de l’expérience, ciblage et publicité).
  • Cette extension est également compatible avec les AMP (Accelerated Mobile Pages) de Google.
  • Une interface simple d’utilisation vous permet d’indiquer des iframes et scripts personnalisés.
  • Elle détecte les bots et les robots d’indexation et leur affiche des pages sans bandeau cookies pour ne pas compromettre vos efforts de référencement naturel (SEO).
  • AdRoll
  • Widgets AddThis
  • Bing
  • CodePen
  • Criteo
  • Disqus
  • Elevio
  • Commentaires Facebook
  • Widgets Facebook
  • Freshchat
  • Google AdSense
  • Google Analytics
  • Google Maps
  • Google reCAPTCHA
  • Google Site Search
  • Google Tag Manager
  • Google OAuth
  • Widgets Google+
  • Headway
  • Widgets Instagram
  • Kissmetrics
  • Widgets LinkedIn
  • Mixpanel
  • Neodata
  • Olark
  • Optimizely
  • Outbrain
  • Widgets PayPal
  • Pingdom
  • Widgets Pinterest
  • Segment
  • Widgets ShareThis
  • Widgets Twitter
  • UserVoice
  • Vimeo
  • YouTube

Installation

Magento 2.x (édition Community/Enterprise/Cloud)

  1. « Achetez » notre extension gratuite sur la Marketplace Magento. Elle apparaîtra alors sur la page de vos achats.
  2. Connectez-vous au serveur en ligne de commande à l’aide du protocole SSH.
  3. Installez notre extension à l’aide de la commande composer require iubenda/module-cookiesolution. Si vous avez besoin d’une version antérieure à la version actuelle, ajoutez à cette commande le numéro de la version souhaitée, par exemple : iubenda/module-cookiesolution:2.2.0.
  4. Lorsqu’elles vous sont demandées, utilisez la clé publique de la Marketplace Magento comme identifiant et la clé privée comme mot de passe. Remarque : vous devrez acheter l’extension pour poursuivre l’installation à l’aide du composer.
  5. Une fois l’extension installée, vérifiez son statut à l’aide de la commande php bin/magento module:status
    .
  6. L’extension devrait avoir le statut « disabled » (désactivée). Activez-la grâce à la commande php bin/magento module:enable Iubenda_CookieSolution puis initialisez-la avec php bin/magento setup:upgrade.
  7. Si votre boutique est en mode production, compilez le code à l’aide de la commande php bin/magento
    setup:di:compile
    .
  8. Vérifiez à nouveau si votre extension est activée avec php bin/magento module:status. Si c’est le cas, videz le cache à l’aide de la commande php bin/magento cache:clean.

Instructions de désinstallation pour les versions téléchargées avant l’apparition de la place de marché

  1. Ouvrez le fichier config.php situé dans le dossier « /app/etc/ ». Cherchez la ligne 'iubenda_cookiesolution' => 1, remplacez 1 par 0 et sauvegardez.
  2. Supprimez le dossier « /app/code/Iubenda/CookieSolution ».
  3. Si le cache est activé, vous devez le vider. Pour cela, rendez-vous dans Système > Gestion du cache, sélectionnez tous
    les types de cache et cliquez sur Rafraîchir.
  4. Ouvrez le fichier config.php situé dans le dossier « /app/etc/ », supprimez la ligne
    'iubenda_cookiesolution' => 0 et sauvegardez.
  • Connectez-vous à la zone d’administration de votre site Magento et rendez-vous dans Système > Magento Connect > Magento Connect Manager.
  • Saisissez à nouveau vos informations de connexion à la zone d’administration de votre site Magento.
  • Cochez la case Créer une sauvegarde et sélectionnez le type de sauvegarde.

Une fois votre sauvegarde créée, vous pouvez télécharger le package disponible ici.

Installez l’extension puis retournez dans la zone d’administration de Magento et configurez l’extension iubenda.

Configuration

Une fois l’installation terminée, rendez-vous dans Magasins > Configuration > iubenda > iubenda Cookie Solution. C’est ici que vous pourrez configurer notre extension.

Copiez-collez le code JavaScript de votre Cookie Solution que vous avez récupéré dans votre compte iubenda (comme indiqué dans le guide d’introduction). Sauvegardez puis videz le cache du magasin.

Mise en garde

N’oubliez pas d’enregistrer le code JavaScript valide à cet endroit pour garantir le bon fonctionnement de l’extension.

Utilisation

Une fois configurée, l’extension affichera le bandeau cookies (qui contiendra un lien vers votre politique relative aux cookies) aux utilisateurs qui visiteront votre site pour la première fois, sans action supplémentaire de votre part. Par ailleurs, cette extension reconnaîtra, détectera et bloquera automatiquement les cookies présents sur votre site s’ils figurent sur la liste ci-dessus.

Important

Nos extensions Magento bloquent automatiquement les scripts générés côté serveur, c’est-à-dire les scripts retournés par PHP par Magento. Les scripts insérés par JavaScript après le chargement de la page ne sont pas bloqués automatiquement ni ne peuvent l’être.

Pour bloquer ces scripts, vous avez deux possibilités. La première consiste à indiquer la source du script dans la zone de texte correspondante de la section « Custom scripts » (consacrée aux scripts personnalisés) dans les réglages de l’extension. Autrement, vous pouvez utiliser la méthode de balisage manuel illustrée par l’exemple ci-dessous et (de façon plus détaillée) dans cet article de notre documentation.

Blocage des scripts personnalisés depuis les réglages de l’extension

La section « Custom scripts » vous permet de bloquer facilement les scripts insérés dans la page, directement depuis les réglages de l’extension. Cette méthode réduit considérablement le nombre de modifications à apporter au code de votre site.

Magento 2.x (édition Community/Enterprise/Cloud)

Dans le panneau d’administration, rendez-vous dans Magasins > Configuration > iubenda > iubenda Cookie Solution.

menu de configuration de l’extension iubenda pour magento

Faites défiler la page jusqu’aux champs « Scripts » et « Iframes » de la section Custom consacrée à la personnalisation.

iubenda cookie solution champs scripts et iframes personnalisés

Indiquez la source des scripts ou des iframes que vous souhaitez bloquer et cliquez sur le bouton Sauvegarder la configuration en haut de la page.

Dans le panneau d’administration, rendez-vous dans Système > Configuration. Cliquez ensuite sur iubenda Cookie Solution sous Services dans le menu Configuration (à gauche). iubenda cookie solution interface des scripts et iframes personnalisés

Puis, faites défiler la page jusqu’à la section Custom consacrée à la personnalisation. iubenda cookie solution interface des scripts et iframes personnalisés

Indiquez la source des scripts ou des iframes que vous souhaitez bloquer et cliquez sur le bouton Sauvegarder la configuration en haut de la page.

Exemples d’utilisation

L’utilisation de ces champs est assez intuitive. Il vous suffit d’indiquer l’attribut src du script ou de l’iframe que vous souhaitez bloquer.

Script

Si vous souhaitez bloquer un bouton de réseau social (qui insère des scripts dans la page via JavaScript), vous devez simplement indiquer la source du script, p.ex. connect.socialwebsite.net/en_US/track.js dans le champ Scripts.

Iframe

Imaginons que vous souhaitez bloquer les scripts insérés dans la page par le biais de l’iframe suivante :

<iframe width="1280" height="720" src="https://www.videowebsite.com/embed/xxFhMChxx" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe> 

Vous devrez alors indiquer dans le champ Iframe l’URL videowebsite.com/embed/ qui est la source réelle des scripts. Veillez à ne PAS indiquer l’identifiant du composant (videowebsite.com/embed/xxFhMChxx). En l’omettant, vous vous assurerez de bloquer tous les scripts qui proviennent de la source réelle.

Balisage (méthode manuelle)

Cette méthode vous demande de modifier directement le code de votre site. Vous devrez vous rendre dans la section pertinente du code de votre site et identifier les scripts à bloquer comme indiqué ci-dessous.

Voici un exemple qui montre comment faire fonctionner l’extension manuellement pour un bouton de réseau social (qui insère des scripts dans la page via JavaScript).

<!--IUB-COOKIE-BLOCK-START-->
<script>
    (function(d, s, id) {
        var js, fjs = d.getElementsByTagName(s)[0];
        if (d.getElementById(id)) return;
        js = d.createElement(s);
        js.id = id;
        js.src = "//connect.socialwebsite.net/en_US/sdk.js#xfbml=1&version=v2.3&appId=808061959224601";
        fjs.parentNode.insertBefore(js, fjs);
    }(document, 'script', 'socialwebsite-jssdk'));
</script>
<!--IUB-COOKIE-BLOCK-END-->

En présence d’éléments html, img ou iframe, vous devrez procéder comme suit :

<!--IUB-COOKIE-BLOCK-START-->
      <iframe src="...
      <img src="...
<!--IUB-COOKIE-BLOCK-END-->

Si vous avez activé la fonctionnalité de consentement par catégorie, vous devrez préciser la finalité. Reprenons l’exemple du bouton de réseau social, qui relève de la finalité « Amélioration de l’expérience » (identifiant 3) :

<!--IUB-COOKIE-BLOCK-START-PURPOSE-3-->
<script>
    ...
</script>
<!--IUB-COOKIE-BLOCK-END-PURPOSE-3-->

Pour interrompre l’analyse et le remplacement automatique des scripts et des iframes qui contiennent une source définie :

<!--IUB-COOKIE-BLOCK-SKIP-START-->
      <script type="text/javascript">...</script>
<!--IUB-COOKIE-BLOCK-SKIP-END-->

Installez l’extension Cookie Solution avec :

Magento 2.x édition Community/Enterprise/Cloud

ou

Magento 1.9.x

Voir aussi