Consentl

Consentl para Magento 2 / Adobe Commerce

Módulo de Consentl para Magento y Adobe Commerce 2.4.6 a 2.4.8: cargador tras <meta charset>, puente con Cookie Restriction Mode y widgets de CMS.

Cargador el primero en el <head>
Sí
Descargar
consentl-module-consent-1.1.0.zip · Versión 1.1.0 · 201 KB · SHA-256

El módulo consentl/module-consent conecta su tienda Magento con Consentl. Guarda la clave del sitio por sitio web o vista de tienda, inserta el cargador justo después de <meta charset>, conecta cada elección con el Cookie Restriction Mode de Magento y ofrece widgets de CMS. El diseño del banner, los textos en 34 idiomas, las reglas por región y las reglas de bloqueo se gestionan en el panel de control de Consentl.

Requisitos

  • Magento Open Source o Adobe Commerce 2.4.6, 2.4.7 o 2.4.8; PHP 8.1 a 8.4, según lo admita su versión de Magento.
  • Temas Luma o Hyvä; son compatibles la Full Page Cache integrada y Varnish.
  • Una cuenta de Consentl (hay un plan Free).

Instalación

Desde el zip (Descargas): descomprímalo en app/code/Consentl/Consent/, de modo que composer.json quede en la raíz de esa carpeta, y ejecute:

bin/magento module:enable Consentl_Consent
bin/magento setup:upgrade
bin/magento setup:di:compile              # production mode
bin/magento setup:static-content:deploy   # production mode
bin/magento cache:flush

Con Composer: composer require consentl/module-consent cuando se publique el paquete y, después, los mismos comandos.

Conectar su sitio

Vaya a Stores → Configuration → Consentl → Cookie Consent y seleccione primero el ámbito (la clave y el idioma pueden ser distintos por sitio web o vista de tienda).

  • Connect to Consentl inicia su sesión o crea una cuenta gratuita, le permite elegir o crear el sitio para el dominio de esta tienda y le devuelve con la Site key guardada y Consentl activado. El enlace de retorno solo es válido en la misma sesión de administración.
  • O pegue la clave (sk_ + 24 caracteres) y establezca Enable Consentl en Yes.

Vacíe la Full Page Cache después de guardar si su configuración no lo hace automáticamente.

Configuración

  • Banner language: Automatic asocia la configuración regional de la vista de tienda con el idioma de Consentl más cercano (de_AT → de, pt_BR → pt-BR, nb_NO → nb). También puede forzar un idioma.
  • Puente con el Cookie Restriction Mode (recomendado si utiliza los módulos Google Analytics o Google Tag de Magento):
    1. Establezca Stores → Configuration → General → Web → Default Cookie Settings → Cookie Restriction Mode en Yes.
    2. Establezca Sync Consentl decisions to Cookie Restriction Mode en Yes.
    3. Establezca Hide Magento's native cookie notice en Yes.
    4. Opcional: Reload the page after the first opt-in, para que los módulos de Google de Luma se inicien en la misma vista de página en lugar de en la siguiente.
  • Advanced: mantenga la posición del cargador First element in <head>.

Widgets de CMS (Content → Pages / Blocks → Insert Widget):

Widget Directiva
Declaración de cookies {{widget type="Consentl\Consent\Block\Widget\CookieDeclaration"}}
Formulario de solicitudes sobre datos personales {{widget type="Consentl\Consent\Block\Widget\PrivacyRequest"}}
Formulario de desistimiento de la UE {{widget type="Consentl\Consent\Block\Widget\Withdrawal"}}
Enlace «Configuración de cookies» {{widget type="Consentl\Consent\Block\Widget\PreferencesLink" label="Cookie settings"}}

Cualquier <a href="#consentl">…</a> en un bloque CMS también vuelve a abrir las preferencias.

Comprobar que funciona

  1. Vea el código fuente de la página: el cargador aparece justo después de <meta charset>. En Luma, la configuración de RequireJS en línea de Magento está por encima; no carga nada.
  2. Con el puente activado: antes de cualquier elección en una región con opt-in, la cookie user_allowed_save_cookie no está instalada; después de aceptar una categoría, se instala para su sitio web.
  3. Las páginas siguen pudiendo almacenarse en caché: la salida no contiene datos específicos del visitante.

Content Security Policy

El módulo permite https://api.consentl.com en la lista blanca de CSP de Magento y no imprime JavaScript en línea, por lo que funciona con la CSP en modo restrictivo del proceso de pago de la 2.4.7+ y con los temas CSP de Hyvä.

Para desarrolladores

Consentl\Consent\ViewModel\Consent::allows('marketing') lee la cookie consentl, solo para contextos que no se almacenan en caché (proceso de pago, cuenta de cliente, AJAX). En las páginas en caché, condicione las etiquetas en el HTML con <script type="text/plain" data-consentl="marketing">…</script>.

Limitaciones

  • Los scripts que otra extensión imprime por encima de <meta charset>, o los scripts en línea que un tema coloca antes del contenido del head, se ejecutan antes que Consentl.
  • El módulo Magento_GoogleTagManager de Adobe Commerce (código cerrado) no se ha verificado con el puente. Utilice Consent Mode (Pro y superiores, activado en el panel de control): Consentl establece los valores predeterminados y las actualizaciones, y las etiquetas de GTM los respetan.
  • Magento tiene un único indicador de opt-in, por lo que el puente lo establece cuando se concede cualquier categoría opcional.
  • En Hyvä, si sigue apareciendo el aviso de cookies propio de Hyvä, elimínelo en su tema con <referenceBlock name="cookie_notices" remove="true"/> en Magento_Cookie/layout/default.xml.
  • La desinstalación deja los valores de configuración bajo consentl/* en core_config_data; elimínelos con bin/magento config:delete si es necesario.

¿Se ha atascado? Escriba a support@consentl.com: respondemos en inglés en días laborables.