Shortcode, CSS e sviluppatori

Gli shortcode [kncc_cookie_policy] e [kncc_cookie_settings], il CSS personalizzato, l'API JavaScript, gli eventi, il cookie di consenso e i filtri.

Shortcode

Shortcode	Che cosa fa
`[kncc_cookie_policy]`	La dichiarazione dei cookie: i cookie per categoria, la scelta attuale del visitatore e un pulsante “Modifica le preferenze sui cookie”
`[kncc_cookie_settings]`	Un link che riapre le impostazioni dei cookie
`[kncc_cookie_settings text="Manage cookies"]`	Lo stesso link con un testo a tua scelta

Metti il link delle impostazioni nel footer o nel menu, così i visitatori possono sempre cambiare la propria scelta.

Aprire le impostazioni da un tuo link

Qualsiasi elemento con la classe kncc-open-settings apre il banner al clic:

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

Da JavaScript:

window.knccEditConsent();

CSS personalizzato

La scheda Documentazione del plugin contiene un modello CSS con tutti i selettori usati dal plugin. Copialo in Aspetto → Personalizza → CSS aggiuntivo, nel tuo tema child o in un plugin per snippet di codice, e rimuovi il commento dalle regole che ti servono.

Se una regola non viene applicata, anteponi .kncc-banner o aggiungi !important.
Con la tipografia Stile del plugin, le regole dei caratteri usano !important. Passa a Stile del tema per sovrascriverle più facilmente.
Lo z-index del banner è 999999 e quello del pulsante flottante 999998. Aumentali se il tuo tema mostra degli overlay sopra il banner.

La scelta viene memorizzata nel cookie di prima parte kncc_consent per un anno, come JSON codificato in URL:

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

choice vale accept, reject o custom. Leggi il cookie dal tuo codice se ti serve la scelta del visitatore, ma non scriverlo: usa il banner oppure knccEditConsent().

Eventi

dataLayer: consent_update con consent_analytics, consent_marketing e consent_preferences, inviato quando il visitatore sceglie. Vedi Google Consent Mode v2 e Tag Manager.
Google Consent Mode: gtag('consent', 'update', …) con i segnali delle categorie consentite.
WP Consent API: la scelta viene condivisa con i plugin che supportano l’API.

Trattenere i propri script

Per far sì che un tuo script attenda una categoria, stampalo con il tipo text/plain e la categoria:

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

Il plugin lo esegue quando il visitatore consente quella categoria. Senza toccare il codice, una regola Blocca per indirizzo nella scheda Blocco script fa lo stesso.

Filtri

Filtro	Predefinito	Uso
`kncc_block_html_scripts`	`true`	Restituisci `false` per disattivare il blocco degli script nell’HTML della pagina e degli script aggiunti in seguito
`kncc_block_injected_scripts`	`true`	Restituisci `false` per disattivare solo la protezione per gli script aggiunti dopo il caricamento della pagina
`kncc_block_iframes`	`true`	Restituisci `false` per disattivare il blocco di YouTube e Vimeo

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