Pour les développeurs d’extensions et de thèmes
Nommez bien vos cookies et vos clés de stockage dès le départ
Les outils de consentement classent chaque cookie et chaque clé de stockage d’après son nom. Un nom trop générique, ou déjà pris par un autre outil, se retrouve dans la mauvaise catégorie, ou bloqué avec autre chose. Vérifiez vos noms ici avant de publier votre extension.
Essayez :
- 3 643 noms connus issus de 867 outils, extensions et thèmes
- Gratuit, sans inscription
- Mis à jour à chaque version de Cookie Rocks
Exemple popup_closed
Trop générique
Rien n’indique qu’il vous appartient. Un outil de consentement ne peut pas le reconnaître, et une autre extension peut utiliser le même nom.
Mieux : my_plugin_popup_closed
Huit bonnes pratiques
Chacune de ces pratiques ne prend qu’une minute quand vous écrivez le code. Elle épargne à ceux qui installent votre extension un après-midi de travail, et un bandeau de consentement qui se trompe.
Donnez à chaque nom un préfixe bien à vous
Faites commencer chaque cookie et chaque clé de stockage par votre slug. Un outil de consentement peut alors retenir tous vos noms par un seul motif,
acme_*, y compris ceux que vous ajouterez l’an prochain.À éviter
setcookie( 'popup_closed', '1' ); localStorage.setItem( 'recent', ids );À privilégier
setcookie( 'acme_popup_closed', '1' ); localStorage.setItem( 'acme_recent', ids );Cas réels tirés de nos essais
Mauvaise pratique Vu dans nos essais · Kadence theme 1.5.2, Kadence Blocks 3.8.0 · 16 octobre 2026 Le compte à rebours evergreen de Kadence Blocks dépose dès la première page un cookie propre au site, nommé <site name slug>-<campaign id>, pour 30 jours, afin de conserver l’échéance de chaque visiteur. Le bouton grille ou liste du thème dépose <site name slug>-shopLayout pour 30 jours, mais seulement après un clic. Ni le thème ni Kadence Blocks ne contiennent de code WP Consent API ou gtag('consent'). Les captchas des formulaires (reCAPTCHA, Turnstile, hCaptcha) sont indispensables à leur envoi.
Mettez la partie variable à la fin
When a name needs an ID, a widget or a campaign, add it at the end. A name that starts with a number or the site’s name cannot be matched from one site to the next.
À éviter
my-shop-42 42_countdownÀ privilégier
acme_countdown_42Cas réels tirés de nos essais
Mauvaise pratique Vu dans nos essais · JetElements 2.7.12.1 · 17 novembre 2026 Réglé sur Evergreen, un Countdown Timer garde pour chaque visiteur sa propre échéance dans le stockage local (jet_evergreen_countdown_due_date_<widget> et _interval_<widget>), dès la première page qui l’affiche, sans date d’expiration.
Ne déposez rien avant d’en avoir besoin
Déposez un cookie au moment où le visiteur fait l’action que ce cookie retient. Un cookie déposé après un clic s’explique facilement. Un cookie déposé à chaque première visite doit attendre le consentement, sauf si le site ne peut pas s’en passer.
À éviter
// on every page, just in case setcookie( 'acme_visited', '1' );À privilégier
// when the visitor closes the pop-up close.addEventListener( 'click', () => { document.cookie = 'acme_popup_closed=1; max-age=86400; path=/'; } );Cas réels tirés de nos essais
Mauvaise pratique Vu dans nos essais · Premium Addons for Elementor 4.11.119 · 13 novembre 2026 Quand une page contient un élément avec la condition d’affichage « Return Visitor », Premium Addons dépose PaVisitorData (1 an) et PaNewVisitor (1 jour) dès la première page pour chaque visiteur, afin de montrer un contenu différent à ceux qui reviennent. Notre veille juridique classe ce suivi en marketing : consentement d’abord.
Bons et mauvais élèves Vu dans nos essais · WoodMart, Soledad, XStore 8.5.7.1, 8.5.4, 9.6.2 · 12 novembre 2026 Les pop-ups de vérification de l’âge retiennent la réponse du visiteur dans un cookie : woodmart_age_verify pour 30 jours (WoodMart), penci_age_verify pour 30 jours (Soledad), age_verify_popup_shows pour 1 jour (XStore). WoodMart ne dépose son cookie qu’après un clic sur « I am 18 or Older » ; après « I am Under 18 », rien n’est déposé et le pop-up revient à la page suivante (XTemos, 13/11/2026). Notre veille juridique les classe comme nécessaires, mais conseille de garder la réponse le temps de la visite au plus : une durée plus longue est à éviter.
Souvent, le mieux est de ne rien stocker
Le stockage du navigateur compte comme un cookie au sens de la règle ePrivacy : y déplacer une valeur ne change rien au consentement. Un état qui ne sert que sur la page en cours peut rester dans une variable.
À éviter
localStorage.setItem( 'acme_tab', 'reviews' );À privilégier
let acmeTab = 'reviews'; // for this page onlyCas réels tirés de nos essais
Bonne pratique Vu dans nos essais · W3 Total Cache 2.10.7 · 16 octobre 2026 Par défaut, W3 Total Cache ne dépose aucun cookie chez les simples visiteurs anonymes. Ses cookies : w3tc_logged_out (session, à la déconnexion), w3tc_logged_<role hash> (utilisateurs connectés d’un rôle exclu), w3tc_preview (aperçu dans l’administration) et, seulement si un Referrer Group est activé, w3tc_referrer (session, déposé sur la première page vue en arrivant d’un autre site). Par défaut, il n’ajoute aucun hôte tiers aux pages des visiteurs ; son suivi d’utilisation par Google Analytics ne tourne que dans l’administration, et reste désactivé tant que l’administrateur ne l’a pas accepté. Il n’utilise pas WP Consent API et ne définit aucun état par défaut pour Consent Mode.
Pas de suivi sans accord : WP Consent API
Do not guess whether the visitor agreed. WP Consent API gives every consent plugin the same answer to read, in PHP and in JavaScript, and tells you when it changes.
À éviter
acmeLoadPixel(); // and hope a banner blocks itÀ privilégier
function acmeStart() { if ( typeof wp_has_consent === 'function' && ! wp_has_consent( 'marketing' ) ) { return; } acmeLoadPixel(); } acmeStart(); document.addEventListener( 'wp_listen_for_consent_change', acmeStart );Cas réels tirés de nos essais
En cours de correction Vu dans nos essais · Premium Addons for Elementor · 15 novembre 2026 L’éditeur de Premium Addons indique que la condition d’affichage « Returning Visitor », qui dépose le cookie PaVisitorData pour un an dès la première page, suivra WP Consent API dans la prochaine version de l’extension. Pas encore publiée : nous la testerons dès sa sortie.
Choisissez une durée courte et indiquez-la
Choisissez la durée la plus courte qui fasse l’affaire, et notez-la dans votre documentation. Dans le stockage local, une valeur n’a pas de date d’expiration : elle reste des années.
The visitor’s yes may end first, and browsers cut long dates anyway: Durée des cookies, and for the code, Cookie lifetimes: good practice.
À éviter
'expires' => time() + 10 * YEAR_IN_SECONDSÀ privilégier
'expires' => time() + DAY_IN_SECONDSCas réels tirés de nos essais
Bons et mauvais élèves Vu dans nos essais · WoodMart, Soledad, XStore 8.5.7.1, 8.5.4, 9.6.2 · 12 novembre 2026 Les pop-ups de vérification de l’âge retiennent la réponse du visiteur dans un cookie : woodmart_age_verify pour 30 jours (WoodMart), penci_age_verify pour 30 jours (Soledad), age_verify_popup_shows pour 1 jour (XStore). WoodMart ne dépose son cookie qu’après un clic sur « I am 18 or Older » ; après « I am Under 18 », rien n’est déposé et le pop-up revient à la page suivante (XTemos, 13/11/2026). Notre veille juridique les classe comme nécessaires, mais conseille de garder la réponse le temps de la visite au plus : une durée plus longue est à éviter.
Ne rétablissez jamais un identifiant supprimé
Quand le visiteur refuse ses cookies ou les supprime, l’identifiant disparaît. Le rétablir à partir d’une copie va à l’encontre de ce choix, et les outils de consentement y voient du suivi.
À éviter
if ( ! getCookie( 'acme_uid' ) ) { setCookie( 'acme_uid', localStorage.getItem( 'acme_uid_copy' ) ); }À privilégier
if ( ! getCookie( 'acme_uid' ) && wp_has_consent( 'statistics' ) ) { setCookie( 'acme_uid', crypto.randomUUID() ); // a new one }Cas réels tirés de nos essais
Mauvaise pratique Vu dans nos essais · 14 octobre 2026 Criteo garde son identifiant publicitaire cto_bundle dans le stockage local en plus d’un cookie. Une fois le cookie supprimé, l’ancien identifiant est renvoyé à Criteo (et, sur un site, à une quinzaine d’enchérisseurs publicitaires), puis le cookie revient avec une nouvelle valeur. Supprimer seulement les cookies n’empêche donc pas de reconnaître le visiteur.
When your code runs: not too early, not too late, not from PHP
A consent tool can only hold what it sees, when it sees it. Too early, your code runs before the visitor is asked. Too late, or loaded by another script, it slips past. From PHP, it reaches the visitor before any banner, and a cached page sends it to everyone. What Cookie Rocks does with your scripts.
Be in the page, where a consent tool can see you
Consent tools hold the scripts they recognise in the HTML of the page, before it reaches the browser. A script added later by another script is only held if the script that adds it is held too.
À éviter
// an inline loader nobody recognises const s = document.createElement( 'script' ); s.src = 'https://cdn.acme.example/track.js'; document.head.append( s );À privilégier
wp_enqueue_script( 'acme-tracker', plugins_url( 'js/acme-tracker.js', __FILE__ ), array(), '1.4', array( 'strategy' => 'defer', 'in_footer' => true ) );Not too early: nothing that writes while the page loads
Inline code that writes a cookie or a storage key while the page is read runs before the visitor is asked. If it must stay inline, mark it with its category: consent tools that read this syntax release it after the yes.
À éviter
<script> document.cookie = 'acme_seen=1; path=/'; </script>À privilégier
<script type="text/plain" data-category="statistics"> document.cookie = 'acme_seen=1; max-age=86400; path=/'; </script>Decide in the browser, not in PHP
Pages are cached: the same HTML goes to every visitor, and PHP does not run again. A choice read in PHP follows the first visitor, not the next one. Read it in JavaScript, and listen for changes.
À éviter
// PHP: the cached page keeps this answer if ( wp_has_consent( 'statistics' ) ) { wp_enqueue_script( 'acme-stats' ); }À privilégier
// JavaScript, with WP Consent API if ( wp_has_consent( 'statistics' ) ) { acmeStart(); } document.addEventListener( 'wp_listen_for_consent_change', ( e ) => { if ( e.detail.statistics === 'allow' ) { acmeStart(); } } );Optimisers: keep held scripts held
Plugins that combine or delay JavaScript can turn a held script back into a live one, or merge it into a file that always runs. Leave scripts of type
text/plainalone, and keep consent scripts out of combining and delaying.À éviter
// every script, held or not $tag = str_replace( 'text/plain', 'text/javascript', $tag );À privilégier
if ( str_contains( $tag, 'type="text/plain"' ) ) { return $tag; // held by a consent tool: leave it }Tag managers: check the consent, not only the event
A consent event also fires after a refusal. A tag that fires on the event alone runs whatever the answer. Use the built-in consent checks, or add a condition on the value.
À éviter
Trigger: Custom Event cr_consent_updateÀ privilégier
Consent check: ad_storage or Trigger: cr_consent_update where cr_consent.marketing equals true
À décider dès le départ
Bien faire dès le départ coûte peu. Changer ensuite coûte cher, une fois que des milliers de sites reposent sur vos réglages par défaut.
Polices
À éviter : Les polices Google Fonts chargées depuis les serveurs de Google
À privilégier : Inclure les fichiers de police dans l’extension, ou activer par défaut « charger les polices localement ». Chaque requête vers un autre serveur transmet l’adresse IP du visiteur. Les polices web et la loi
Vidéos et cartes
À éviter : Une iframe dans la page
À privilégier : Un aperçu avec un bouton de lecture ou d’affichage, et l’iframe seulement après le clic
Bibliothèques
À éviter : Un script chargé depuis un CDN public
À privilégier : Le fichier inclus dans votre extension, ou la copie que WordPress fournit déjà (jQuery, par exemple)
Captchas
À éviter : Le script du captcha sur toutes les pages
À privilégier : Le script uniquement sur le formulaire, chargé dès que le visiteur commence à le remplir
Statistiques
À éviter : Un traceur qui démarre au chargement de la page
À privilégier : Ne le lancer qu’après le consentement, vérifié par WP Consent API
Réglages mémorisés
À éviter : Un cookie pour chaque option
À privilégier : Le serveur, une requête média CSS comme
prefers-color-scheme, ou la mémoire de la page en cours
Le thème Kadence charge fonts.googleapis.com (avec une préconnexion à fonts.gstatic.com) dès qu’une police Google est choisie ; le réglage Load Google Fonts Locally (Customizer > General > Performance) est désactivé par défaut. Kadence Blocks insère ses Google Fonts par des balises link directes dans wp_head (priorité 85) et wp_footer, sans handle de style. Il suit le réglage du thème ; sans le thème, il a son propre réglage de chargement local, lui aussi désactivé par défaut.
Test against the next Cookie Rocks
Your users will update. Check your plugin or theme against the next version before it ships: on a test site, add one line to wp-config.php, and WordPress offers the beta versions of Cookie Rocks Pro, and of the Audit installed from cookierocks.com.
define( 'COOKIE_ROCKS_CHANNEL', 'beta' );
Test sites only: a beta can still change before the stable version. Remove the line to go back to stable versions, and tell our support about anything that breaks. Details: the beta channel.
Rédigez la section de votre readme en une minute
Indiquez chaque nom, son type, sa durée et son rôle. Les outils de consentement lisent cette section, tout comme les propriétaires de sites et leurs avocats. Remplissez les lignes, puis copiez le résultat dans votre readme.
Ensuite, prévenez-nous. Cookie Rocks enregistre chaque nouveau nom, avec sa catégorie, dans sa version suivante, pour qu’il soit retenu correctement sur tous les sites qui utilisent votre extension : envoyez-nous vos noms. Pour une intégration directe avec Cookie Rocks, consultez les filtres PHP et événements JavaScript.
WordPress has its own privacy tools for plugins: suggest text for the site’s privacy policy with wp_add_privacy_policy_content(), and add the data your plugin keeps to the personal data export and erasure tools. See Privacy in the Plugin Handbook.
