Shortcodes, CSS e programadores

Os shortcodes [kncc_cookie_policy] e [kncc_cookie_settings], CSS personalizado, a API JavaScript, os eventos, o cookie de consentimento e os filtros.

Shortcodes

Shortcode	O que faz
`[kncc_cookie_policy]`	A declaração de cookies: os cookies por categoria, a escolha atual do visitante e um botão Editar preferências de cookies
`[kncc_cookie_settings]`	Um link que volta a abrir as definições de cookies
`[kncc_cookie_settings text="Manage cookies"]`	O mesmo link com o seu próprio texto

Coloque o link das definições no rodapé ou no menu, para que os visitantes possam sempre alterar a sua escolha.

Abrir as definições a partir de um link seu

Qualquer elemento com a classe kncc-open-settings abre o banner ao ser clicado:

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

A partir de JavaScript:

window.knccEditConsent();

CSS personalizado

O separador Documentação do plugin tem um modelo de CSS com todos os seletores que o plugin utiliza. Copie-o para Aspeto → Personalizar → CSS adicional, para o seu tema filho ou para um plugin de snippets de código, e descomente as regras de que precisa.

Se uma regra não for aplicada, anteponha-lhe .kncc-banner ou adicione !important.
Com a tipografia do Estilo do plugin, as regras de tipo de letra usam !important. Mude para o Estilo do tema para facilitar as substituições.
O z-index do banner é 999999 e o do botão flutuante é 999998. Aumente-os se o seu tema mostrar sobreposições por cima do banner.

A escolha é guardada no cookie próprio kncc_consent durante um ano, como JSON codificado em URL:

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

choice é accept, reject ou custom. Leia-o a partir do seu próprio código se precisar da escolha do visitante, mas não o escreva: use o banner ou knccEditConsent().

Eventos

dataLayer: consent_update com consent_analytics, consent_marketing e consent_preferences, enviado quando o visitante escolhe. Veja Google Consent Mode v2 e Tag Manager.
Google Consent Mode: gtag('consent', 'update', …) com os sinais das categorias permitidas.
WP Consent API: a escolha é partilhada com os plugins que suportam a API.

Reter os seus próprios scripts

Para que um script seu aguarde por uma categoria, emita-o com o tipo text/plain e a categoria:

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

O plugin executa-o quando o visitante permite essa categoria. Sem mexer no código, uma regra Bloquear por endereço no separador Bloqueio de scripts faz o mesmo.

Filtros

Filtro	Predefinição	Utilização
`kncc_block_html_scripts`	`true`	Devolva `false` para desativar o bloqueio de scripts no HTML da página e de scripts adicionados mais tarde
`kncc_block_injected_scripts`	`true`	Devolva `false` para desativar apenas o guarda dos scripts adicionados depois de a página carregar
`kncc_block_iframes`	`true`	Devolva `false` para desativar o bloqueio do YouTube e do Vimeo

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