¿Hay algo que no funciona como esperabas con WPConsent? Esta guía te ayuda a diagnosticar y solucionar los problemas más comunes, desde banners que no aparecen hasta problemas de bloqueo de scripts. La Guía de resolución de problemas cubre las herramientas de depuración integradas, el borrado de la caché, los conflictos entre plugins y cómo recopilar información del sistema para obtener asistencia.

Índice

• Uso del parámetro URL de depuración
• Comprobando si hay errores en la consola de tu navegador
• Borrar cachés
• Corregir un banner que falta
• Corrección de scripts no bloqueados correctamente
• Resolución de conflictos con otros complementos
• Resolución de problemas de compatibilidad de temas
• Uso de la información del sistema para obtener asistencia técnica
• Lista de verificación de referencia rápida
• Preguntas frecuentes
• Conclusión

Uso del parámetro URL de depuración

WPConsent incluye un parámetro de depuración integrado que desactiva temporalmente el bloqueo de scripts en cualquier página. Esto le ayuda a determinar si un problema está causado por el bloqueo de scripts o por otra cosa.

Para utilizarlo, añada ?wpconsent_debug al final de cualquier URL de tu sitio web:

https://example.com/?wpconsent_debug
https://example.com/contact/?wpconsent_debug

Cuando este parámetro está presente, WPConsent omite el procesamiento del búfer de salida. Los scripts que normalmente se bloquearían se ejecutan sin modificaciones. El banner de consentimiento sigue apareciendo con normalidad.

Utilice el parámetro de depuración cuando:

• Sospechas que el bloqueo de scripts está alterando el diseño de una página o un formulario.
• Un servicio de terceros no funciona y quieres confirmar que WPConsent es la causa.
• Debes comparar el comportamiento de la página con y sin bloqueo.

Para probar, carga la página una vez con el parámetro y otra sin él. Si el problema desaparece cuando ?wpconsent_debug está presente, el problema está relacionado con el bloqueo de scripts. Comprueba el Corregir scripts que no se bloquean correctamente. Sección para los siguientes pasos.

Nota: El parámetro de depuración solo afecta a la carga de la página en la que está presente. No es una configuración persistente y no cambia nada en tu base de datos.

Comprobando si hay errores en la consola de tu navegador

La consola del navegador es una de las herramientas más útiles para diagnosticar problemas frontend con WPConsent.

Abrir la consola

1. En primer lugar, abra su sitio web en Chrome, Firefox o Edge.
2. A continuación, pulsa F12 (o haz clic con el botón derecho en cualquier lugar y selecciona Inspeccionar).
3. A continuación, haga clic en la pestaña Consola.
4. Por último, vuelve a cargar la página para capturar todos los mensajes desde el principio.

Identificar errores comunes

• Errores de JavaScript (texto en rojo): Esto indica que algo está fallando. Busque errores que mencionen wpconsent, wpconsent-frontend, o los nombres de los servicios de seguimiento.
• Fallos de red: Cambiar a Red pestaña y filtrar por errores. Solicitudes fallidas a los archivos de compilación de WPConsent (frontend.js, frontend.css) impiden que se cargue el banner.
• Atributos de script bloqueados: En el Elementos pestaña, buscar data-wpconsent-src. Si encuentra scripts con type="text/plain" y un data-wpconsent-category atributo, el bloqueo de scripts funciona correctamente.

Borrar cachés

El almacenamiento en caché es la fuente más común de confusión al configurar WPConsent. Si cambia una configuración y no ve el resultado, casi siempre se debe al almacenamiento en caché.

Borrar la caché de cookies de WPConsent

WPConsent almacena en caché la categoría de cookies y los datos del servicio utilizando transitorios de WordPress. Estos transitorios se actualizan automáticamente, pero puedes borrarlos manualmente si los datos de las cookies parecen obsoletos.

1. Primero, ve a WPConsent >> Herramientas.
2. A continuación, haga clic en la pestaña Base de datos.
3. Verás la línea «Estado de la caché », que muestra cuándo se creó la caché por última vez.
4. A continuación, haz clic en el botón Borrar caché.
5. Un mensaje de éxito confirma que la caché se ha borrado.

Esto borra los siguientes transitorios:

• wpconsent_needs_google_consent — Si se cargan los scripts del modo de consentimiento de Google.
• wpconsent_preference_cookies — Datos de cookies almacenados en caché para el panel de preferencias.
• wpconsent_preference_slugs — Categorías y servicios almacenados en caché.

Purgar las cachés de páginas del lado del servidor

Si utilizas un plugin de caché (WP Rocket, W3 Total Cache, LiteSpeed Cache, WP Super Cache, etc.) o una caché a nivel de servidor, purga la caché después de realizar cualquiera de estos cambios:

• Habilitar o deshabilitar el banner de consentimiento
• Habilitar o deshabilitar el bloqueo de scripts
• Cambiar la configuración de bloqueo de contenido
• Añadir o eliminar servicios o categorías

Cada plugin de caché tiene su propio método de purga. Estos son los enfoques más comunes:

• WP Rocket: Ve a la barra de administración de WordPress y haz clic en WP Rocket >> Borrar caché.
• Caché LiteSpeed: Vaya a Caché LiteSpeed >> Caja de herramientas >> Purgar todo.
• W3 Total Cache: Vaya a Rendimiento >> Panel de control y haga clic en Vaciar todas las cachés.
• Cloudflare / CDN: Inicie sesión en su panel de control de CDN y vacíe también la caché allí.

El bloqueo de scripts de WPConsent utiliza el almacenamiento en búfer de salida de PHP. La primera carga de la página sin almacenar en caché produce HTML con los scripts bloqueados correctamente. A continuación, el plugin de almacenamiento en caché almacena ese HTML modificado. Si ha habilitado WPConsent después de que las páginas ya se hayan almacenado en caché, las versiones almacenadas en caché no tienen el bloqueo aplicado. La purga fuerza la creación de una página nueva.

Borrar la caché del navegador

Tu navegador almacena CSS, JavaScript y, en ocasiones, páginas completas de forma local. Para descartar el almacenamiento en caché del navegador:

1. Abrir un ventana privada/de incógnito (Ctrl+Shift+N en Chrome, Ctrl+Shift+P en Firefox).
2. Navega hasta tu sitio web.

O realiza una actualización completa:

• Windows/Linux: Ctrl+Shift+R
• Mac: Cmd+Shift+R

Una ventana privada también borra el wpconsent_preferences cookie de consentimiento, por lo que el banner aparece como si fueras un nuevo visitante.

Borrar las cookies para realizar una nueva prueba

Para forzar que el banner vuelva a aparecer sin abrir una ventana privada:

1. Primero, abre las herramientas de desarrollo del navegador (F12).
2. A continuación, ve a la pestaña Aplicaciones (Chrome) o Almacenamiento (Firefox).
3. A continuación, expanda Cookies y seleccione el dominio de su sitio.
4. Encuentre el wpconsent_preferences cookie y eliminarla.
5. Por último, vuelve a cargar la página.

Corregir un banner que falta

Si el banner de consentimiento no aparece en tu sitio web, sigue estos pasos en orden.

1. Verificar que el banner esté habilitado.

Navega a WPConsent >> Diseño del banner y confirma que la casilla Mostrar banner en la interfaz está activada en la parte superior de la página. A continuación, haz clic en Guardar si realizas cambios.

Como alternativa, ve a WPConsent >> Configuración y marca la casilla Consentimiento en la pestaña Configuración.

2. Comprobación de la existencia de una cookie de consentimiento

Si ya ha interactuado anteriormente con el banner, ya existe una cookie de consentimiento. Abra una ventana privada/de incógnito o elimine la wpconsent_preferences cookie tal y como se describe en Borrar las cookies para realizar una nueva prueba..

3. Comprobación de la configuración de geolocalización

Si utiliza la función de geolocalización de WPConsent, es posible que el banner esté configurado para mostrarse solo en regiones específicas. Si su ubicación no está incluida en ningún grupo de geolocalización activo, el banner no aparecerá. Compruebe sus reglas de geolocalización en WPConsent >> Geolocalización para confirmar que su región está cubierta. Para obtener más información, consulte la guía de geolocalización.

4. Purgar todas las cachés

Siga los pasos para borrar las cachés y purgar las cachés del servidor y del navegador.

5. Comprobación de errores de JavaScript

Abre la consola del navegador y busca errores. Si frontend.js no se carga, el banner no se puede renderizar. Las causas más comunes incluyen:

• Un complemento de seguridad que bloquea los scripts en línea o el archivo JavaScript de WPConsent.
• Un plugin de minificación u optimización que interrumpe el script. Intenta desactivar temporalmente plugins como Autoptimize, la optimización de archivos de WP Rocket o SiteGround Optimizer.

6. Comprobación del modo editor del generador de páginas

WPConsent suprime automáticamente el banner dentro de las interfaces de los editores Bricks Builder y Divi Builder. Para ver el banner, previsualiza la página o visualízala en la interfaz real.

7. Desactivación de otros complementos

Si ninguna de las soluciones anteriores resuelve el problema, desactive temporalmente todos los demás complementos excepto WPConsent. Si aparece el banner, vuelva a activar los complementos uno por uno para encontrar el conflicto. Consulte la sección Resolución de conflictos con otros complementos para obtener más detalles.

Corrección de scripts no bloqueados correctamente

Si los scripts de seguimiento se ejecutan antes de que se dé el consentimiento, o si los scripts se bloquean cuando no deberían, siga estos pasos de diagnóstico.

Confirmar que el bloqueo de scripts está habilitado

Navega a WPConsent >> Configuración y verifica:

1. La opción «Consent Banner » está activada.
2. La opción Bloqueo de scripts está activada.

El bloqueo de scripts requiere que el banner esté habilitado. Si el banner está desactivado, el bloqueo de scripts se desactiva automáticamente.

Comprobación de interacciones en modo de consentimiento

Cuando el modo de consentimiento de Google está habilitado, los scripts de Google Analytics, Google Tag Manager y Google Ads no se bloquean intencionadamente. Se ejecutan en un modo restringido y sin cookies hasta que el visitante da su consentimiento. Este es el comportamiento correcto, no un error. Para utilizar el bloqueo completo, desactive el modo de consentimiento de Google en WPConsent >> Ajustes, en la pestaña Ajustes.

Lo mismo se aplica al modo de consentimiento de Clarity para Microsoft Clarity.

Comprobación del parámetro de depuración

Si la URL contiene ?wpconsent_debug, el bloqueo de scripts está desactivado para esa carga de página. Elimina el parámetro de la URL.

Inspeccionar el código fuente de la página

1. Primero, abre la página en tu navegador.
2. A continuación, haz clic con el botón derecho y selecciona Ver código fuente de la página (no Inspeccionar elemento, que muestra el DOM en tiempo real después de que se ejecute JavaScript).
3. A continuación, busque data-wpconsent-src.

Si encuentra etiquetas de script con type="text/plain" y data-wpconsent-src atributos, el bloqueo funciona. Los scripts se modifican en el HTML antes de que el navegador los reciba.

Si no encuentras estos atributos en un script que esperas que sea bloqueado, ese script no está en la lista de scripts conocidos de WPConsent. La lista de bloqueo se actualiza de forma remota. En la versión de pago, puedes añadir reglas de bloqueo personalizadas en WPConsent >> Ajustes, en la pestaña Avanzado.

Purgar la caché del servidor

Una caché de páginas obsoleta puede servir HTML que se generó antes de que se habilitara el bloqueo de scripts. Purgue todas las cachés tal y como se describe en borrar cachés.

Resolución de conflictos con otros complementos

Los conflictos entre plugins son la causa más habitual de comportamientos inesperados con los plugins de consentimiento. A continuación se describe un enfoque sistemático para diagnosticarlos.

Identificar el conflicto

1. Primero, ve a Plugins >> Plugins instalados en tu administrador de WordPress.
2. A continuación, desactiva todos los plugins excepto WPConsent.
3. A continuación, comprueba si el problema se ha resuelto.
4. Si es así, reactiva los complementos uno por uno, probándolos después de cada uno.
5. Cuando el problema vuelva a aparecer, habrás encontrado el complemento conflictivo.

Reconocer los tipos de conflictos comunes

Otros plugins de consentimiento o cookies. Ejecutar dos plugins de gestión del consentimiento al mismo tiempo provoca conflictos. Si estás migrando desde otro plugin de consentimiento (Complianz, CookieYes, Cookie Notice, GDPR Cookie Consent, etc.), desactiva el plugin anterior antes de configurar WPConsent.

Complementos de optimización de JavaScript. Los plugins que combinan, minimizan o aplazan JavaScript (Autoptimize, optimización de archivos de WP Rocket, SiteGround Optimizer, Perfmatters, Flying Scripts) pueden dañar el script frontend de WPConsent. Excluir wpconsent scripts de optimización en la configuración del otro complemento.

Complementos de seguridad. Los complementos que añaden encabezados de Política de Seguridad de Contenido (CSP) o bloquean scripts en línea (Wordfence, iThemes Security, NinjaFirewall) pueden impedir que WPConsent se cargue. Añade los archivos de script y estilo de WPConsent a la lista blanca del complemento de seguridad.

Complementos de almacenamiento en caché. Consulte cómo borrar las cachés. El paso más importante es purgar todas las cachés después de cambiar la configuración de WPConsent.

Resolución del conflicto

Una vez que identifique el complemento conflictivo, pruebe estos métodos:

1. Comprueba si hay una opción de exclusión o lista blanca en la configuración del plugin conflictivo. La mayoría de los plugins de optimización y seguridad te permiten excluir scripts o rutas específicos.
2. Actualiza ambos complementos a la última versión. Los problemas de compatibilidad suelen solucionarse en las actualizaciones.
3. Póngase en contacto con el servicio de asistencia si el conflicto persiste. Incluya la información del sistema (consulte la sección «Uso de la información del sistema» para obtener ayuda) y el nombre y la versión del complemento que causa el conflicto.

Resolución de problemas de compatibilidad de temas

WPConsent utiliza Shadow DOM para renderizar el banner de consentimiento, lo que lo aísla del CSS de tu tema. Esto significa que los estilos del tema no afectan al banner y que el banner no afecta a tu tema. En casos excepcionales, es posible que un tema siga interfiriendo.

El banner no aparece a pesar de estar habilitado.

Algunos temas utilizan un almacenamiento en búfer de salida agresivo o una representación de contenido personalizada que puede entrar en conflicto con el búfer de salida de WPConsent. Para probarlo:

1. En primer lugar, cambia temporalmente a un tema predeterminado de WordPress (Twenty Twenty-Five, Twenty Twenty-Four o Twenty Twenty-Three).
2. A continuación, comprueba si aparece el banner.
3. Si es así, el problema está en la gestión de la salida de tu tema.

Póngase en contacto con el desarrollador de su tema con esta información. Es posible que tenga que ajustar la prioridad del búfer de salida.

El banner aparece, pero se superpone o está mal posicionado.

El banner utiliza posicionamiento fijo o absoluto con un alto z-indexSi tu tema tiene elementos con valores de índice Z muy altos (encabezados fijos, menús flotantes), es posible que se superpongan al banner.

Prueba a cambiar la posición del banner en WPConsent >> Diseño del banner. Si el banner está configurado en Inferior, prueba con Superior o cambia al diseño Modal (versión de pago) para mostrarlo centrado en la página.

Errores de JavaScript relacionados con el tema tras el consentimiento

Si el JavaScript de tu tema depende de un script de terceros que WPConsent bloquea (por ejemplo, una integración de Google Maps en el encabezado), el script del tema puede generar errores porque el recurso de terceros aún no está disponible.

La solución depende de tu configuración:

• Si el servicio bloqueado pertenece a una categoría conocida, el script se carga después de que el visitante dé su consentimiento para esa categoría. La página se recarga automáticamente y el script del tema se ejecuta con normalidad.
• Si el servicio no está en la lista conocida de WPConsent, puedes añadirlo como script personalizado en la versión de pago o excluirlo del bloqueo.

Uso de la información del sistema para obtener asistencia técnica

WPConsent incluye una página de información del sistema que recopila detalles técnicos sobre tu instalación de WordPress, la configuración del servidor y los plugins activos. Esta información es esencial a la hora de solicitar asistencia técnica.

Acceso a la información del sistema

1. Primero, ve a WPConsent >> Herramientas.
2. A continuación, haga clic en la pestaña Información del sistema.
3. La información del sistema aparece en un área de texto de solo lectura.

Entender qué está incluido

El informe de información del sistema contiene las siguientes secciones:

Sección	Detalles
Información del sitio	URL del sitio, URL de inicio y si el sitio es una instalación multisitio.
Configuración de WordPress	Versión de WordPress, idioma, estructura de enlaces permanentes, tema activo, WP_DEBUG estado y límite de memoria.
Cargas/Constantes de WordPress	Rutas del directorio de contenido, rutas de carga y constantes relacionadas.
Complementos imprescindibles	Cualquier complemento imprescindible instalado y sus versiones.
Complementos activos de WordPress	Todos los plugins activos con números de versión y estado de actualización.
Complementos inactivos de WordPress	Todos los complementos inactivos con números de versión.
Configuración del servidor web	Versión de PHP, versión de MySQL y software del servidor web.
Configuración de PHP	Límite de memoria, límites de carga, tiempo de ejecución, variables de entrada máximas y estado de los errores de visualización.
Extensiones PHP	Si cURL, fsockopen, SOAP y Suhosin están disponibles.
Configuración de sesión	Si las sesiones PHP están habilitadas y su configuración.

Compartir información del sistema con el servicio de asistencia técnica

1. Primero, haz clic dentro del área de texto en la pestaña Información del sistema.
2. A continuación, seleccione todo el texto (Ctrl+A o Cmd+A).
3. A continuación, cópialo (Ctrl+C o Cmd+C).
4. Por último, pégalo en tu ticket de soporte técnico o en tu correo electrónico.

Todo el informe está en texto sin formato, por lo que se puede pegar fácilmente en cualquier formulario de asistencia o correo electrónico.

Prueba de conexiones SSL

La pestaña Información del sistema también incluye una sección Probar conexiones SSL. Para ejecutar la prueba, haga clic en el botón Probar conexión para verificar que su servidor puede realizar solicitudes HTTPS salientes a la API de WPConsent. Si esta prueba falla, el escáner y las actualizaciones de la lista de bloqueo remota no funcionarán.

Causas comunes de fallos en las pruebas SSL:

• Tu proveedor de alojamiento bloquea las conexiones HTTPS salientes.
• Un firewall está bloqueando las solicitudes a dominios externos.
• Los certificados SSL del servidor están caducados.

Póngase en contacto con su proveedor de alojamiento si la prueba SSL falla.

Lista de verificación de referencia rápida

Utilice esta lista de comprobación cuando algo no funcione como se esperaba:

1. Abre una ventana privada/de incógnito para descartar las cookies de consentimiento y la caché del navegador.
2. Añadir ?wpconsent_debug a la URL para descartar el bloqueo de scripts como causa.
3. Comprueba la consola del navegador en busca de errores de JavaScript.
4. Comprueba que el banner está habilitado en la configuración de WPConsent.
5. Verifique que el bloqueo de scripts esté habilitado si se supone que los scripts deben bloquearse.
6. Borrar todas las cachés: caché de cookies de WPConsent, caché de páginas del lado del servidor y caché del navegador.
7. Desactive los demás complementos uno por uno para identificar los conflictos.
8. Cambia a un tema predeterminado para descartar problemas relacionados con el tema.
9. Comprueba la página Información del sistema y ejecuta la prueba SSL para verificar la conectividad del servidor.
10. Copia la información del sistema e inclúyela en tu solicitud de asistencia.

Preguntas frecuentes

He cambiado una configuración, pero no ha cambiado nada en la interfaz. ¿Qué pasa?

Es casi seguro que el motivo sea la caché. Borra todas las cachés (caché de cookies de WPConsent, caché de páginas del lado del servidor y caché del navegador) tal y como se describe en borrar cachés. A continuación, prueba en una ventana privada/de incógnito.

¿Cómo puedo saber si el bloqueo de scripts está causando un problema en mi sitio web?

Añadir ?wpconsent_debug a la URL. Si el problema desaparece, la causa es el bloqueo de scripts. Revise el Corregir scripts que no se bloquean correctamente. Sección para los siguientes pasos.

Mi banner aparece cada vez que se carga la página, incluso después de haberlo aceptado. ¿Qué está pasando?

El wpconsent_preferences La cookie no se guarda o se borra entre cargas de página. Comprueba que la duración del consentimiento en WPConsent >> Configuración está establecido en un valor superior a 0. Comprueba también que ningún complemento de seguridad o rendimiento esté eliminando las cookies. Si utilizas el Consentimiento compartido función, confirma que el dominio de la cookie coincide con la configuración de tu subdominio.

Utilizo un creador de páginas y el banner no aparece en el editor. ¿Es normal?

Sí. WPConsent suprime automáticamente el banner dentro de las interfaces del editor Bricks Builder y Divi Builder. Previsualiza la página o visualízala en la interfaz real para ver el banner.

Conclusión

Esta guía cubre los problemas más comunes de WPConsent, desde banners que no aparecen hasta problemas de bloqueo de scripts y conflictos entre plugins. La mayoría de los problemas se resuelven borrando las cachés, comprobando la consola del navegador o aislando el plugin conflictivo. Si necesitas más ayuda, el informe de información del sistema proporciona a nuestro equipo de asistencia todo lo que necesita para ayudarte.

Para obtener más información sobre las herramientas mencionadas aquí, consulte los documentos Información del sistema y Gestión de bases de datos y caché. Si no ha encontrado respuesta a su pregunta aquí, consulte la página de preguntas frecuentes.