Consent Manager

Consent Manager es un módulo opcional que añade un banner nativo de consentimiento de cookies con categorías, señalización de Google Consent Mode v2 y un registro de las decisiones tomadas por los visitantes. Otros módulos pueden “bloquear” sus scripts e iframes para que solo se ejecuten una vez que el visitante concede la categoría correspondiente.

El módulo proporciona herramientas que le ayudan a recopilar y respetar las decisiones de consentimiento. Por sí mismo no garantiza ningún resultado legal concreto y no sustituye al asesoramiento jurídico.

Activar el módulo

El módulo está desactivado de forma predeterminada. Actívelo en WooCommerce > Polski > Módulos (la sección “Consent Manager”, clave del módulo consent_manager). Una vez activado, el banner se muestra en el pie de página de la tienda y en el panel de administración queda disponible una vista Registros de consentimiento. Esa vista y la exportación a CSV requieren la capacidad manage_woocommerce.

Categorías de consentimiento

El banner utiliza un conjunto fijo de categorías. La categoría “Necesarias” siempre está concedida y no se puede desactivar. Las otras tres son opcionales y el visitante puede activarlas o desactivarlas.

Categoría	Clave	Predeterminado	Descripción
Necesarias	necessary	siempre activa	Necesarias para el funcionamiento de la tienda. Siempre concedida, no se puede desactivar.
Analítica	analytics	activa	Medición de tráfico y estadísticas.
Marketing	marketing	activa	Publicidad y remarketing.
Preferencias	preferences	activa	Personalización y funciones que recuerdan las decisiones.

De forma predeterminada, las tres categorías opcionales están activas en el banner. Puede desactivar cualquiera de ellas en los ajustes del módulo si su tienda no la utiliza.

Google Consent Mode v2

Cuando Google Consent Mode está activado (opción predeterminada), el módulo imprime el estado de consentimiento predeterminado antes de cualquier código gtag/GTM (en wp_head con prioridad 0). Todas las señales empiezan como denied, excepto security_storage, y luego se actualizan de inmediato a partir de la cookie almacenada si el visitante ya ha decidido. Esto garantiza que gtag/GTM vean el estado correcto desde su primera llamada.

Las categorías del banner se asignan a las señales de Consent Mode de la siguiente manera:

Categoría	Señales de Consent Mode v2
Analítica	analytics_storage
Marketing	ad_storage, ad_user_data, ad_personalization
Preferencias	functionality_storage, personalization_storage

Una vez que el visitante toma una decisión, el banner llama a gtag('consent', 'update', ...) con el estado actual.

Scripts e iframes condicionados al consentimiento

El módulo expone un contrato que permite a otros módulos ejecutar scripts e iframes solo después de que se conceda la categoría correspondiente. El código bloqueado se renderiza como <script type="text/plain" data-polski-consent="CATEGORY">, de modo que el navegador nunca lo ejecuta al cargar. El controlador del frontend lo reescribe como un script ejecutable en cuanto se concede la categoría (de inmediato si la cookie ya lo permite, o de lo contrario en el evento polskiConsentChange).

Cuando la decisión cambia, el banner:

• escribe la cookie polski_consent con la lista de categorías concedidas,
• llama a gtag('consent', 'update', ...),
• lanza el evento de ventana polskiConsentChange al que reaccionan los scripts bloqueados,
• envía la decisión mediante POST al registrador REST.

Registros de consentimiento

Cada decisión guardada desde el banner se escribe en el registro de consentimientos. Es una vista de administración de solo lectura, disponible mientras el módulo está activado, para documentar las decisiones tomadas por los visitantes. El registro no sustituye al asesoramiento jurídico.

Columna	Descripción
Fecha	Fecha y hora de la decisión almacenada.
Categoría	La categoría a la que se aplica la decisión.
Decisión	”Concedido” o “Denegado”.
Usuario	El ID de usuario, o “Invitado” para visitantes no conectados.
Dirección IP	La dirección IP del visitante (cuando está disponible).
Versión del texto	Un hash del texto del banner que el visitante vio realmente.

Cada decisión almacenada está vinculada a la versión del texto del banner (un hash del encabezado, el texto y la lista de categorías), de modo que puede saber exactamente qué redacción aceptó el visitante.

Exportación a CSV

El botón Exportar CSV descarga el registro completo como archivo CSV. La exportación incluye las columnas: id, created_at, category, granted, user_id, ip_address, user_agent, consent_version. La exportación requiere la capacidad manage_woocommerce y está protegida por un nonce.

Ajustes

Los ajustes se encuentran en la tarjeta del módulo en WooCommerce > Polski > Módulos.

Ajuste	Predeterminado	Descripción
Categoría: Analítica	activa	Si la categoría de analítica se muestra en el banner.
Categoría: Marketing	activa	Si la categoría de marketing se muestra en el banner.
Categoría: Preferencias	activa	Si la categoría de preferencias se muestra en el banner.
Encabezado	(vacío)	Encabezado opcional del banner.
Texto del banner	texto predeterminado	El texto principal del banner (permite HTML básico).
Etiqueta “Aceptar todo"	"Accept all”	Texto del botón que acepta todo.
Etiqueta “Rechazar todo"	"Reject all”	Texto del botón que rechaza las categorías opcionales.
Etiqueta “Gestionar"	"Manage”	Texto del botón que abre la selección de categorías.
Etiqueta “Guardar decisiones"	"Save choices”	Texto del botón que guarda las categorías seleccionadas.
Posición	abajo	Ubicación del banner: arriba, abajo o centro.
Google Consent Mode	activado	Si se deben imprimir las señales de Google Consent Mode v2.

Resolución de problemas

El banner no aparece - asegúrese de que el módulo esté activado en WooCommerce > Polski > Módulos y de que el tema llame a wp_footer(). El banner se renderiza en el pie de página.

Las etiquetas de Google no reaccionan al consentimiento - compruebe que Google Consent Mode esté activado y que su código gtag/GTM se cargue después de las señales de Consent Mode (se imprimen muy temprano en wp_head).

Un script bloqueado no se ejecuta - el script solo se inicia después de que se conceda la categoría correspondiente. Verifique que el visitante haya concedido la categoría y que el script se haya emitido a través del contrato de bloqueo.

Notificar problemas: github.com/wppoland/polski/issues

Esta página es solo informativa y no constituye asesoramiento jurídico. Consulte a un abogado antes de la implementación. Polski for WooCommerce es software de código abierto (GPLv2) que se proporciona sin garantía.