Iubenda logo
Crie Agora

Documentação

Tabela de conteúdos

Cookie Solution – guia de instalação do plugin WordPress

 

Além de manter registros de consentimento para seus formulários da web, nosso plugin de consentimento de cookies do WordPress permite automatizar a implementação dos regulamentos da Lei dos Cookies (política de cookies, banner de cookies e bloqueio prévio), reduzindo significativamente a necessidade de intervenções diretas no código do site.

Requisitos
  • WordPress 4.0 ou superior
  • PHP 5.2.4 ou superior (5.3+ é recomendado)
Plugin da Cookie Solution do iubenda para WordPress

Funcionalidade

  • Nosso plugin de cookie do WP adiciona automaticamente o código do iubenda para todas as páginas de um site (para a seção HEAD)
  • Permite o bloqueio manual de todos os outros recursos, sem intervenção direta sobre os scripts atuais
  • Gerencia a visualização do banner de cookies e da política de cookies, bem como o salvamento das preferências de consentimento dos usuários em relação à instalação de cookies
  • Permite o gerenciamento da Cookie Solution do iubenda para sites multilíngues usando o WPML. Você pode encontrar mais informações sobre esse assunto neste artigo
  • Exibe uma página limpa (sem banner de cookie) para os usuários que já deram seu consentimento
  • Detecta bots/spiders e disponibiliza uma página limpa
  • Auxilia a atribuição automática de categorias ao bloquear scripts
  • É compativel com páginas AMP
  • AdRoll
  • AddThis widgets
  • Bing
  • CodePen
  • Criteo
  • Disqus
  • Elevio
  • Facebook Comments
  • Facebook widgets
  • Freshchat
  • Google AdSense
  • Google Analytics
  • Google Maps
  • Google Site Search
  • Google Tag Manager
  • Google oAuth
  • Google+ widgets
  • Headway
  • Instagram widgets
  • Kissmetrics
  • LinkedIn widgets
  • Mixpanel
  • Neodata
  • Olark
  • Optimizely
  • Outbrain
  • PayPal widgets
  • Pingdom
  • Pinterest widgets
  • Segment
  • ShareThis widgets
  • Twitter widgets
  • UserVoice
  • Vimeo
  • YouTube

Instruções

  • Baixe o plugin do repositório de plugins do WordPress. Acesse o painel de administração no WordPress e clique em Plugins > Add New Plugin > Cookie Solution. Em seguida, instale-o e ative-o.
  • Uma vez instalado, acesse o painel Settings onde será solicitado preenchimento do script gerado em sua conta da iubenda quando você ativou a política de cookies e a Cookie Solution da iubenda (caso ainda não tenha feito, faça agora). Para obter mais informações sobre como ativar nossa solução de gerenciamento de cookies, consulte este manual.

Utilização

Uma vez configurado, o plugin começará a mostrar o banner no qual sua política de cookies será exibida/vinculada aos usuários que visitam seu site pela primeira vez, sem a necessidade de quaisquer outras configurações. Nosso plugin do WP também reconhecerá e, automaticamente, detectará e bloqueará os cookies indicados na lista de bloqueio acima, que estão presentes em seu site.

Importante

Nosso plugin WordPress bloqueia automaticamente os scripts que são gerados por parte do servidor (portanto, retornados pelo PHP pelo WordPress). Os scripts inseridos na página via JavaScript após o processo de carregamento dessa página, não são e não podem ser bloqueados automaticamente.

Esses scripts podem ser bloqueados por meio da inserção do código-fonte nas caixas de Script customizados no console do plugin ou, ainda, por meio do método de empacotamento manual, ilustrado no exemplo abaixo e (mais detalhadamente) neste post de ajuda

Bloqueio de Custom Script no interior do console

O campo Custom Script facilita o bloqueio de scripts inseridos na página diretamente do console do plugin. Isso reduz consideravelmente a necessidade de edições diretas no código do site.

Veja como fazer:

  • No menu à esquerda do painel de administração, clique em Cookie Solution da iubenda.
  • Em seguida, role para baixo para encontrar os campos Custom scripts e Custom iframes próximos ao centro da página.Campos de WordPress personalizados e iframe scripts
  • Insira suas fontes de script ou iframe conforme necessário, atribua sua finalidade (opcional) e clique no botão Salvar alterações na parte inferior esquerda da página.

Exemplos de utilização

Usar esses campos é muito simples. Basta inserir o script ou atributo iframe src que deseja bloquear.

Script

Se você quiser bloquear um botão social (que insere scripts na página através do JavaScript), basta inserir a fonte do script, por exemplo, connect.socialwebsite.net/en_US/track.js no campo de scripts.

iframe

Digamos que você queira bloquear scripts inseridos na página por meio do seguinte iframe.

<iframe width="1280" height="720" src="https://www.videowebsite.com/embed/xxFhMChxx" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

Você precisará inserir videowebsite.com/embed/ no campo iframe, visto que esta é a verdadeira fonte dos scripts. Cuidado para NÃO inserir o id do componente (videowebsite.com/embed/xxFhMChxx) para garantir que todos os scripts provenientes da verdadeira fonte sejam bloqueados.

Utilização manual (método de empacotamento)

Este método exige que você modifique diretamente o código do seu site. Você precisará acessar a seção correspondente do código do seu site e adicionar os scripts a serem bloqueados, conforme explicado abaixo.

Por exemplo, um pixel de conversão para o Google Ads seria tratado desta forma:

<!--IUB-COOKIE-BLOCK-START-->
<script type="text/javascript">
    /* <![CDATA[ */
    var google_conversion_id =CONVERSION_ID;
    var google_conversion_label = "CONVERSION-LABEL";
    var google_custom_params = window.google_tag_params;
    var google_remarketing_only = true;
    /* ]]> */
</script>
<script type="text/javascript" src="//www.googleadservices.com/pagead/conversion.js">
</script>
<noscript>
    <div style="display:inline;">
        <img height="1" width="1" style="border-style:none;" alt="" src="//googleads.g.doubleclick.net/pagead/viewthroughconversion/1030205862/?value=0&amp;guid=ON&amp;script=0"/>
    </div>
</noscript>
<!--IUB-COOKIE-BLOCK-END-->

Se você ativou o recurso de consentimento por categoria, precisará atribuir a finalidade. Retomando o exemplo anterior, sendo parte da finalidade “Direcionamento e publicidade” (id 5):

<!--IUB-COOKIE-BLOCK-START-PURPOSE-5-->
      <script type="text/javascript">
      ...
      </script>
      <script type="text/javascript" src="..."></script>
      <noscript>
      ...
      </noscript>
<!--IUB-COOKIE-BLOCK-END-PURPOSE-5-->

Se houver elementos HTML / IMG / IFRAME, você precisará proceder da seguinte forma:

<!--IUB-COOKIE-BLOCK-START-->
      <iframe src="...
      <img src="...
<!--IUB-COOKIE-BLOCK-END-->

Para interromper o parse/substituição automática do iframe/scripts que contêm um src definido:

<!--IUB-COOKIE-BLOCK-SKIP-START-->
      <script type="text/javascript">...</script>
<!--IUB-COOKIE-BLOCK-SKIP-END-->

Shortcodes estão disponíveis para elementos instalados diretamente nas postagens do WordPress (em oposição aos elementos integrados no nível do modelo – exemplo footer.php):


iubenda e Google AMP – Como coletar consentimento de cookie no WordPress

Se você estiver usando, ou planejando usar, as Accelerated Mobile Pages (AMP) do Google para carregar suas páginas da web mais rapidamente no celular, pode estar se perguntando como configurar seu site WordPress de maneira que permita coletar consentimento de cookies e evitar penalidades. Isso exige um certo trabalho, mas, felizmente, a iubenda pode ajudar: na verdade, nossos plugins Cookie Solution e Consent Solution para WordPress são totalmente compatíveis com AMP.

Para obter um guia passo a passo (completo, com códigos de amostra, uma demonstração e dicas para o WordPress) e mais informações sobre como bloquear cookies antes do consentimento do usuário na AMP, leia Como integrar a Cookie Solution da iubenda com o Google AMP (método WordPress incluído).

Permissões de pasta AMP e “modelos”

Você ativou o suporte para AMP do Google, mas recebeu uma mensagem de erro ao gerar automaticamente o arquivo de configuração da AMP? A causa é um problema com as permissões da pasta “modelos”. Veja como resolver:

  1. Por meio de seu cliente FTP, entre na pasta “iubenda-cookie-law-solution” (carregada anteriormente) e crie (se não existir) uma subpasta chamada “modelos” Pasta de modelos (plugin WordPress do iubenda)
  2. Defina 664 permissões para a pasta “modelos” (a opção “Obter informações/Editar permissões” geralmente está disponível com um clique no botão direito) Permissões de pasta de modelos (plugin WordPress do iubenda)
  3. Repita o procedimento de ativação do “Suporte para AMP do Google” e salve Opções de suporte do Google AMP (plugin WordPress do iubenda)

Informação adicional

Para chamadas de API e xmlrpc, sugerimos o seguinte parâmetro ?iub_no_parse=1: isso desativará o script da iubenda e, evitará todas as operações de análise/substituição.

 

Normalmente, fornecemos versões atualizadas de nosso plugin, instáveis ​​durante a fase de teste, como acontece com as versões Beta.

Para instalar uma versão Beta do plugin, a primeira coisa a fazer é instalar um plugin externo chamado “WP Rollback”, que permite selecionar uma versão não oficial do nosso plugin.

Instalação do WP Rollback

Observação: o WP Rollback requer uma versão do WordPress superior à 4.0.

Em relação aos outros plugins, você pode instalar o WP Rollback acessando a área de plugins no painel de administração do WordPress e clicando em “Add new”; a partir daqui, você pode pesquisar por “WP Rollback” e instalá-lo.

Após a instalação e ativação, será necessário voltar à página onde estão listados todos os plugins instalados. Aqui, você notará que “Rollback” aparecerá ao lado de cada entrada.

Agora, tudo o que precisa ser feito é procurar o plugin “Cookie Solution da iubenda” e clicar no item “Rollback”. Aqui você encontrará todas as diferentes versões do plugin. A versão em uso será rotulada como “versão instalada”, e as versões Beta serão rotuladas como tal.

Para instalar e testar a versão Beta do plugin, basta clicar na entrada Beta que deseja usar. Isso fará com que a versão atual do Plugin seja substituída pela versão Beta. Para reverter o processo, deverá ser realizado o mesmo procedimento, com a diferença de selecionar a versão estável anterior, e não a Beta.

Como sinalizar um bug ou solicitar assistência

Para sinalizar um bug, envie-nos um e-mail e forneça uma descrição clara e detalhada do problema.

É sempre útil anexar as informações de depuração fornecidas pelo WordPress junto com sua solicitação de suporte. Para acessar as informações de depuração, você deve abrir a pasta de instalação do WordPress e procurar o arquivo wp-config.php.

Feito isso, procure a seguinte linha:

define('WP_DEBUG', false);

Mude para:

define('WP_DEBUG', true);

Assim que o arquivo for salvo, abra uma página em seu WordPress e as informações de depuração começarão a aparecer. Mantenha nosso plugin ativo e envie-nos quaisquer erros ou mensagens exibidas pelo WordPress.

Cookie Solution e Consent Solution integradas

Baixe o plugin do WordPress

Leia o changelog

Veja também