Consentl para WordPress

Instale o plugin Consentl, clique em Ligar e o banner carrega primeiro no <head>. Funciona com a WP Consent API, caches, WPML, Polylang, temas de blocos e clássicos.

Loader em primeiro lugar no <head>

Sim

Transferir

consentl-wordpress-1.1.0.zip · Versão 1.1.0 · 248 KB · SHA-256

O plugin Consentl guarda a sua chave do site, escreve o loader do Consentl como primeiro elemento do <head>, transmite cada escolha à WP Consent API (site externo) e ao WooCommerce e acrescenta blocos e shortcodes para a declaração de cookies, o formulário de pedidos relativos a dados pessoais e o formulário de livre resolução da UE. O banner propriamente dito, os seus textos e as regiões são geridos no painel do Consentl.

Requisitos

• WordPress 6.5 ou posterior, PHP 7.4 ou posterior.
• Uma conta Consentl (plano Free disponível).
• Opcional: o plugin WP Consent API (2.0+), WooCommerce 8.5+.

Instalação

1. Transfira o zip do plugin a partir de Transferências. Ficará também disponível no WordPress.org assim que for publicado lá.
2. No WordPress, aceda a Plugins → Adicionar novo → Carregar plugin, escolha o zip, clique em Instalar agora e depois em Ativar.
3. Limpe a cache de páginas, se utilizar uma.

Atualizações

A partir da versão 1.1.0, o plugin consulta consentl.com para verificar se há novas versões, que aparecem assim em Painel → Atualizações e no ecrã Plugins como qualquer outra atualização, com Ver detalhes, atualizações com um clique e atualizações automáticas (também na administração de uma rede multisite). O WordPress verifica cerca de duas vezes por dia; Verificar novamente em Painel → Atualizações verifica de imediato. A verificação não envia nenhuma chave do site, endereço do site nem dados de visitantes. Se instalou a versão 1.0.0, carregue o novo zip uma vez (Plugins → Adicionar novo → Carregar plugin e depois «Replace current with uploaded»); as versões seguintes chegam automaticamente.

Se o seu servidor bloquear pedidos de saída (WP_HTTP_BLOCK_EXTERNAL), permita consentl.com ao lado de api.wordpress.org em WP_ACCESSIBLE_HOSTS, ou continue a carregar os novos zips manualmente. Para desativar a verificação de atualizações, acrescente define( 'CONSENTL_SELF_UPDATE', false ); ao wp-config.php.

Ligar o seu site

1. Aceda a Definições → Consentl e clique em Ligar ao Consentl.
2. Inicie sessão ou crie uma conta gratuita e escolha ou crie o seu site. Regressa ao WordPress com a chave do site preenchida e o estado mostra Ligado.

Também pode colar a chave (começa por sk_) a partir do painel. Para a fixar por ambiente, acrescente esta linha ao wp-config.php; o campo passa então a ser só de leitura:

define( 'CONSENTL_SITE_KEY', 'sk_…' );

Configuração

Em Definições → Consentl:

• Idioma do banner: a opção automática (predefinição) segue o idioma da página definido pelo WPML ou pelo Polylang, ou a língua do WordPress. A opção de idioma do site utiliza o idioma de Definições → Geral. Idioma fixo utiliza um único idioma em todas as páginas.
• WP Consent API (ativada por predefinição): os plugins que seguem a WP Consent API (por exemplo Site Kit by Google, WooCommerce, WP Statistics, Burst Statistics) recebem automaticamente a escolha do visitante.
• Abrir o painel do Consentl para o design do banner, os textos, as regiões, os cookies, o registo de consentimentos e os pedidos relativos a dados pessoais. As alterações aparecem no seu site em cerca de cinco minutos.

Em seguida, acrescente estes elementos à sua página da política de privacidade ou de cookies:

Nos menus, acrescente uma ligação personalizada para #consentl para voltar a abrir as preferências.

Verificar que funciona

1. Abra o seu site numa janela privada e veja o código-fonte da página: o loader do Consentl é o primeiro <script> no <head>, logo a seguir a <meta charset>.
2. O banner aparece. Na consola do navegador, Consentl.get() mostra as escolhas atuais.
3. Com a WP Consent API instalada, wp_has_consent('statistics') é false antes de aceitar as estatísticas numa região com opt-in e true depois.

Plugins de cache e otimização

O HTML da página é o mesmo para todos os visitantes e cada escolha é aplicada no navegador, pelo que a cache de página completa é segura. O loader é excluído automaticamente do adiamento, do atraso e da combinação no WP Rocket, LiteSpeed Cache, Autoptimize, SiteGround Speed Optimizer, Jetpack Boost e Cloudflare Rocket Loader. Noutros plugins de otimização (Perfmatters, FlyingPress, WP-Optimize, Hummingbird, NitroPack, etc.), exclua /v1/loader.js de «delay JS», «defer JS» e «combine JS».

Para programadores

• consentl_has_consent( 'analytics' ) é verdadeiro quando o visitante permitiu a categoria (necessary, preferences, analytics, marketing ou sale). Lê o cookie consentl; não o utilize em fragmentos guardados em cache por página.
• consentl_get_consent() devolve a decisão guardada, ou null.
• consentl_loader_tag() escreve o loader manualmente, para temas que emitem scripts antes de wp_head() (por exemplo, um fragmento do Google Tag Manager colado imediatamente a seguir a <head>).
• JavaScript: Consentl.get(), Consentl.allowed('marketing'), Consentl.on('change', fn), Consentl.open('prefs') e o evento consentl:change em document.
• Filtros: consentl_should_load, consentl_loader_attributes, consentl_head_priority, consentl_locale, consentl_has_consent, consentl_woocommerce_attribution_client_side, consentl_api_origin, consentl_app_origin.

Limitações

• Não utilize dois plugins de consentimento: o Complianz, o CookieYes, o Cookiebot e plugins semelhantes também respondem à WP Consent API e entrariam em conflito. Desative o outro.
• As páginas AMP não carregam o banner (o AMP exige amp-consent, que não é suportado).
• Os scripts que um tema escreve antes de wp_head() são executados antes do Consentl; utilize consentl_loader_tag() conforme descrito acima.
• Com uma Content Security Policy, permita https://api.consentl.com em script-src e connect-src (consulte Qualquer site).
• Numa rede multisite, cada site precisa da sua própria chave do site.
• Quando elimina o plugin, as respetivas definições são removidas. O seu registo de consentimentos permanece na sua conta Consentl, porque é a sua prova do consentimento.

Guias relacionados

• WooCommerce
• Qualquer site (fragmento de código)
• Google Tag Manager

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