CC PrestaShop EU Cookies documentation
Documentation complète du module de gestion du consentement aux cookies pour PrestaShop conforme à RODO, ePrivacy et Google Consent Mode 2.0 (cc_ps_cookies).Table des matières
- Introduction
- Installation
- Activation de la licence
- Panel de gestion
- Gestion des cookies
- Gestion des groupes de cookies
- Configuration de l'apparence
- Intégration avec Google Consent Mode
- Utilisation du module dans les modèles
- Résolution de problèmes
- FAQ
1. Introduction
CC PrestaShop EU Cookies est un module avancé de gestion du consentement aux cookies conforme à RODO, ePrivacy et Google Consent Mode 2.0. Le module offre un contrôle total sur les cookies utilisés dans la boutique, permettant de les regrouper, de les bloquer et de les présenter aux utilisateurs d'une manière esthétiquement agréable.Le module offre :
- Détection automatique des cookies utilisés dans la boutique
- Regroupement des cookies par catégorie
- Bloquer les cookies pour lesquels vous n'avez pas donné votre consentement
- Bannière de consentement configurable avec différents styles
- Intégration complète de Google Consent Mode 2.0
- Conformité avec les exigences RODO et ePrivacy
- Soutien au multilinguisme
- API avancée à utiliser dans les modèles
2. installation
Exigences du système- PrestaShop 1.7 ou supérieur
- PHP 7.0 ou plus récent
- Permission d'installer des modules
- Télécharger le fichier ZIP du module depuis la boutique officielle cocos.codes
- Se connecter au panneau d'administration de PrestaShop
- Allez dans : Modules > Gestionnaire de modules > Ajouter un nouveau module
- Cliquez sur "Ajouter un module" et sélectionnez le fichier ZIP téléchargé.
- Une fois l'installation terminée, cliquez sur "Configurer"
Info
Après l'installation, le module crée automatiquement les groupes de cookies par défaut et les tables nécessaires dans la base de données. Il sera nécessaire de configurer le module et d'activer la licence avant de pouvoir utiliser toutes les fonctions.
3. Activation de la licence
Avant de pouvoir utiliser toutes les fonctionnalités du module, il est nécessaire d'activer la licence :- Après l'installation, procéder à la configuration du module
- Sélectionnez l'onglet "Licence
- Saisir la clé de licence reçue après l'achat
- Cliquez sur "Activer la licence"
- Une fois l'activation réussie, un message de confirmation s'affiche et toutes les fonctions du module sont déverrouillées.
Avertissement
Sans licence active, le module fonctionnera en mode restreint, sans toutes les fonctions avancées. Un message indiquant que la licence est inactive s'affiche en haut du panneau d'administration.
4 Panneau de gestion
Le panneau de gestion du module se compose de plusieurs onglets qui permettent une configuration complète :Principaux onglets :
- Cookies - gestion des cookies détectés
- Groupes - gestion des groupes de cookies
- Configuration - paramètres généraux du module et de la bannière
- Mode consentement de Google - Configuration de l'intégration de Google Consent Mode 2.0
- Manuel - instructions et exemples d'utilisation
- Plug-ins - extensions supplémentaires pour le module
- Licence - gestion des licences de modules
Fonctionnalités générales :
- Mise en marche et arrêt du module
- Détection automatique des cookies
- Définir le groupe par défaut pour les cookies nouvellement détectés
- Cacher la bannière aux robots (bots)
- Actualiser la page après avoir modifié les préférences en matière de cookies
- Gestion des révisions de consentement (forcer la réapparition de la bannière)
Conseil
Pour forcer l'affichage de la bannière de consentement pour tous les utilisateurs, augmentez le numéro de révision dans les paramètres généraux du module. Cela est utile, par exemple, après l'introduction de nouvelles catégories de cookies ou une modification de la politique de confidentialité.
5. gestion des cookies
L'onglet "Cookies" vous permet de gérer tous les cookies détectés dans votre boutique :Liste des cookies
- Nom du cookie
- Domaine
- Groupe assigné
- Statut (actif/bloqué)
- Date d'ajout
- Actions disponibles
- Cliquez sur le bouton "Ajouter un nouveau cookie" ou "Modifier" à côté d'un cookie existant.
- Remplir le formulaire de données sur les cookies :
- Nom du cookie - nom unique du cookie
- Domaine - le domaine pour lequel le cookie est stocké
- Chemin d'accès - chemin du cookie (par défaut "/")
- Groupe - l'affectation à un groupe de cookies (par exemple, essentiels, analytiques, marketing)
- Description - description de la fonction du cookie visible par les utilisateurs
- Statut - active ou bloquée
- Cliquez sur "Enregistrer" pour sauvegarder les modifications
Le module offre la possibilité de détecter automatiquement les cookies utilisés dans la boutique. Cette fonction :
- Détecte les nouveaux cookies lors de la navigation sur le site web
- Il les affecte automatiquement aux groupes appropriés sur la base d'une base de données intégrée de noms de cookies.
- Ajout d'une description par défaut pour les cookies reconnus
- Attribue les cookies non reconnus au groupe "Uncategorized".
Note
La détection automatique fonctionne lorsque les utilisateurs naviguent sur le site web. Afin de détecter tous les cookies utilisés, nous vous recommandons de passer en revue les différentes sections de la boutique lorsque cette fonction est activée. Veuillez noter que certains cookies ne peuvent être chargés que sous certaines conditions, par exemple lors de l'ajout d'un produit au panier.
6. gestion des groupes de cookies
L'onglet "Groupes" permet de gérer des catégories de cookies :Groupes par défaut
- Strictement_nécessaire - les cookies nécessaires au fonctionnement du site web
- Fonctionnel - les cookies qui permettent de personnaliser les fonctions
- Statistique/analytique (performance) - les cookies qui recueillent des informations sur le trafic
- Marketing - les cookies utilisés pour la publicité et le profilage
- Non classé - les cookies qui n'ont pas encore été affectés à une catégorie
- Ajouter, modifier et supprimer des groupes (sauf par défaut)
- Paramétrage obligatoire du groupe (les groupes marqués comme obligatoires ne peuvent pas être rejetés par l'utilisateur)
- Définition du statut de l'activité du groupe
- Modifier l'ordre d'affichage des groupes dans la bannière
- Gestion des traductions des noms et des descriptions des groupes
Info
Par défaut, seul le groupe "Strictly_necessary" est marqué comme obligatoire. Cette propriété ne peut pas être modifiée pour le groupe de cookies essentiels par défaut. Ce groupe sera toujours actif, quelle que soit la préférence de l'utilisateur.
7. configurer l'apparence
L'onglet "Configuration" vous permet de personnaliser l'apparence de la bannière de consentement aux cookies :Paramètres des messages
- Titre du message (avec support multilingue)
- Contenu du message (avec prise en charge du multilinguisme)
- Style de la bannière (barre, fenêtre, nuage)
- Position horizontale (gauche, centre, droite)
- Position verticale (haut, milieu, bas)
- Largeur maximale
- Arrondi d'angle
- Ombre
- Couleur de fond
- Couleur du texte
- Couleurs des boutons (arrière-plan et texte) pour "Accepter tout", "Accepter sélectionné" et "Rejeter tout"
- CSS personnalisé
Une mini-bannière est un petit bouton qui s'affiche lorsque la bannière principale est fermée et qui permet à l'utilisateur de rouvrir les paramètres des cookies.
- Position de la mini-bannière (gauche/droite)
- Distance par rapport au bas de la page
- Taille de la mini-bannière
- Forme (ronde, arrondie, carrée)
- Couleur de fond
- Type d'icône (icône matérielle, images prédéfinies, URL personnalisée)
- Couleur de l'icône
- Effet de survol (zoom, rotation, aucun)
Conseil
Le bouton "Afficher l'aperçu de la bannière" vous permet de prévisualiser l'apparence de la bannière avec les paramètres actuels avant d'enregistrer les modifications. Vous pouvez expérimenter différents styles pour trouver l'apparence optimale correspondant à la présentation de votre boutique.
8 Intégration avec Google Consent Mode
L'onglet "Mode de consentement Google" permet de configurer l'intégration du Mode de consentement Google 2.0 :Paramètres généraux
- Activation/désactivation du mode Google Consent
- Déterminer si le code Google Tag est déjà installé dans la boutique
- Entrée Google Tag ID (pour Google Analytics 4 ou Google Tag Manager)
- URL Passthrough - transmission des paramètres de la campagne via l'URL
- Élimination des données publicitaires - suppression des informations relatives à la conversion en l'absence de consentement
- Temps d'attente (ms) - délai avant le lancement des Google Tags
- Attribution de types de consentement Google à chaque groupe de cookies
- Types de consentement disponibles :
- Stockage publicitaire (ad_storage)
- Données relatives à l'utilisateur de la publicité (ad_user_data)
- Personnalisation des annonces
- Stockage des données analytiques (analytics_storage)
- Stockage fonctionnel (functionality_storage)
- Stockage de la personnalisation (personalisation_storage)
- Stockage de sécurité (security_storage)
Avertissement
Pour que le mode de consentement Google fonctionne correctement, il est nécessaire de saisir un ID de balise Google valide (G-XXXXXXXX) ou de sélectionner l'option selon laquelle le code de balise Google/GTM est déjà installé dans le magasin. Sans cela, la fonction ne fonctionnera pas correctement.
9. utilisation du module dans les modèles
Le module propose des fonctions API qui peuvent être utilisées dans les modèles de boutique :Vérification du consentement de l'utilisateur
Dans les modèles Smarty, il est possible de vérifier si un utilisateur a consenti à un groupe spécifique de cookies à l'aide de la fonction cc_ps_cookies_has_consent:
{if {cc_ps_cookies_has_consent group='functional'}}
<div class="alert alert-success">Vous avez donné votre accord pour les cookies fonctionnels !</div>
{else}
<div class="alert alert-warning">Pas de consentement pour les cookies fonctionnels.</div>
{/if}Pour placer un bouton n'importe où dans le modèle qui ouvre la fenêtre de gestion des cookies, vous pouvez utiliser le hookup bouton displayCcPsCookies:
{hook h='displayCcPsCookiesButton'}.{hook h='displayCcPsCookiesButton' class="btn btn-primary btn-sm" text="Paramètres de confidentialité" icon="lock"}Le module fournit également une API JavaScript permettant de vérifier l'état des consentements et d'écouter les modifications qui y sont apportées :
// Sprawdzanie zgody na grupę cookies
if (window.ccPsCoookieConsent && typeof window.ccPsCoookieConsent.hasConsent === 'function') {
if (window.ccPsCoookieConsent.hasConsent('performance')) {
console.log('Zgoda na analityczne pliki cookie została wyrażona!');
// Tutaj możesz inicjalizować np. Google Analytics
}
}
// Nasłuchiwanie na zdarzenie zmiany preferencji cookies
document.addEventListener('cc_ps_cookies_preferences_changed', function(event) {
if (event?.detail?.preferences) {
console.log('Preferencje cookie zostały zmienione:', event.detail.preferences);
}
});Conseil
Des exemples supplémentaires d'utilisation de l'API et une documentation détaillée sont disponibles dans l'onglet "Manuel" du panneau d'administration du module.
10. résolution de problèmes
La bannière des cookies ne s'affiche pas- Vérifiez que le module est activé sous "Configuration"
- S'assurer que la licence est active
- S'assurer que le hook displayFooter est enregistré et fonctionne correctement
- Vérifiez que l'option "Hide from bots" n'est pas activée et que votre navigateur n'est pas identifié comme un robot.
- Vérifier que l'utilisateur n'a pas déjà enregistré ses préférences en matière de cookies - augmenter le numéro de révision pour forcer un réaffichage
- Assurez-vous que la détection automatique des cookies est activée
- Vérifier que les cookies sont affectés aux bons groupes
- S'assurer que le script cookie-blocker.js est correctement chargé
- Vérifier que le site web n'utilise pas un mécanisme de configuration de cookie personnalisé qui contourne la fonction document.cookie standard.
- Assurez-vous que le mode consentement de Google est activé
- Vérifiez que l'ID de la balise Google est correct (pour G-XXXXXXXXXX) ou que le code de la balise Google est déjà installé.
- Assurez-vous que la correspondance entre les groupes de cookies et les catégories Google est correctement configurée.
- Vérifier que le script google-consent-mode.js est correctement chargé
Erreur
Si vous rencontrez des problèmes insolubles avec le module, veuillez vous assurer que vous utilisez la dernière version et que votre boutique PrestaShop est à jour. En cas de difficultés, veuillez contacter le service d'assistance de COCOS à l'adresse suivante cocos.codes/support.
11. FAQ
Le module bloque-t-il automatiquement les cookies auxquels l'utilisateur n'a pas consenti ?Oui, le module bloque automatiquement les cookies qui ont été marqués comme bloqués et qui n'appartiennent pas au groupe auquel l'utilisateur a consenti.
Le module est-il conforme à RODO et à ePrivacy ?
Oui, le module a été conçu conformément aux exigences du RODO et de la directive "vie privée et communications électroniques", ce qui permet aux utilisateurs de donner leur consentement éclairé aux cookies utilisés dans la boutique.
Le module prend-il en charge plusieurs langues ?
Oui, le module prend entièrement en charge le multilinguisme. Le titre, le message et les descriptions des groupes et des cookies peuvent être traduits dans toutes les langues de la boutique.
Puis-je utiliser le module sans le mode Google Consent ?
Oui, l'intégration avec Google Consent Mode est facultative. Vous ne pouvez utiliser le module que pour gérer les consentements relatifs aux cookies sans l'intégration de Google.
Le module fonctionne-t-il avec des outils d'analyse autres que Google Analytics ?
Oui, le module peut être utilisé avec n'importe quel outil analytique via des fonctions API pour vérifier les consentements des utilisateurs. Voir l'onglet "Manuel" pour des exemples d'intégration.
À quelle fréquence le module est-il mis à jour ?
Le module est régulièrement mis à jour afin de garantir la conformité avec les dernières réglementations et exigences techniques. Les détenteurs d'une licence valide ont accès à toutes les mises à jour.
Puis-je transférer la licence à un autre magasin ?
La licence est attribuée à un domaine. Si vous changez de domaine de boutique, veuillez contacter le support COCOS pour transférer la licence.
Le module affecte-t-il les performances de l'atelier ?
Le module a été optimisé pour les performances et ne devrait pas affecter de manière significative le temps de chargement des pages. La détection automatique des cookies peut être désactivée si vous constatez un ralentissement.
