Instalar FlowConsent en WordPress

En WordPress, el fragmento de código de FlowConsent se pega en el campo Header del plugin WPCode (Code Snippets → Header & Footer) o, en sitios desarrollados a medida, en el functions.php de un tema hijo. La instalación son tres pasos: copiar el fragmento, pegarlo y vaciar la caché. La trampa principal: los plugins de caché o minificación que mueven o retrasan el script, y los plugins de Google como Site Kit, que inyectan su propio gtag por encima del banner.

Antes de empezar

Una cuenta en app.flowconsent.com (plan Free gratuito, sin tarjeta de crédito, hasta 25.000 sesiones al mes).
Un banner creado y desplegado. En el plan Free, el despliegue se hace a través de la propia cuenta de Cloudflare (ver la guía de Cloudflare); en Pro y Enterprise, con un clic.
Acceso de administrador a WordPress.

Paso 1: copiar el fragmento de código

En FlowConsent, abrir Builder → Despliegue → Integración, pestaña HTML / No-code. El fragmento tiene dos partes, en este orden:

Fragmento de FlowConsent

html

<script>
// FlowConsent Loader - COLOCAR ANTES de cualquier otro script en el <head>
window.dataLayer=window.dataLayer||[];
function gtag(){dataLayer.push(arguments);}
gtag('consent','default',{
  'ad_storage':'denied',
  'analytics_storage':'denied',
  'ad_user_data':'denied',
  'ad_personalization':'denied',
  'wait_for_update':500
});
gtag('set','url_passthrough',true);
gtag('set','ads_data_redaction',true);
</script>
<!-- FlowConsent CMP -->
<script src="https://SU-CODIGO-LICENCIA.consent.flowconsent.com/cookie-manager.js?code=SU_CODIGO_LICENCIA"></script>

El primer bloque fija los valores por defecto denied de Google Consent Mode v2 y el segundo carga el banner. Ambos deben estar lo más arriba posible en el <head>, antes de cualquier script de seguimiento (Google Analytics, Meta Pixel, Google Tag Manager…): todo lo que quede por encima escapa al bloqueo previo.

Paso 2, método recomendado: el plugin WPCode

WPCode (antes «Insert Headers and Footers») cuenta con más de 3 millones de instalaciones activas.

Desde el menú Plugins, buscar WPCode, instalarlo y activarlo.
Abrir Code Snippets → Header & Footer en el menú lateral.
Pegar el fragmento al principio del campo Header, por encima de cualquier código existente (Google Analytics, GTM, píxeles).
Guardar.

Paso 2, alternativa: un tema hijo

Para no añadir ningún plugin, se puede usar un tema hijo: WordPress desaconseja editar directamente el tema padre, porque la siguiente actualización borraría los cambios. En el functions.php del tema hijo, el fragmento se engancha a wp_head con prioridad 1, que se ejecuta antes de que se impriman los scripts encolados por los plugins (prioridad 9):

wp-content/themes/su-tema-hijo/functions.php

php

<?php
add_action( 'wp_head', function () {
  ?>
  <!-- Pegar aquí el fragmento completo de FlowConsent (los dos bloques) -->
  <?php
}, 1 );

Conviene no usar el editor de archivos integrado para este cambio: no guarda copias de seguridad y un error de PHP puede dejar el sitio fuera de servicio. Es preferible SFTP o el gestor de archivos del alojamiento.

Paso 3: vaciar las cachés

Hay que vaciar la caché del plugin de caché, la del alojamiento y la del CDN; si no, los visitantes siguen recibiendo la versión antigua de las páginas, sin banner.

Trampas propias de WordPress

Solo debe quedar un banner de cookies activo: cualquier otro plugin de consentimiento debe desactivarse antes de publicar FlowConsent.

Verificar la instalación

Abrir el sitio en una ventana privada: aparece el banner.
En la pestaña Red de las herramientas de desarrollo, ninguna petición sale hacia Google, Meta u otro tercero antes de hacer clic en Aceptar.
Ejecutar el asistente de instalación (Builder → Integración): comprueba la página publicada (loader presente con el código de licencia correcto, stub de Consent Mode presente, stub antes de cada etiqueta de Google). Ver la guía del asistente.
Terminar con un escaneo de rechazo desde la pestaña Conformidad (verificación de conformidad).

Hacerlo desde un agente de IA (MCP)

FlowConsent cuenta con un servidor MCP oficial, https://mcp.flowconsent.com, utilizable desde Claude, ChatGPT o cualquier cliente MCP. La conexión se hace por OAuth 2.0 con la cuenta de FlowConsent, sin clave de API. El agente obtiene el fragmento y las instrucciones de colocación (herramientas get_banner_snippet y get_setup_instructions), verifica la instalación con un escaneo real (verify_consent_compliance) y puede programar una vigilancia periódica (monitor_compliance). No modifica el sitio WordPress: pegar el fragmento sigue siendo un paso manual.

Ejemplo de petición: «Deme el fragmento de código de mi banner para mi sitio WordPress y compruebe que está bien instalado en https://misitio.es».

Ver la guía del servidor MCP y la página FlowConsent MCP.

Preguntas frecuentes

¿Se puede cargar FlowConsent a través de Google Tag Manager?

No. Un banner cargado desde GTM llega demasiado tarde para el bloqueo previo. El fragmento va en el <head>, por encima del contenedor de GTM: las etiquetas de Google respetan entonces las señales de Consent Mode v2, y las demás etiquetas requieren la «Configuración de consentimiento adicional». Más detalles en la guía de Consent Mode.

Casi siempre es la caché: hay que vaciar la del plugin, la del alojamiento y la del CDN, y probar en una ventana privada. Después, conviene comprobar en el código fuente de la página que el fragmento está dentro del <head>.

¿Hace falta un tema hijo si se usa WPCode?

No, son métodos alternativos. WPCode conserva el fragmento en las actualizaciones del tema; el tema hijo solo tiene sentido si no se quiere un plugin más.

¿Funciona con un tema de bloques (Full Site Editing)?

Sí. WPCode y el hook wp_head funcionan tanto con temas clásicos como con temas de bloques.