Consentl

Consentl para Magento 2 / Adobe Commerce

O módulo Consentl para Magento e Adobe Commerce 2.4.6 a 2.4.8: o loader logo a seguir a <meta charset>, uma ligação ao Cookie Restriction Mode e widgets CMS. Luma e Hyvä.

Loader em primeiro lugar no <head>
Sim
Transferir
consentl-module-consent-1.1.0.zip · Versão 1.1.0 · 201 KB · SHA-256

O módulo consentl/module-consent liga a sua loja Magento ao Consentl. Guarda a chave do site por website ou vista de loja, insere o loader imediatamente a seguir a <meta charset>, liga cada escolha ao Cookie Restriction Mode do Magento e disponibiliza widgets CMS. O design do banner, os textos em 34 idiomas, as regras por região e as regras de bloqueio são geridos no painel do Consentl.

Requisitos

  • Magento Open Source ou Adobe Commerce 2.4.6, 2.4.7 ou 2.4.8; PHP 8.1 a 8.4, conforme suportado pela sua versão do Magento.
  • Temas Luma ou Hyvä; são suportados a Full Page Cache incluída e o Varnish.
  • Uma conta Consentl (plano Free disponível).

Instalação

A partir do zip (Transferências): descompacte-o em app/code/Consentl/Consent/, de forma que o composer.json fique no nível superior dessa pasta, e depois execute:

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

Com o Composer: composer require consentl/module-consent assim que o pacote for publicado e depois os mesmos comandos.

Ligar o seu site

Aceda a Stores → Configuration → Consentl → Cookie Consent e selecione primeiro o âmbito (a chave e o idioma podem ser diferentes por website ou vista de loja).

  • Ligar ao Consentl inicia a sua sessão ou cria uma conta gratuita, permite escolher ou criar o site para o domínio desta loja e traz de volta com a Chave de site guardada e o Consentl ativado. A ligação de regresso só é válida na mesma sessão de administração.
  • Ou cole a chave (sk_ + 24 caracteres) e defina Ativar Consentl como Sim.

Depois de guardar, limpe a Full Page Cache, se a sua configuração não o fizer automaticamente.

Configuração

  • Idioma do banner: a opção Automático associa o idioma da vista de loja ao idioma do Consentl mais próximo (de_AT → de, pt_BR → pt-BR, nb_NO → nb). Também pode impor um idioma.
  • Ligação ao Cookie Restriction Mode (recomendada se utilizar os módulos Google Analytics ou Google Tag do Magento):
    1. Defina Stores → Configuration → General → Web → Default Cookie Settings → Cookie Restriction Mode como Yes.
    2. Defina Sincronizar as decisões do Consentl com o modo de restrição de cookies como Sim.
    3. Defina Ocultar o aviso de cookies nativo do Magento como Sim.
    4. Opcional: Recarregar a página após o primeiro consentimento, para que os módulos Google do Luma arranquem na mesma visualização de página e não na seguinte.
  • Avançado: mantenha a posição do loader Primeiro elemento de <head>.

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

Widget Diretiva
Declaração de cookies {{widget type="Consentl\Consent\Block\Widget\CookieDeclaration"}}
Formulário de pedidos relativos a dados pessoais {{widget type="Consentl\Consent\Block\Widget\PrivacyRequest"}}
Formulário de livre resolução da UE {{widget type="Consentl\Consent\Block\Widget\Withdrawal"}}
Ligação para as definições de cookies {{widget type="Consentl\Consent\Block\Widget\PreferencesLink" label="Cookie settings"}}

Qualquer <a href="#consentl">…</a> num bloco CMS também volta a abrir as preferências.

Verificar que funciona

  1. Veja o código-fonte da página: o loader vem imediatamente a seguir a <meta charset>. No Luma, a configuração RequireJS inline do Magento está acima dele; não carrega nada.
  2. Com a ligação ativada: antes de qualquer escolha numa região com opt-in, o cookie user_allowed_save_cookie não está definido; depois de aceitar uma categoria, é definido para o seu website.
  3. As páginas continuam a poder ser guardadas em cache: o resultado não contém dados específicos do visitante.

Content Security Policy

O módulo permite https://api.consentl.com na lista de permissões CSP do Magento e não escreve JavaScript inline, pelo que funciona com a CSP em modo restrito da finalização da compra da versão 2.4.7+ e com temas Hyvä CSP.

Para programadores

Consentl\Consent\ViewModel\Consent::allows('marketing') lê o cookie consentl, apenas em contextos sem cache (finalização da compra, conta de cliente, AJAX). Nas páginas em cache, condicione as tags no HTML com <script type="text/plain" data-consentl="marketing">…</script>.

Limitações

  • Os scripts que outra extensão escreve acima de <meta charset>, ou os scripts inline que um tema coloca antes do conteúdo do head, são executados antes do Consentl.
  • O Magento_GoogleTagManager do Adobe Commerce (código fechado) não foi verificado com a ligação. Utilize o Consent Mode (Pro e superiores, ativado no painel): o Consentl define as predefinições e as atualizações, e as tags do GTM respeitam-nas.
  • O Magento tem um único indicador de opt-in, pelo que a ligação o define quando qualquer categoria opcional é concedida.
  • No Hyvä, se o aviso de cookies do próprio Hyvä continuar a aparecer, remova-o no seu tema com <referenceBlock name="cookie_notices" remove="true"/> em Magento_Cookie/layout/default.xml.
  • A desinstalação deixa os valores de configuração em consentl/* na core_config_data; elimine-os com bin/magento config:delete, se necessário.

Com dificuldades? Escreva para support@consentl.com — respondemos em inglês nos dias úteis.