Consentl

Consentl para Shopware 6

O plugin Consentl para Shopware 6.6 e 6.7 põe o banner primeiro no <head>, substitui a barra de cookies e sincroniza os grupos de cookies com cada escolha.

Loader em primeiro lugar no <head>
Sim
Transferir
consentl-shopware-1.1.1.zip · Versão 1.1.1 · 164 KB · SHA-256

O plugin Consentl liga a sua loja Shopware ao Consentl. Guarda a chave do site por canal de vendas, escreve o loader como primeiro elemento do <head>, substitui a barra de cookies do Shopware e transmite cada escolha aos grupos de cookies do Shopware, para que a lista de desejos, os elementos do YouTube, o Google Analytics e outras funcionalidades a sigam. Os textos, as cores, as regiões e os registos de consentimento são geridos no painel do Consentl.

Requisitos

  • Shopware 6.6 ou 6.7, PHP 8.2 ou posterior.
  • Uma conta Consentl (plano Free disponível).

Instalação

A partir do zip (Transferências):

  1. Na administração, aceda a Extensions → My extensions → Upload extension e escolha o zip, ou execute no servidor:
bin/console plugin:zip-import consentl-shopware-<version>.zip
bin/console plugin:install --activate ConsentlConsent
bin/console cache:clear
  1. Instale e ative o Consentl e depois limpe a cache.

O script da loja do plugin é copiado para public/bundles/consentlconsent/ na ativação; execute bin/console assets:install se fizer a implementação sem o ciclo de vida do plugin.

Ligar o seu site

Abra Extensions → My extensions → Consentl → Configure. As definições aplicam-se por canal de vendas e são herdadas de «Todos os canais de vendas».

  • Ligar ao Consentl inicia a sua sessão, permite escolher ou criar o site e guarda a chave para o canal de vendas selecionado.
  • Ou cole a chave do site (sk_ + 24 caracteres) a partir do painel e guarde.

Configuração

Definição Predefinição Notas
Mostrar o banner do Consentl ativado Desativado = o loader não é escrito; a chave é mantida
Substituir a barra de cookies do Shopware ativado Oculta a barra de cookies e a janela de definições de cookies do Shopware
Sincronizar o consentimento com os grupos de cookies do Shopware ativado Ver abaixo
Categoria para grupos de cookies desconhecidos Marketing Para grupos acrescentados por outras extensões que não podem ser associados
Idioma do banner Automático O idioma do domínio do canal de vendas (de-AT → de)

Grupos de cookies. Os grupos do Shopware correspondem a categorias do Consentl: tecnicamente necessários → estritamente necessários, funcionalidades de conforto → preferências, estatísticas → analíticos, marketing → marketing. Os outros grupos são associados por palavra-chave ou utilizam a categoria de recurso. Quando um visitante decide, o plugin escreve os mesmos cookies que o próprio Shopware escreveria (wishlist-enabled, youtube-video, google-analytics-enabled, …) e anuncia a alteração, para que as extensões que acompanham as alterações de consentimento reajam sem recarregar a página. As ligações para as definições de cookies do Shopware abrem as preferências do Consentl.

Widgets. Bloco Consentl das Shopping Experiences (categoria Text) com os elementos declaração de cookies, formulário de pedidos de privacidade e formulário de livre resolução. Nos temas, pode também utilizar os includes Twig:

{% sw_include '@ConsentlConsent/storefront/consentl/widget.html.twig' with { consentlType: 'declaration' } %}
{% sw_include '@ConsentlConsent/storefront/consentl/settings-link.html.twig' %}

consentlType pode ser declaration, request ou withdrawal.

Verificar que funciona

  1. Veja o código-fonte da página da sua loja: o <head> começa por <script src="https://api.consentl.com/v1/loader.js?k=…&l=de">.
  2. A barra de cookies do Shopware deixa de aparecer; aparece o banner do Consentl.
  3. Rejeite tudo: os cookies google-analytics-enabled, wishlist-enabled e youtube-video não são definidos e o Google Analytics não carrega. Aceite os analíticos: google-analytics-enabled=1 é definido sem recarregar a página.

Para programadores

Em Twig, {% if consentl_allowed('marketing') %}…{% endif %} verifica uma decisão guardada. Só vê o cookie consentl (não as predefinições regionais) e é avaliado quando a página é gerada, pelo que as páginas da cache HTTP do Shopware não são reavaliadas. Prefira o bloqueio do lado do cliente: <script type="text/plain" data-consentl="analytics">…</script>.

Limitações

  • Manter a barra de cookies do Shopware (substituição desativada) põe a funcionar duas interfaces de consentimento; utilize esta opção apenas durante uma transição.
  • O Shopware 6.7 inclui o seu próprio formulário de pedido de revogação (livre resolução). Utilize o formulário de livre resolução do Shopware ou o do Consentl, não ambos.
  • O fluxo de ligação utiliza o anfitrião da administração como domínio; acrescente os domínios da sua loja no painel do Consentl, se forem diferentes.

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