Intégration d'une configuration de cookies

Owned by Nicolas Rueff
Last updated: May 23, 2022 by Jerome Blanchard (Deactivated)
2 min read

Une fois votre bannière créée et personnalisée, du code est généré pour être intégré dans un site web. Ce code est visible dans le panel Balises à intégrer :

Contenu de cette documentation :

WordPress

  1. Installer l'extension "Insert headers and footers" (https://wordpress.org/plugins/insert-headers-and-footers/) sur WordPress.

  2. Une fois l'extension installée et activée, faire un copier-coller du code à intégrer dans la section "head" de l'extension.

Drupal

  1. Dans votre dossier racine du site Drupal, créer un dossier "module" ;

  2. Dans le dossier "module", créer un sous-dossier "myLibrariesLoader" ;

  3. Dans le dossier "myLibrariesLoader", créer 3 fichiers comme indiqué ci-dessous :

    • myLibrariesLoader.info.yml pour déclarer le module, qui doit être dans le package "Custom" ;

    • myLibrariesLoader.libraries.yml pour déclarer les balises de script qui seront ajoutées aux pages (détail ci-dessous) ;

      tarteaucitron: version: 1.x header: true js: <url de tarteaucitron (1ère balise du panel d'intégration)>: { external: true } tac_config: version: 1.x header: true css: theme: <url du style personnalisé (3ème balise du panel d'intégration)>: { external: true } js: <url de la configuration personnalisée (2ème balise du panel d'intégration)>: { external: true } dependencies: - myLibrariesLoader/tarteaucitron

    • myLibrariesLoader.module pour activer le module et lui faire utiliser les 2 librairies. Attention, le fichier doit impérativement débuter par "<?php", sans espaces ni sauts de ligne avant.

      <?php function myLibrariesLoader_page_attachments(array &$attachments) { $attachments['#attached']['library'][] = 'myLibrariesLoader/tarteaucitron'; $attachments['#attached']['library'][] = 'myLibrariesLoader/tac_config'; }

Ces trois fichiers doivent impérativement avoir le même nom que le dossier dans lequel ils se trouvent.

Détail de myLibrariesLoader.libraries.yml :

  • La librairie tarteaucitron est déclarée en premier car elle sert de dépendance à la librairie "tac_config" ; 

  • Les sources sont récupérées via les liens fournis en paramètres "js" : tarteaucitron est récupéré sur un CDN officiel et "tac_config" est le fichier de configuration généré ;

  • Les 2 librairies ont le paramètre "header: true" pour forcer l'ajout des balises de script dans le <head> des pages html ;

Une fois ces trois fichiers créés, il faut se rendre dans l'onglet Extensions de la console admin du site Drupal, puis chercher le nom du module (ici myLibrariesLoader) dans la barre de recherche. Le module devrait apparaître dans la liste : cocher la case à cocher puis cliquer sur "Installer".

Enfin, cliquer sur le lien "script de mise à jour" dans le bandeau de texte en haut de la page Extensions. Il faudra cliquer sur ce lien à chaque fois que les fichiers du module auront été modifiés.

Pour aller plus loin