Cookie Manager Tarteaucitron — Guía completa
Instalación, asistente, bloqueo automático de scripts de terceros, lista de cookies, catálogo de servicios, apariencia, Google Consent Mode v2, análisis, estadísticas y prueba de los consentimientos del módulo Cookie Manager (tarteaucitron.js) para PrestaShop 1.7.8, 8 y 9.
Presentación
Cookie Manager es un módulo de gestión del consentimiento de cookies para PrestaShop 1.7.8, 8 y 9, compatible con los temas Classic y Hummingbird. Se basa en tarteaucitron.js 1.37.0, la biblioteca de código abierto de Amauri Champeaux (licencia MIT). El módulo le añade su propio banner, el bloqueo automático de scripts de terceros, una lista de cookies generada para tus visitantes, Google Consent Mode v2 y un registro de prueba de los consentimientos.
Mientras el visitante no haya elegido nada, el módulo no instala ninguna cookie, no escribe nada en el almacenamiento del navegador ni contacta con ningún tercero. La cookie que recuerda la elección solo se escribe con el primer clic.

Instalación y asistente de inicio
- En el back office, abre Módulos → Gestor de módulos → Subir un módulo.
- Arrastra el archivo
datafirefly_tarteaucitron-3.0.0.zipy haz clic en Configurar. - El asistente se abre la primera vez: política de privacidad, herramientas utilizadas y sus identificadores, apariencia y activación del banner.
La configuración también es accesible desde la entrada de menú Módulos → Cookies (tarteaucitron). Puedes volver a lanzar el asistente en cualquier momento con el botón Asistente de la parte superior de la página.

Actualización desde la versión 2.0 o 1.x
Sube el nuevo zip sobre el módulo antiguo. El script de actualización recupera tus ajustes: servicios e identificadores, textos, colores, posición, duración, Consent Mode, registro, estadísticas y servicios personalizados.
- La elección ya expresada por tus visitantes con la 2.0 se conserva: el banner no se les vuelve a mostrar, salvo si añades un servicio.
- El bloqueo automático permanece desactivado tras una actualización. Actívalo en la pestaña Bloqueo y después prueba tus páginas.
- Desde la 1.x, el valor único de cada texto se copia en todos los idiomas de la tienda, y la etiqueta «Continuar sin aceptar» pasa a ser «Rechazar todo».
En una instalación nueva, el bloqueo automático está activado de origen.
Panel de control
El panel de control reúne doce comprobaciones de configuración: banner activado, enlace a la política de privacidad, botones «Rechazar todo» y «Aceptar todo» con la misma apariencia, duración de la elección, medio de retirada, valores por defecto de Consent Mode, identificadores válidos, archivos servidos por la tienda, análisis de scripts de terceros, bloqueo automático, lista de cookies accesible para el visitante y registro de prueba. Cada punto no cumplido ofrece un enlace Corregir hacia la pestaña adecuada.
Estas comprobaciones recogen buenas prácticas basadas en las recomendaciones de la CNIL y del CEPD. Ayudan a configurar el banner, pero no sustituyen el análisis jurídico de tu sitio.

Servicios
La pestaña Servicios presenta el catálogo verificado: Google Analytics 4, Google Tag Manager, Google Ads, Meta Pixel, TikTok, LinkedIn Insight, Pinterest, Snap Pixel, Microsoft Advertising, Microsoft Clarity, Hotjar, Matomo, Plausible, HubSpot, YouTube, Vimeo, Google Maps, Intercom, Crisp, Tawk.to, Smartsupp y Stripe, así como dos señales de Google Consent Mode sin script, para una etiqueta de Google instalada por otro módulo.
- Activa solo las herramientas realmente presentes en tu tienda y pega su identificador: su formato se verifica mientras lo escribes y de nuevo al guardar. Un identificador no válido se rechaza y el servicio permanece desactivado.
- Cada servicio puede asignarse a una categoría distinta de la propuesta, por ejemplo Google Tag Manager en «Publicidad» si tu contenedor contiene sobre todo etiquetas publicitarias.
- Matomo y Plausible pueden declararse exentos de consentimiento, únicamente si tu configuración de la herramienta cumple las condiciones de la CNIL para la medición de audiencia.
- Stripe se trata como estrictamente necesario para el pago: se carga sin solicitud y se muestra entre las cookies siempre activas.
Servicios personalizados: para una herramienta que no está en el catálogo, añade un servicio con su nombre, su categoría, su política de privacidad, sus cookies y el código proporcionado por la herramienta (etiquetas <script> incluidas). Este código solo se ejecuta después de que el visitante acepte la categoría elegida.

Biblioteca tarteaucitron.js: los 245 servicios de tarteaucitron.js 1.37.0 están disponibles además del catálogo. Busca un servicio, añádelo, completa sus parámetros y elige su categoría. El visitante solo descarga el archivo de un servicio si el servicio está activado y aceptado.

Bloqueo automático
Antes de enviar cada página, el módulo neutraliza las etiquetas <script> y los iframes de los servicios de terceros que reconoce, procedan del tema o de otro módulo: 46 servicios (los del catálogo y otros 24 rastreadores habituales), además de tus propias reglas. No se descarga ni se ejecuta nada mientras el visitante no haya aceptado la categoría correspondiente; después, las etiquetas se reactivan en el orden del documento.
- Reglas adicionales: una regla por línea, con el formato
fragmento de dirección o de código | nombre mostrado al visitante | categoría. Las categorías sonanalytic,ads,socialyfunctional. El botón «Bloquear» del análisis añade la regla por ti. - Excepciones: un fragmento por línea; una etiqueta cuya dirección o código lo contenga nunca se bloquea. También puedes añadir el atributo
data-dftac-ignorea una etiqueta de tu tema.
El bloqueo se aplica a las etiquetas presentes en el código de la página. Un script cargado por otro script (por ejemplo, desde un archivo JavaScript de un módulo) no figura en él: desactívalo en ese módulo y declara el servicio aquí. Un script que utiliza document.write puede no funcionar una vez reactivado.
Google Tag Manager se bloquea por completo hasta la aceptación. Si lo controlas con el Consent Mode, añade googletagmanager.com/gtm.js a las excepciones.

Lista de cookies
La pestaña Cookies genera la lista de cookies a partir de los servicios activados, las etiquetas bloqueadas y lo que tú añadas: categoría, servicio, nombre, duración y finalidad. Se actualiza cada vez que guardas y se muestra en el idioma del visitante.
- Cookies adicionales: una cookie por línea, con el formato
nombre | proveedor | duración | finalidad | categoría, para las cookies de tus otros módulos o para precisar una duración. - Solo se indica una duración si se ha recogido en la documentación del editor (noviembre de 2026); «—» significa que la fija el servicio.
Comprueba esta lista antes de publicarla: describe los servicios declarados en el módulo, no los que otro script pudiera añadir sin que lo sepas.

Con la opción Publicar la lista de cookies (pestaña Comportamiento), se crea una página pública, enlazada desde el banner, la ventana de preferencias y el pie de página.

Apariencia
Se ofrecen seis disposiciones: banner ancho en la parte inferior, tarjeta en una de las cuatro esquinas o ventana central. Por defecto, «Rechazar todo» y «Aceptar todo» tienen la misma forma, el mismo tamaño y el mismo color; también hay disponible un estilo «contorno». El estilo que destaca «Aceptar todo» se ofrece con una advertencia, ya que la CNIL y el CEPD valoran estas diferencias caso por caso.
Los colores (botones, texto de los botones, fondo, texto) cuentan con paletas listas para usar y un control de contraste en directo, con un umbral de 4,5:1. La vista previa muestra el banner real, la ventana de preferencias o el botón flotante, en ancho de ordenador o móvil, en cada idioma, con los ajustes aún no guardados.

Tema e identidad: tema claro, oscuro o automático (según el ajuste del dispositivo del visitante) con sus propios colores, icono de cookie o logotipo de la tienda, posición del botón flotante, fuente del sistema o fuente del tema, y un campo de CSS personalizado que se añade después de la hoja de estilos del banner.

Textos e idiomas
Los textos del banner se proporcionan en francés, inglés, español, alemán, italiano, polaco, neerlandés y portugués. El mensaje propuesto por defecto cita únicamente las finalidades activadas en tu tienda, una línea por finalidad, y después recuerda que rechazar no impide navegar ni comprar.
La pestaña Textos permite sustituir cada texto idioma por idioma: título, mensaje, etiquetas de los botones y direcciones de las políticas de privacidad y de cookies. Un campo que se deja vacío utiliza el texto propuesto. En el mensaje, una línea que empieza por un guion se convierte en un elemento de lista. Una página CMS de la tienda también puede servir como política de privacidad en todos los idiomas.
La frase «rechazar no impide comprar» es exacta con el catálogo del módulo, en el que Stripe es estrictamente necesario. Si sometes un medio de pago a consentimiento, adapta el mensaje.

Comportamiento
- Duración de conservación de la elección: 183 días por defecto (6 meses, duración que la CNIL presenta como una buena práctica), 365 días como máximo. Se aplica tanto a la aceptación como al rechazo.
- Volver a solicitar el consentimiento a todos: tras un cambio importante, un botón hace que el banner vuelva a aparecer para todos los visitantes. En cualquier caso, un servicio añadido se propone a los visitantes que aún no lo hayan visto.
- Retirada del consentimiento: botón flotante, enlace «Gestionar mis cookies» añadido automáticamente al pie de página, cualquier enlace a
#tarteaucitrono llamada JavaScriptdftacOpenPreferences(). Cuando se retira una aceptación, se borran las cookies del servicio y se recarga la página. - Cuenta de cliente: como opción, la elección de un cliente conectado se recupera en sus otros dispositivos. Figura en la exportación y la eliminación de datos del módulo RGPD oficial de PrestaShop (psgdpr), si está instalado.
- Cruz de cierre: opcional, equivale a «Rechazar todo».
- Banner oculto sin servicios sujetos a consentimiento: sin rastreadores que gestionar, el banner no es necesario. Desactiva esta opción si gestionas scripts fuera del módulo.
- Global Privacy Control: opcional, un navegador que envía esta señal se trata como un rechazo.

Vídeos y mapas integrados: los iframes reconocidos (YouTube, Vimeo, Google Maps, Dailymotion, Spotify…) se sustituyen por un marcador «Permitir», accesible con el teclado. Solo se contacta con la plataforma después de la aceptación del visitante. Permitir un solo contenido desde su marcador no equivale a aceptar el resto de la categoría.

Lo que ve el visitante
La primera pantalla muestra el título, el mensaje, el enlace a la política de privacidad y los botones «Rechazar todo», «Aceptar todo» y «Personalizar». La ventana de preferencias enumera las finalidades con un interruptor para cada una (desmarcados por defecto), los servicios de cada categoría con sus cookies y su duración, y las cookies estrictamente necesarias, siempre activas. También muestra el identificador del consentimiento, que el visitante puede facilitarte.

En móvil, los botones conservan el mismo tamaño, cada finalidad cabe en una línea y el banner no desplaza la página.
Accesibilidad: casillas de verificación reales anunciadas como interruptores, ventana de preferencias que retiene el foco, cierre con la tecla Esc con devolución del foco y movimiento reducido si el visitante lo ha solicitado. axe-core (WCAG 2.1 A y AA) no ha detectado ninguna infracción en el banner, las preferencias, un contenido bloqueado y la lista de cookies, en tema claro y oscuro.

Google Consent Mode v2
El módulo declara los valores por defecto al principio de la página, antes de cualquier etiqueta de Google: publicidad, medición y personalización en denied, funcionamiento y seguridad en granted (modificables). En cuanto el visitante elige, las señales se actualizan según las categorías aceptadas:
- Medición de audiencia →
analytics_storage; - Publicidad →
ad_storage,ad_user_data,ad_personalization; - Vídeos, mapas y redes sociales →
personalization_storage.
Para un visitante que ya ha respondido, la actualización se envía al principio de la página desde la siguiente visualización, sin esperar a la carga completa. Las opciones wait_for_update, ads_data_redaction y url_passthrough son configurables, y se envía un evento dftac_consent_update al dataLayer para tus activadores de Google Tag Manager.

Análisis de scripts de terceros
El botón Analizar mi tienda carga desde el servidor la página de inicio, una categoría, un producto, la página de contacto y hasta 8 páginas de tu elección, como un nuevo visitante sin cookies. El resultado enumera las etiquetas bloqueadas automáticamente, los scripts y contenidos de terceros que aún se cargan antes de la elección (con un botón Bloquear que crea la regla), las cookies instaladas por el servidor y los módulos instalados que se sabe que añaden sus propias etiquetas.
El análisis se vuelve a lanzar por sí solo al abrir el back office cuando tiene más de 30 días. Lee el código HTML enviado por la tienda: un script añadido después mediante JavaScript no se detecta.

Estadísticas y test A/B
La pestaña Estadísticas muestra las visualizaciones, las elecciones expresadas, los porcentajes de «Aceptar todo», «Rechazar todo» y de elecciones personalizadas, la aceptación por categoría, el reparto entre ordenador y móvil y la evolución diaria, en 7, 30 o 90 días, 12 meses o todo el historial, con exportación CSV. Los contadores se agregan por día, sin datos personales ni cookies. Una visualización se cuenta cuando el banner lo ve un visitante que interactúa con la página; se excluyen los robots.
El test A/B compara dos formulaciones o disposiciones. La variante se sortea en cada visualización, sin guardar nada en el dispositivo del visitante, y ambas variantes mantienen «Rechazar todo» al mismo nivel que «Aceptar todo». Solo se anuncia una ganadora a partir de 100 elecciones por variante y con una diferencia significativa al 95 %.

Prueba de los consentimientos
Cada elección se registra con su fecha, su identificador aleatorio (también conservado en la cookie del visitante), la acción, las categorías y los servicios aceptados, la versión del banner presentada y el origen de la elección (banner, preferencias, botón flotante, marcador de un contenido bloqueado). No se conserva ningún nombre, correo electrónico ni dirección IP en claro; como opción, está disponible una huella con sal de la dirección IP.
- Búsqueda por identificador de consentimiento, exportación CSV.
- Cada modificación de los textos, los servicios o los ajustes presentados crea una versión del banner con fecha y hora, descargable en formato JSON.
- Purga automática una vez superada la duración de conservación elegida, sin tarea programada; también es posible la purga manual.
- El registro se conserva si se desinstala el módulo.

Alojamiento y peso
Antes de cualquier elección, la página solo carga dos archivos del módulo, servidos por tu tienda: el script y la hoja de estilos del banner. tarteaucitron.js, su archivo de idioma y los archivos de los servicios solo se descargan después de una aceptación que los necesite; un visitante que rechaza no los descarga nunca. La opción «CDN jsDelivr» carga entonces los archivos oficiales desde jsDelivr, un tercero contactado en cuanto se acepta un servicio.
Medido en una página de inicio de PrestaShop 9.1.5 (tema Hummingbird): 2 archivos y 12 KB transferidos antes de cualquier elección. La versión 2.0.0 cargaba 5 archivos y 38 KB (medido en PrestaShop 8.2.1, tema Classic).
Multitienda
Los ajustes siguen el contexto de tienda elegido en el back office: selecciona una tienda para configurarla individualmente. El registro y las estadísticas se guardan por tienda.
Límites que conviene conocer
- El módulo no es una plataforma de consentimiento registrada en IAB Europe (TCF) ni una CMP certificada por Google. Si muestras publicidad de AdSense, Ad Manager o AdMob en Europa, Google exige una CMP certificada.
- El bloqueo automático y el análisis leen el código HTML de las páginas: no ven un script inyectado después por otro script.
- El banner es el mismo sea cual sea el país del visitante.
- Estas funciones ayudan a aplicar las buenas prácticas de la CNIL y del CEPD; no sustituyen el análisis jurídico de tu sitio (inventario de rastreadores, política de privacidad, contratos con tus socios).
Solución de problemas
- El banner no se muestra: comprueba que el banner está activado (interruptor de la parte superior de la página), que al menos un servicio sujeto a consentimiento está listo, o desactiva la opción «No mostrar el banner sin servicios sujetos a consentimiento». Después, vacía la caché de PrestaShop.
- Un servicio no se carga tras la aceptación: comprueba su distintivo en la pestaña Servicios. «Por completar» indica un identificador ausente o no válido.
- Un script se carga antes de la elección: lanza el análisis y después utiliza el botón «Bloquear». Si el script no aparece, seguramente lo inyecta otro script: desactívalo en el módulo que lo añade.
- Una herramienta deja de funcionar tras activar el bloqueo: añade su dirección a las excepciones de la pestaña Bloqueo, o declárala como servicio para que se cargue tras la aceptación.
- El banner vuelve a aparecer en cada página: comprueba el dominio de la cookie y que el nombre de la cookie no se haya modificado entretanto.
- No hay entradas en el registro: comprueba que el registro está activado en la pestaña Prueba y luego haz una elección en navegación privada.
¿Necesitas ayuda? Contacta con el soporte de DataFireFly desde tu área de cliente; respuesta en 24 h laborables.