PrestaShop

Módulo CookiePilot para PrestaShop con Consent Mode v2

Sube un único ZIP en el Module Manager, conecta el dominio de tu tienda y el módulo sirve el banner de consentimiento desde el head de cada página de la tienda. Compatible con PrestaShop 8.0.0 a 9.99.99.

Requisitos y versiones compatibles

  • PrestaShop en versión 8.0.0 a 9.99.99.
  • Acceso al back office con permiso para instalar módulos.
  • Una cuenta de CookiePilot. Puedes registrarte, verificar tu correo electrónico e iniciar sesión directamente dentro del módulo.
  • El ZIP del módulo, versión 1.0.0, descargado desde el enlace de abajo. No lo descomprimas.

Descarga el módulo

El ZIP se sirve desde la aplicación CookiePilot en la dirección de abajo y nunca se distribuye a través de marketplaces de terceros. Tras la descarga, compara la suma SHA-256 con el valor publicado para confirmar que el archivo no se modificó por el camino.

Tamaño: 228.8 KBSHA-256: 9ac5668263574e760e6f860a4a939c3ee67445d15624e02f6b03d14e5fdb95d9
Descargar el ZIP

En Linux o macOS ejecuta el comando de abajo. En Windows usa certutil -hashfile sobre el archivo descargado. El resultado debe coincidir exactamente con el resumen publicado.

tmp=$(mktemp)
trap 'rm -f "$tmp"' EXIT
curl -fsSL https://app.cookiepilot.io/downloads/cookiepilot-prestashop-addons-1.0.0.zip -o "$tmp"
echo "9ac5668263574e760e6f860a4a939c3ee67445d15624e02f6b03d14e5fdb95d9  $tmp" | sha256sum --check

Instala el ZIP en el Module Manager

  1. 1.En el back office abre Módulos, luego Module Manager, y haz clic en Subir un módulo.
  2. 2.Arrastra el ZIP descargado al cuadro de subida. PrestaShop lo instala y lo muestra en la lista como CookiePilot CMP.
  3. 3.Haz clic en Configurar en la entrada CookiePilot CMP para abrir la página de configuración del módulo.
  4. 4.Si la subida es rechazada, comprueba que tu versión de PrestaShop está entre 8.0.0 y 9.99.99 y que el ZIP es el archivo original sin modificar.

Regístrate, verifica tu correo y conecta la tienda

  1. 1.En la página de configuración crea una cuenta de CookiePilot o inicia sesión en una existente. El registro solo pide una dirección de correo electrónico y una contraseña.
  2. 2.Confirma el correo de verificación. El módulo completa el inicio de sesión en cuanto la dirección queda verificada.
  3. 3.Conecta la tienda: el módulo crea el dominio en tu cuenta de CookiePilot automáticamente, o se reconecta a un dominio existente con el mismo nombre de host.
  4. 4.El panel Shop connection muestra entonces el dominio conectado, la cuenta y el plan actual, con el estado CONNECTED.

Dónde se inyecta el script

  1. 1.El módulo inyecta el script de CookiePilot en el head de cada página de la tienda, exactamente una vez, antes de las etiquetas de analítica. No pegas ningún código en el tema, y los hooks duplicados de un tema no generan una segunda copia.
  2. 2.Si en tu tema o en un contenedor de etiquetas ya existe un snippet de CookiePilot pegado a mano u otro banner de consentimiento, elimínalo. Dos capas de consentimiento en una misma página compiten por el estado de consentimiento y corrompen la medición.
  3. 3.El panel Storefront status tiene un único interruptor, Enable CookiePilot banner and Consent Mode, así que puedes comprobar en cualquier momento si el script se está sirviendo.

Mapeo de Consent Mode v2

  1. 1.El módulo establece los valores por defecto de Google Consent Mode v2 en denied antes de que el visitante tome cualquier decisión. El almacenamiento de analítica y de marketing permanece en denied hasta que existe consentimiento.
  2. 2.Accept All concede todas las categorías. Reject All mantiene todas las categorías en denied. El consentimiento granular concede exactamente las categorías que el visitante seleccionó en la vista de configuración.
  3. 3.Los scripts opcionales estáticos y dinámicos registrados en el módulo se bloquean y se liberan según esas mismas categorías, de modo que un script solo se ejecuta cuando su categoría está concedida.

Comportamiento en multitienda

  1. 1.En una instalación multitienda la configuración se guarda por tienda. Cada tienda conecta su propio dominio y conserva sus propias claves.
  2. 2.Una tienda recién creada no hereda las claves de la tienda propietaria. Abre la configuración del módulo en el contexto de cada tienda y conéctala por separado.

Comprueba el dataLayer en la consola

Abre la tienda en una ventana privada, abre la consola del navegador y pega el snippet de abajo. Antes de cualquier decisión debes ver una única entrada default con valores denied. Tras una decisión debe seguir una entrada update con las categorías concedidas.

(window.dataLayer || []).forEach(function (entry) {
  if (entry && entry[0] === 'consent') {
    console.log(entry[1], entry[2]);
  }
});

Pruebas de trackers en cinco estados

Ejecuta cada estado en una sesión privada nueva y mantén abierta la pestaña Network. Estos cinco estados son la prueba de aceptación con la que se verifica el propio módulo.

Antes del consentimiento: con el banner todavía abierto, la pestaña Network no muestra peticiones de analítica ni de marketing y no se escriben cookies de seguimiento.
Solo analítica: concede únicamente analítica en la vista granular. Las peticiones de analítica arrancan y las peticiones y cookies de marketing siguen ausentes.
Solo marketing: concede únicamente marketing. Las etiquetas de marketing pueden dispararse mientras el almacenamiento de analítica sigue en denied.
Accept All: las categorías concedidas arrancan y el dataLayer contiene un consent update con valores granted.
Reject All: la tienda sigue funcionando, incluidos el carrito y el checkout, y los trackers permanecen en silencio incluso tras recargar la página.

Meta Pixel y TikTok Pixel no leen Consent Mode, así que Consent Mode v2 por sí solo no los detiene. Deben quedar cubiertos por el autoblocking del módulo o dispararse mediante event gating solo después del consentimiento de marketing.

Desactivar, desinstalar, reinstalar

Desactivar el módulo elimina el script de CookiePilot de la tienda. El dominio en tu cuenta de CookiePilot queda intacto.

Desinstalar elimina los secretos locales y los hooks de la base de datos de la tienda. No borra el dominio remoto ni las evidencias de consentimiento almacenadas.

Reinstalar el módulo y reconectar el mismo dominio funciona: el módulo se vincula de nuevo al dominio existente en lugar de crear un duplicado.

Resolución de problemas

El banner no aparece tras la instalación

Vacía la caché de PrestaShop en Parámetros avanzados, Rendimiento, y purga tu CDN si usas uno. El HTML en caché sigue sirviendo páginas generadas antes de activar el módulo.

Dos banners o un estado de consentimiento contradictorio

Elimina cualquier snippet de consentimiento pegado a mano en el tema, en herramientas del hosting y en contenedores de etiquetas. Solo puede ejecutarse una capa de consentimiento, y el módulo ya la inyecta una vez.

Los trackers se disparan antes que el banner

Un tema u otro módulo con GA4, Meta o TikTok incrustados a mano se carga fuera de la capa de consentimiento. Mueve esas etiquetas detrás del autoblocking del módulo o a una configuración de etiquetas condicionada al consentimiento.

Configuraciones con Google Tag Manager

Mantén el módulo como única fuente de consentimiento. Condiciona cada etiqueta de GTM al estado de consentimiento correspondiente o dispárala tras el consent update, y nunca pegues un segundo loader de CookiePilot en el contenedor.

Siguen apareciendo peticiones de Meta o TikTok

Estos píxeles ignoran Consent Mode. Confirma que están cubiertos por el autoblocking o por event gating; un píxel incrustado a mano en el tema sigue disparándose hasta que se mueve detrás del consentimiento de marketing.

El módulo en una tienda real

Instala el módulo y prueba tu tienda

Descarga el ZIP, conecta tu dominio y recorre los cinco estados de trackers en una sesión limpia. Toda la configuración se hace en el back office.