Aller au contenu

Page Développeurs

← Les écrans de Cookie Rocks

À quoi sert cet écran. L’écran Développeurs du menu Cookie Rocks indique à la personne qui construit ou maintient le site avec quoi Cookie Rocks a été testé, et quels cookies il connaît.

La page Développeurs de Cookie Rocks, avec le tableau de compatibilité et les cookies connus
Cookie Rocks 2.12.3 · Cliquer pour agrandir

Ce qu’il faut faire ici

  1. Dans Compatibilité, comparez la colonne Testé avec la colonne Sur ce site. Les extensions et thèmes installés sur votre site viennent en premier.
  2. Dans Services reconnus, tapez un nom sous Trouver un service pour chercher les outils qu’utilise votre site. Un outil absent de la liste apparaît comme un script inconnu sur l’écran Cookies, où vous pouvez le signaler.

L’écran n’a aucun réglage. Une table des matières, Sur cette page, se trouve en haut. La référence complète pour les développeurs est sur ce site, sous Développeurs.

Compatibilité

L’introduction donne la date de la dernière vérification : « Une version plus récente fonctionne en général ; elle est testée pour la version suivante. » Le tableau a trois colonnes :

  • Logiciel : WordPress, PHP, puis les extensions et les thèmes.
  • Testé : la version testée et sa date, avec une étiquette qui dit comment. Pour WordPress et PHP, la version testée et la version minimale.
  • Sur ce site : la version installée sur votre site, ou Non installée.

WordPress, PHP et les extensions et thèmes installés sur votre site figurent dans le tableau. Les autres sont repliés sous Autres extensions et thèmes testés, avec leur nombre. Tapez un nom sous Trouver une extension ou un thème : la section repliée qui le contient s’ouvre.

ÉtiquetteCe que cela signifie
Testé à chaque versionTesté automatiquement avant chaque version de Cookie Rocks.
Testé sur un site en ligneEssayé sur un vrai site, à la date indiquée.
Testé automatiquement avec sa dernière versionInstallé depuis WordPress.org dans un WordPress de test, dans sa dernière version, et testé avec Cookie Rocks.
Reproduit dans les testsSon comportement est reproduit dans les tests, sans l’extension elle-même.
Écrit d’après sa documentationPrise en charge écrite d’après la documentation de son éditeur, pas encore essayée pour de vrai.

La liste s’allonge à chaque version de Cookie Rocks. Le tableau de votre administration fait référence pour la version que vous utilisez.

Services reconnus

Les 842 outils dont Cookie Rocks reconnaît les cookies dans vos pages, avec leur logo, dans une section repliée par catégorie : Nécessaires, Préférences, Statistiques, Marketing, chacune avec son nombre. Tapez un nom sous Trouver un service pour trouver un outil. La colonne À quoi il sert donne la finalité de chacun. L’analyse de l’écran Cookies dit ensuite, pour chaque outil trouvé sur votre site, s’il se charge avant le choix du visiteur.

Changer l’apparence avec du CSS (Pro)

Cette section n’apparaît qu’avec Cookie Rocks Pro : l’Audit n’ajoute aucun bandeau. Ajoutez votre CSS là où votre site garde déjà le sien :

  • Apparence, Personnaliser, CSS additionnel (thèmes classiques) ;
  • Apparence, Éditeur, Styles, CSS additionnel (thèmes à blocs) ;
  • le champ de CSS personnalisé de votre thème ou de votre constructeur de pages ;
  • la feuille de style de votre thème enfant.

Commencez par les variables : une ligne change tout le bandeau. Utilisez le sélecteur .cr-root[data-theme] pour que vos valeurs s’appliquent en thème clair et sombre. L’écran montre cet exemple, avec un bouton Copier :

/* Square corners and a lighter shadow, in light and dark themes */
.cr-root[data-theme] {
	--cr-radius: 6px;
	--cr-shadow: 0 8px 24px rgba(0, 0, 0, .12);
}

/* Buttons in capital letters */
.cr-root .cr-btn {
	text-transform: uppercase;
	letter-spacing: .04em;
}

Si votre CSS n’a aucun effet, vérifiez l’écran Apparence. Quand vous y changez une valeur, le bandeau l’écrit sur l’élément .cr-root lui-même, et cette valeur l’emporte sur votre feuille de style. Cela concerne --cr-accent, --cr-accent-text, --cr-radius et --cr-gap, ainsi que l’ombre quand Ombres est désactivé. Gardez la valeur par défaut sur l’écran Apparence (20 px pour les coins et la distance), ou ajoutez !important à votre valeur.

Variables

VariableCe qu’elle règle
--cr-accentCouleur d’accent : boutons et interrupteurs. Elle se règle sur l’écran Apparence.
--cr-accent-textTexte sur la couleur d’accent. Choisi automatiquement pour rester lisible.
--cr-bgFond du bandeau et du détail.
--cr-fgTexte principal.
--cr-mutedTexte secondaire.
--cr-lineBordures et séparations.
--cr-softFonds clairs : le bouton « Je choisis », les catégories.
--cr-trackInterrupteurs désactivés.
--cr-shadowOmbre du bandeau et du détail. Quand Ombres est désactivé sur l’écran Apparence, aucune ombre n’est affichée, quelle que soit cette valeur.
--cr-radiusCoins arrondis, en pixels. Se règle sur l’écran Apparence.
--cr-gapDistance entre le bandeau et les bords de l’écran, en pixels. Se règle sur l’écran Apparence.

--cr-gap règle la distance entre la boîte flottante et les bords de l’écran : 20 px par défaut. Le réglage Distance aux bords de l’écran de l’écran Apparence va de 0 à 40 px. À 0, la boîte se place dans le coin, et ses coins du côté de l’écran sont carrés. La barre en bas de page ne change pas. Sur un téléphone, la distance est de 8 px au plus.

Classes

ClasseÉlément
.cr-rootContient tout. Attributs : data-theme (auto, light, dark), data-layout (box, bar, et minimal pour la boîte discrète), data-position (left, right).
.cr-bannerLe bandeau.
.cr-eyebrow, .cr-title, .cr-textNom du site, titre et texte du bandeau.
.cr-btn--solidBoutons « Tout refuser » et « Tout accepter » du bandeau, avec la même apparence. Dans le détail, le bouton « Enregistrer mes choix ».
.cr-btn--outline« Tout refuser » et « Tout accepter » dans le détail. Dans le bandeau, « Tout refuser » quand « Tout accepter » est mis en avant sur l’écran Apparence.
.cr-btn--softBouton « Je choisis ».
.cr-dialogLa fenêtre du détail, avec .cr-cat pour chaque catégorie et .cr-switch pour les interrupteurs.
.cr-widgetLe bouton cookie.
.cr-toastLe court message après un choix.
.cr-form-noticeLa demande affichée au-dessus des formulaires protégés par reCAPTCHA.
.cr-manage-linkLe lien « Gérer les cookies » du code court.
.cr-policy, .cr-policy__serviceLa politique de cookies du code court, et la carte de chaque outil qu’elle contient.

.cr-policy__credit est le cadre fin de la mention en bas de la politique de cookies, quand Mention est cochée sur l’écran Consentement. Son style est écrit dans l’élément lui-même, pour qu’il s’adapte à tous les thèmes.

Les espaces réservés des vidéos et des cartes sont dessinés dans leur propre cadre : ils suivent la couleur d’accent, pas votre CSS. Tant que le panneau du détail est ouvert, l’élément html porte la classe cr-locked.

Retenir un script, codes courts, comptes, pages de paiement, formulaires, JavaScript, filtres PHP (Pro)

Ces sept sections n’apparaissent qu’avec Cookie Rocks Pro. Elles donnent un court résumé, avec du code à copier :

  • Retenir un script jusqu’au consentement : les cookies connus sont retenus automatiquement. Pour un autre script, changez son type et ajoutez la catégorie, par exemple <script type="text/plain" src="…">, ou <iframe> pour un cadre. Après le consentement, les scripts retenus se téléchargent ensemble et s’exécutent dans l’ordre de la page. Un script qui met plus de 3 secondes à arriver cesse de retarder les suivants : le code qui appelle un outil juste après son script doit attendre que cet outil soit prêt. Voir API JavaScript et événements.
  • Dans la même section, pour laisser un script se charger tout de suite : ajoutez l’attribut data-cr-ignore à un script ou à une feuille de style, et Cookie Rocks n’y touche pas, avant tout choix, même s’il appartient à un service connu. Ne l’utilisez que pour du code qui ne pose aucun cookie et n’envoie aucune donnée personnelle, ou que la loi laisse charger sans consentement. Cela ne s’applique pas aux iframes.
  • Codes courts : un tableau des codes courts, chacun avec un bouton Copier : [cookie_rocks_link] (lien « Gérer les cookies »), [cookie_rocks_link as="button"], [cookie_rocks_link text="Cookie settings"], [cookie_rocks_link type="policy"], [cookie_rocks_link type="privacy"], [cookie_rocks_policy], [cookie_rocks_policy title="1"], [cookie_rocks_policy width="60rem"] et, pour les États-Unis, [cookie_rocks_link type="do-not-sell"]. Ils écrivent leur texte dans la langue de la page. Sans code court, un lien de menu vers #cr-preferences, ou tout élément doté de l’attribut data-cr-open, rouvre les choix. Voir Codes courts.
  • Comptes gérés hors de WordPress : quand le signal GPC est respecté, un refus suit le compte du visiteur. Les comptes WordPress (WooCommerce, adhésions) n’ont besoin de rien. Si vos clients se connectent avec un autre système, appelez do_action( 'cookie_rocks_account', $customer_id ); sur chaque page qu’ils voient une fois connectés, avant tout affichage (sur init, par exemple). Seule une empreinte de l’identifiant est conservée.
  • Pages de paiement sans extension de boutique : avec « Charger les scripts de paiement et de lutte contre la fraude sans accord seulement sur les pages du panier, du paiement et du compte », Cookie Rocks reconnaît ces pages grâce à WooCommerce et Easy Digital Downloads. Sur un autre site, déclarez vos pages de paiement avec le filtre cookie_rocks_protected_page, sinon les outils de paiement y attendent aussi le consentement.
  • Formulaires hors du contenu de la page : la protection contre le spam qui observe le comportement des visiteurs (CleanTalk) se charge sans consentement uniquement sur les pages qui ont un formulaire. Cookie Rocks trouve les formulaires de commentaires et les formulaires du contenu de la page. Pour un formulaire placé par votre thème ou dans un widget, déclarez ses pages avec le filtre cookie_rocks_form_page. Voir Filtres PHP, actions et API REST.
  • JavaScript : CookieRocks.open(), CookieRocks.hasConsent(), CookieRocks.onConsent(), l’événement cookie-rocks:change, et les événements Google Tag Manager cr_consent_ready et cr_consent_update, avec la variable cr_consent. Voir API JavaScript et événements.
  • Filtres PHP : cookie_rocks_texts, cookie_rocks_categories, cookie_rocks_services, cookie_rocks_config, cookie_rocks_gcm_map. Voir Filtres PHP, actions et API REST, qui liste tous les crochets.

Ce que Cookie Rocks Pro enregistre dans le navigateur de vos visiteurs

Cette page liste les cookies et les clés de stockage qu’écrit Cookie Rocks Pro, avec leur durée et leur rôle. Copiez-les dans votre politique de cookies ou dans la documentation de votre client. À chaque version, un contrôle compare cette liste avec le code.

NomTypeDuréeÀ quoi il sert
crocks_consentCookieSelon le réglage de la page ConsentementLe choix du visiteur : catégories et outils acceptés, date, identifiant aléatoire. Écrit quand le visiteur choisit. Sur un réseau multisite, un cookie par site : crocks_consent_<id>.
wp_consent_*CookieSelon le réglage de la page ConsentementUne copie du choix pour WP Consent API, un cookie par catégorie, seulement quand cette extension est active.
crocks_countryCookieJusqu’à la fermeture de l’ongletLe pays du visiteur, indiqué par votre serveur ou votre CDN, seulement avec la source du pays « cookie ». Son ancien nom, cr_country, est toujours lu.
crocks_geoStockage de sessionJusqu’à la fermeture de l’ongletLes règles du pays du visiteur, gardées pour les pages suivantes, seulement avec les règles par pays.
crocks_formsStockage de sessionJusqu’à la fermeture de l’ongletCe que le visiteur a saisi dans un formulaire retenu jusqu’au consentement, rétabli après le rechargement de la page.
crocks_gpcStockage localJusqu’à ce que le visiteur l’effaceIndique que le refus envoyé par le navigateur (GPC) a été enregistré comme preuve, une fois par navigateur.

Cookie Rocks Audit, l’extension gratuite, n’écrit rien dans le navigateur de vos visiteurs.

Santé du site

Dans Outils, Santé du site, l’onglet Informations contient une section Cookie Rocks : les versions de l’Audit et du Pro, les pays de votre profil, la date de la dernière analyse, un autre bandeau de cookies s’il en a été trouvé un, et WP Consent API. Copiez-la dans votre demande de support.

Étape suivante : Licence