Shortcodes, CSS y desarrolladores

Los shortcodes [kncc_cookie_policy] y [kncc_cookie_settings], el CSS personalizado, la API de JavaScript, los eventos, la cookie de consentimiento y los filtros.

Shortcodes

Shortcode	Qué hace
`[kncc_cookie_policy]`	La declaración de cookies: las cookies por categoría, la elección actual del visitante y un botón Editar preferencias de cookies
`[kncc_cookie_settings]`	Un enlace que vuelve a abrir la configuración de cookies
`[kncc_cookie_settings text="Manage cookies"]`	El mismo enlace con tu propio texto

Pon el enlace de configuración en tu pie de página o en tu menú, para que los visitantes siempre puedan cambiar su elección.

Abre la configuración desde tu propio enlace

Cualquier elemento con la clase kncc-open-settings abre el banner al hacer clic:

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

Desde JavaScript:

window.knccEditConsent();

CSS personalizado

La pestaña Documentación del plugin tiene una plantilla CSS con todos los selectores que usa el plugin. Cópiala en Apariencia → Personalizar → CSS adicional, en tu tema hijo o en un plugin de fragmentos de código, y quita los comentarios de las reglas que necesites.

Si una regla no se aplica, antepón .kncc-banner o añade !important.
Con la tipografía de Estilo del plugin, las reglas de fuente usan !important. Cambia a Estilo del tema para sobrescribirlas con más facilidad.
El z-index del banner es 999999 y el del botón flotante, 999998. Auméntalos si tu tema muestra capas superpuestas encima del banner.

La elección se guarda en la cookie propia kncc_consent durante un año, como JSON codificado en URL:

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

choice es accept, reject o custom. Léela desde tu propio código si necesitas la elección del visitante, pero no la escribas: usa el banner o knccEditConsent().

Eventos

dataLayer: consent_update con consent_analytics, consent_marketing y consent_preferences, enviado cuando el visitante elige. Consulta Google Consent Mode v2 y Tag Manager.
Google Consent Mode: gtag('consent', 'update', …) con las señales de las categorías permitidas.
WP Consent API: la elección se comparte con los plugins que admiten la API.

Cómo retener tus propios scripts

Para que tu propio script espere a una categoría, imprímelo con el tipo text/plain y la categoría:

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

El plugin lo ejecuta cuando el visitante permite esa categoría. Sin tocar código, una regla Bloquear por dirección en la pestaña Bloqueo de scripts hace lo mismo.

Filtros

Filtro	Valor predeterminado	Uso
`kncc_block_html_scripts`	`true`	Devuelve `false` para desactivar el bloqueo de los scripts en el HTML de la página y de los añadidos más tarde
`kncc_block_injected_scripts`	`true`	Devuelve `false` para desactivar solo el guardián de los scripts añadidos después de cargar la página
`kncc_block_iframes`	`true`	Devuelve `false` para desactivar el bloqueo de YouTube y Vimeo

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