Aller au contenu

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.

  1. 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.

  2. 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_42
    Cas 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.

  3. 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.

  4. 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 only
    Cas 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.

  5. 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_SECONDS
    Cas 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.

  6. Cookies soumis au consentement : jamais depuis PHP

    Un cookie envoyé par votre PHP avec la page est déposé avant que le bandeau ait pu intervenir, et un cache de page peut l’envoyer à tous les visiteurs. Réservez les cookies PHP à ce dont le site ne peut pas se passer, comme le panier.

    À éviter

    // PHP, sent with every page
    setcookie( 'acme_ref', $ref );

    À privilégier

    // JavaScript, after consent
    if ( wp_has_consent( 'marketing' ) ) {
      document.cookie = 'acme_ref=' + ref + '; path=/';
    }
    Cas réels tirés de nos essais
    Mauvaise pratique Vu dans nos essais · Mailchimp for WooCommerce 6.3 · 16 octobre 2026

    Mailchimp for WooCommerce dépose ses cookies depuis PHP pour 28 jours (2 419 200 s, Secure, SameSite=Strict) : mailchimp_campaign_id et mailchimp_email_id quand un visiteur arrive avec ?mc_cid= ou ?mc_eid=, mailchimp_user_email, mailchimp_user_previous_email et mailchimp_cart_token (HttpOnly) pour la relance des paniers, et mailchimp_landing_site sur la première page seulement si le suivi des pages d’arrivée est activé (désactivé par défaut). Une extension de consentement ne peut pas les retenir ; tous passent par le filtre mailchimp_allowed_to_use_cookie.

    Voir la page complète

    Mauvaise pratique Vu dans nos essais · W3 Total Cache 2.11.0 · 13 novembre 2026

    Avec le cache des pages, W3 Total Cache sert les pages en cache depuis advanced-cache.php avant le chargement des extensions WordPress (Disk: Basic), ou directement depuis le serveur web (Disk: Enhanced). Aucune extension de consentement ne peut modifier les en-têtes de ces réponses : avec un « Referrer Group » actif, w3tc_referrer peut être déposé avant tout choix, et un cookie refusé n’expire pas avant une page hors cache.

  7. 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.

    Voir la page complète

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.

  1. 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 ) );
  2. 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>
  3. 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(); }
    } );
  4. 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/plain alone, 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
    }
  5. 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

Mauvaise pratique Vu dans nos essais · Kadence theme 1.5.2, Kadence Blocks 3.8.0 · 16 octobre 2026

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.