Shortcode-uri, CSS și dezvoltatori

Shortcode-urile [kncc_cookie_policy] și [kncc_cookie_settings], CSS personalizat, API-ul JavaScript, evenimentele, cookie-ul de consimțământ și filtrele.

Shortcode-uri

Shortcode Ce face
[kncc_cookie_policy] Declarația de cookie-uri: cookie-urile pe categorii, alegerea curentă a vizitatorului și un buton Modifică preferințele pentru cookie-uri
[kncc_cookie_settings] Un link care redeschide setările pentru cookie-uri
[kncc_cookie_settings text="Manage cookies"] Același link, cu textul tău

Pune linkul de setări în subsolul sau în meniul site-ului, ca vizitatorii să-și poată schimba oricând alegerea.

Orice element cu clasa kncc-open-settings deschide bannerul la clic:

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

Din JavaScript:

window.knccEditConsent();

CSS personalizat

Fila Documentație din plugin conține un șablon CSS cu toți selectorii folosiți de plugin. Copiază-l în Aspect → Personalizare → CSS suplimentar, în tema ta copil sau într-un plugin pentru fragmente de cod și scoate din comentariu regulile de care ai nevoie.

  • Dacă o regulă nu se aplică, adaugă în fața ei .kncc-banner sau adaugă !important.
  • Cu tipografia în Stilul pluginului, regulile de font folosesc !important. Treci la Stilul temei pentru suprascrieri mai ușoare.
  • Valoarea z-index a bannerului este 999999, iar cea a butonului flotant este 999998. Mărește-le dacă tema ta afișează straturi suprapuse peste banner.

Alegerea este stocată timp de un an în cookie-ul propriu kncc_consent, ca JSON codificat URL:

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

choice este accept, reject sau custom. Citește-l din propriul cod dacă ai nevoie de alegerea vizitatorului, dar nu-l scrie: folosește bannerul sau knccEditConsent().

Evenimente

  • dataLayer: consent_update cu consent_analytics, consent_marketing și consent_preferences, transmis când vizitatorul alege. Vezi Google Consent Mode v2 și Tag Manager.
  • Google Consent Mode: gtag('consent', 'update', …) cu semnalele categoriilor permise.
  • WP Consent API: alegerea este partajată cu pluginurile care acceptă API-ul.

Reținerea propriilor scripturi

Pentru ca propriul tău script să aștepte o categorie, inserează-l cu tipul text/plain și cu categoria:

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

Pluginul îl rulează când vizitatorul permite acea categorie. Fără să atingi codul, o regulă Blocare după adresă din fila Blocare scripturi face același lucru.

Filtre

Filtru Implicit Utilizare
kncc_block_html_scripts true Returnează false pentru a dezactiva blocarea scripturilor din HTML-ul paginii și a celor adăugate ulterior
kncc_block_injected_scripts true Returnează false pentru a dezactiva doar paznicul scripturilor adăugate după încărcarea paginii
kncc_block_iframes true Returnează false pentru a dezactiva blocarea YouTube și Vimeo
// Example: turn off the guard for scripts added after load.
add_filter('kncc_block_injected_scripts', '__return_false');

Actualizat 28 octombrie 2026

Ceva greșit sau lipsă? Spune-mi în forumul de suport. (se deschide într-o filă nouă)