Resolução de problemas

Resolva os problemas mais comuns: rastreamento antes do consentimento, atualizações do Consent Mode em falta no GTM, estilos do banner, cache e estatísticas vazias.

Teste sempre numa janela privada do navegador: uma escolha guardada numa visita anterior altera o que vê.

  1. Verifique se o Bloqueio de código personalizado está ativado, no separador Bloqueio de scripts.
  2. Encontre o endereço do script nas ferramentas para programadores do navegador (separador Rede). Se o plugin não o reconhecer, adicione uma regra Bloquear por endereço com parte do endereço e a categoria correta.
  3. Se o script for adicionado pelo Google Tag Manager, atualize o plugin para a versão 1.8.10 ou superior: as versões anteriores não conseguiam ver as tags que o GTM adiciona.
  4. O rastreamento do lado do servidor não pode ser bloqueado a partir do navegador. Configure-o separadamente para respeitar o consentimento.
  • Verifique se o Consent Mode v2 está ativado, no separador Integração.
  • Teste numa sessão nova, sem o cookie kncc_consent, e clique num botão do banner enquanto a pré-visualização está aberta.
  • Confirme que o GTM não é carregado duas vezes, por exemplo por um plugin e pelo tema.

Atualize para a versão 1.8.10 ou superior. A partir dessa versão, as tags de um contentor do GTM aguardam pela sua própria categoria. Veja o artigo do blog.

O banner fica com mau aspeto com o meu tema

Mude Geral → Estilo do texto e tipografia para Estilo do plugin. Se algo continuar a sobrepor-se ao banner, veja as dicas de CSS em Shortcodes, CSS e programadores.

O banner fica atrás de outro elemento

O z-index do banner é 999999. Aumente-o com CSS personalizado se a sobreposição do seu tema ficar por cima.

As páginas estão em cache

O plugin funciona com a cache de páginas: os scripts e os conteúdos incorporados bloqueados são iguais para todos os visitantes, e é o navegador do visitante que decide o que libertar. O WP Rocket, o LiteSpeed Cache e o Autoptimize são configurados automaticamente. Com outro plugin que atrase ou combine JavaScript, exclua dele kncc-consent e knccGuard.

As estatísticas estão vazias

As estatísticas começam a partir da primeira escolha que um visitante faz depois da instalação. Volte a consultá-las após algumas visitas.

Apague os cookies do site ou use uma janela privada, recarregue com Ctrl+Shift+R e confirme que o plugin WP Consent API está ativo.

A página da política avisa de traduções em falta

Crie a página da política traduzida em cada idioma e adicione-lhe o shortcode [kncc_cookie_policy].

Ainda tem problemas?

Pergunte no fórum de suporte no WordPress.org (abre num novo separador). Respondo eu próprio.

Atualizado em 28 de outubro de 2026

Algo errado ou em falta? Diga-me no fórum de suporte. (abre num novo separador)