Documentación de WPConsent

Documentación, materiales de referencia y tutoriales para WPConsent

Integración de la API de consentimiento de WP

¿Quieres que otros plugins de WordPress reconozcan automáticamente las opciones de consentimiento de tus visitantes? WPConsent se integra con el plugin WP Consent API para que las decisiones de consentimiento tomadas a través de tu banner se compartan con todos los plugins compatibles de tu sitio. Esta guía explica qué es la API de WP Consent, por qué es importante la integración y cómo WPConsent asigna sus categorías al formato estándar de la API.

Índice

La API WP Consent es un plugin gratuito de WordPress que crea un lenguaje común para la gestión del consentimiento. En lugar de que cada plugin cree sus propios controles de consentimiento, la API WP Consent proporciona un estándar único que los plugins pueden utilizar para preguntar «¿permite este visitante las cookies estadísticas?» o «¿permite este visitante las cookies de marketing?».

Cualquier plugin que sea compatible con la API de consentimiento de WP puede leer los estados de consentimiento de cualquier plugin de gestión de consentimiento compatible. Esto significa que no estás limitado a un ecosistema específico: tus elecciones de consentimiento se transmiten a todos los plugins que hablan el mismo idioma.

¿Por qué es importante esta integración?

Sin la API de consentimiento de WP, cada plugin gestiona el consentimiento de forma independiente. Esto puede dar lugar a situaciones en las que:

  • Un visitante acepta las cookies a través de su banner WPConsent, pero un plugin de formularios no lo sabe y bloquea la funcionalidad innecesariamente.
  • Un visitante rechaza las cookies de marketing, pero un complemento de análisis se carga de todos modos porque no comprueba el estado de consentimiento de WPConsent.
  • Es necesario configurar manualmente las comprobaciones de consentimiento en varios complementos, en lugar de gestionarlo todo desde un único lugar.

Con la integración activa, WPConsent se convierte en la única fuente de información veraz sobre el consentimiento en tu sitio web. Todos los plugins compatibles con la API de WP Consent respetan automáticamente las elecciones que los visitantes realizan a través de tu banner.

Cómo funciona la integración

Cuando tanto WPConsent como el plugin WP Consent API están activos, la integración se realiza automáticamente. No hay nada que configurar.

Esto es lo que hace WPConsent entre bastidores:

  1. Se registra como gestor de consentimiento activo para que la API de consentimiento de WP sepa qué plugin gestiona el consentimiento.
  2. Establece el tipo de consentimiento (aceptación o rechazo) según la configuración de WPConsent, para que otros plugins sepan si deben bloquear o permitir por defecto.
  3. Sincroniza las opciones de consentimiento cada vez que un visitante guarda sus preferencias a través del banner. WPConsent traduce sus propias categorías al formato estándar de la API de WP Consent.
  4. Evita el doble bloqueo al omitir su propio bloqueo de scripts para los scripts que ya gestiona la API de consentimiento de WP.

Si el plugin WP Consent API no está instalado, WPConsent funciona exactamente igual, simplemente la integración no se activa.

Mapeo de categorías

WPConsent utiliza sus propios nombres de categorías (Esencial, Estadísticas, Marketing), mientras que la API de WP Consent utiliza un conjunto diferente de categorías estándar. WPConsent realiza automáticamente la correspondencia entre ambas cada vez que un visitante guarda sus preferencias.

Categoría WPConsentCategoría API de consentimiento de WPEstado de consentimiento
EsencialfunctionalSiempre permitido
EsencialpreferencesSiempre permitido
EstadísticasstatisticsSegún la elección de los visitantes
Estadísticasstatistics-anonymousSegún la elección de los visitantes
MarketingmarketingSegún la elección de los visitantes

Algunas cosas a tener en cuenta:

  • Esencial mapea a ambos functional y preferences porque WPConsent no tiene una categoría de Preferencias separada. Ambas están siempre configuradas como «permitidas», ya que las cookies esenciales son necesarias para que su sitio web funcione.
  • Estadísticas mapea a ambos statistics y statistics-anonymousLa API de consentimiento de WP distingue entre análisis regulares y anónimos, pero WPConsent los trata de la misma manera: ambos siguen la elección de estadísticas del visitante.
  • Marketing se corresponde directamente con marketing sin traducciones adicionales.

Este mapeo significa que cualquier complemento que compruebe wp_has_consent( 'statistics' ) o wp_has_consent( 'marketing' ) respeta automáticamente las elecciones que los visitantes realizan a través de su banner WPConsent.

WPConsent indica a la API de consentimiento de WP si tu sitio utiliza el consentimiento de inclusión o exclusión:

  • Opt-in (permiso predeterminado desactivado): los scripts y las cookies se bloquean hasta que el visitante los acepta explícitamente. Este es el estándar para el cumplimiento del RGPD.
  • Exclusión voluntaria (permiso predeterminado activado): los scripts y las cookies están permitidos de forma predeterminada hasta que el visitante los rechace activamente.

Esta configuración se lee desde la configuración de WPConsent en WPConsent >> Configuración (el interruptor Permitir por defecto ). Otros plugins que comprueban el tipo de consentimiento pueden entonces ajustar su comportamiento en consecuencia.

Coordinación del bloqueo de guiones

Cuando tanto WPConsent como la API de WP Consent gestionan el mismo script, puede producirse un doble bloqueo. Para evitarlo, WPConsent omite automáticamente su propio bloqueo para los scripts que ya gestiona la API de WP Consent.

Por ejemplo, el script de seguimiento de atribución de WooCommerce se gestiona a través de la API WP Consent. WPConsent detecta esto y permite que la API WP Consent se encargue del bloqueo en lugar de aplicar sus propias reglas.

Configuración de la integración

  1. Instala y activa el plugin WP Consent API desde el repositorio de plugins de WordPress.
  2. Eso es todo. WPConsent detecta automáticamente la API de WP Consent y activa la integración.

No hay que configurar ningún ajuste adicional. La asignación de categorías, la sincronización de tipos de consentimiento y la coordinación del bloqueo de scripts se realizan automáticamente.

Preguntas frecuentes

Sí. La API de consentimiento de WP es un complemento gratuito independiente disponible en el repositorio de complementos de WordPress. Instálalo y actívalo junto con WPConsent para habilitar la integración.

En primer lugar, comprueba que el plugin WP Consent API esté instalado y activo. A continuación, confirma que el otro plugin sea realmente compatible con WP Consent API (consulta su documentación). Por último, prueba en una ventana de incógnito para descartar el estado de consentimiento almacenado en la caché.

No. WPConsent funciona de forma totalmente independiente. La integración de la API WP Consent es una adición opcional que mejora la interoperabilidad con otros plugins que admiten el estándar.

¿La integración requiere configuración?

No. Una vez que ambos complementos están activos, WPConsent se encarga de todo automáticamente: registro, asignación de categorías, sincronización de tipos de consentimiento y coordinación del bloqueo de scripts.

Conclusión

La integración de WP Consent API permite a WPConsent compartir las decisiones de consentimiento con todos los plugins compatibles de tu sitio web a través de una interfaz estandarizada. Instala el plugin WP Consent API y WPConsent se encargará del resto automáticamente. Para obtener más información sobre temas relacionados, consulta la gestión de categorías de cookies y el bloqueo automático de scripts.

¿Le ha resultado útil este artículo?

Artículos relacionados