Shortcodes, CSS et développeurs

Les shortcodes [kncc_cookie_policy] et [kncc_cookie_settings], le CSS personnalisé, l’API JavaScript, les événements, le cookie de consentement et les filtres.

Shortcodes

Shortcode	Ce qu’il fait
`[kncc_cookie_policy]`	La déclaration des cookies : les cookies par catégorie, le choix actuel du visiteur et un bouton Modifier mes préférences de cookies
`[kncc_cookie_settings]`	Un lien qui rouvre les paramètres des cookies
`[kncc_cookie_settings text="Manage cookies"]`	Le même lien avec votre propre texte

Placez le lien des paramètres dans votre pied de page ou votre menu, pour que les visiteurs puissent toujours modifier leur choix.

Ouvrir les paramètres depuis votre propre lien

Tout élément portant la classe kncc-open-settings ouvre la bannière au clic :

<a href="#" class="kncc-open-settings">Cookie settings</a>

Depuis JavaScript :

window.knccEditConsent();

CSS personnalisé

L’onglet Documentation de l’extension contient un modèle CSS avec tous les sélecteurs que l’extension utilise. Copiez-le dans Apparence → Personnaliser → CSS additionnel, dans votre thème enfant ou dans une extension de snippets de code, et décommentez les règles dont vous avez besoin.

Si une règle ne s’applique pas, préfixez-la avec .kncc-banner ou ajoutez !important.
Avec la typographie Style de l’extension, les règles de police utilisent !important. Passez au Style du thème pour des remplacements plus faciles.
Le z-index de la bannière est 999999 et celui du bouton flottant 999998. Augmentez-les si votre thème affiche des éléments superposés au-dessus de la bannière.

Le choix est stocké dans le cookie propriétaire kncc_consent pendant un an, sous forme de JSON encodé pour une URL :

{ "necessary": true, "analytics": true, "marketing": false, "preferences": false, "choice": "custom", "timestamp": "2026-10-28T09:00:00.000Z" }

choice vaut accept, reject ou custom. Lisez-le depuis votre propre code si vous avez besoin du choix du visiteur, mais ne l’écrivez pas : utilisez la bannière ou knccEditConsent().

Événements

dataLayer : consent_update avec consent_analytics, consent_marketing et consent_preferences, envoyé lorsque le visiteur fait un choix. Voir Google Consent Mode v2 et Tag Manager.
Google Consent Mode : gtag('consent', 'update', …) avec les signaux des catégories autorisées.
WP Consent API : le choix est partagé avec les extensions qui prennent l’API en charge.

Retenir vos propres scripts

Pour qu’un de vos scripts attende une catégorie, insérez-le avec le type text/plain et la catégorie :

<script type="text/plain" data-kncc-category="marketing" src="https://example.com/widget.js"></script>

L’extension l’exécute lorsque le visiteur autorise cette catégorie. Sans toucher au code, une règle Bloquer par adresse dans l’onglet Blocage des scripts fait la même chose.

Filtres

Filtre	Valeur par défaut	Utilisation
`kncc_block_html_scripts`	`true`	Renvoyez `false` pour désactiver le blocage des scripts dans le HTML de la page et des scripts ajoutés plus tard
`kncc_block_injected_scripts`	`true`	Renvoyez `false` pour désactiver uniquement le garde-fou des scripts ajoutés après le chargement de la page
`kncc_block_iframes`	`true`	Renvoyez `false` pour désactiver le blocage de YouTube et de Vimeo

// Example: turn off the guard for scripts added after load.
add_filter('kncc_block_injected_scripts', '__return_false');