Iubenda logo
Crie Agora

Documentação

Tabela de conteúdos

Cookie Solution – guia de instalação do plugin Joomla!

O plugin Joomla! da iubenda permite automatizar a implementação das regras da Lei dos Cookies, reduzindo significativamente a necessidade de intervenções diretas no código do site.

Atenção
  • O plugin pode ser baixado diretamente do site oficial Joomla! Extensions Directory
  • O plugin exige Joomla! 2.5 ou superior
  • O plugin funciona melhor com versões do PHP 5.3 ou posteriores
Cookie Solution da iubenda para o Joomla!

Funcionalidade

  • O plugin adiciona automaticamente o código da iubenda a todas as páginas do site (na seção HEAD).
  • Permite bloquear de forma automática ou manual os scripts que podem instalar cookies antes do consentimento, sem a necessidade de intervenção direta no código.
  • Reativa de maneira assíncrona os scripts de cookies, assim que o consentimento é coletado.
  • Gerencia a exibição do banner do cookie e da política de cookies, permitindo que você o personalize inteiramente, a fim de combinar com a aparência e as cores do seu site, caso seja necessário.
  • Salva as preferências do usuário em relação ao uso de cookies e exibe uma página limpa (sem banner) para os usuários que já forneceram seu consentimento.
  • Integra-se à Estrutura de Transparência e Consentimento (TCF) do IAB.
  • Apresenta uma interface de fácil utilização para a inserção de scripts e iframes personalizados.
  • Detecta bots/spiders e fornece uma página limpa para que seu trabalho de SEO não seja comprometido.
  • Auxilia a atribuição automática de categorias ao bloquear scripts.
  • AdRoll
  • AddThis widgets
  • Bing
  • CodePen
  • Criteo
  • Disqus
  • Elevio
  • Facebook Comments
  • Facebook widgets
  • Freshchat
  • Google AdSense
  • Google Analytics
  • Google Maps
  • Google ReCaptcha
  • 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

Se você estiver instalando o plugin pela primeira vez, pule direto para as instruções de instalação aqui.

Caso contrário, se você já instalou uma versão mais antiga do plugin diretamente deste site, pode atualizar para a versão mais recente seguindo as etapas abaixo.

  1. Primeiro, exclua a versão antiga do plugin – clique em Extensões > Gerenciar, selecione o plugin e clique no botão Desinstalar na parte superior da seção.
  2. Acesse o site oficial do Joomla! Extension Directory aqui e baixe o plugin.
  3. Faça a instalação seguindo as etapas abaixo.

Instalação

  • Baixe o plugin grátis aqui.
  • Acesse o painel de Administração (http://example.com/admin123/) e faça login
  • Acesse o menu Extensões, na parte superior da tela no painel do Administração, e clique em Gerenciar > Instalar
  • Arraste e solte o arquivo compactado do plugin da iubenda ou clique em Procurar arquivo e selecione o arquivo iubenda em seu computador.

Ativação

  • Clique em Extensões > Gerenciar > Gerenciar;
  • Pesquise por “iubenda” e ative o plugin.

Como adicionar o banner de cookie e modificar as configurações

  • Clique no item Extensões > Plugins;

  • Pesquise por “iubenda” e clique no nome do plugin (veja abaixo como fica a interface): Cookie Solution - plugin Joomla!

  • Copie o código da Cookie Solution na seção de incorporação da Cookie Solution de sua conta da iubenda Incorporar a Cookie Solution (se você ainda não gerou o código da Cookie Solution na sua conta da iubenda, saiba mais sobre como gerar aqui: introdução à Cookie Solution da iubenda)

  • Clique em Configurações, cole o código no formulário do plugin e salve: Cookie Solution - plugin Joomla! (Caso seja um PHP nativo, é recomendável a primeira e mais rápida opção para o mecanismo de análise. Se surgir algum problema, tente a alternativa baseada em uma classe HTML DOM personalizada)

Começando do seu dashboard Joomla, selecione o ícone  System  à esquerda da tela.

Em seguida, encontre o menu “manage” e selecione Extensions.

Na barra de pesquisa, localizada na parte superior da tela, digite “iubenda” e pressione o botão enter no teclado.

Depois disso, clique no X à esquerda de “iubenda Cookie Solution”.

É isso! Você ativou com sucesso a sua cookie solution iubenda no Joomla! 

Como adicionar e modificar as configurações do banner de cookie

Vamos começar copiando o código da Cookie Solution na seção de incorporação da Cookie Solution na sua conta iubenda. Sob o título ‘Cookie Solution’ no seu painel, selecione o botão <> EMBED.

A seguir, sob o título ‘Incorporar o banner’, clique no botão COPIAR ao lado direito do seu código.

(Se você ainda não gerou o código da Cookie Solution em sua conta da iubenda, pode ler mais sobre como fazer isso em: Cookie Solution da iubenda – introdução e primeiros passos).

Em seguida, vá para o dashboard do Joomla e selecione o item System  localizado à esquerda da tela. 

Em seguida, encontre o menu “manage” e selecione Plugins.

Usando a barra de pesquisa, na parte superior, pesquise “iubenda” e pressione o botão enter no teclado. Depois disso, clique no nome do plugin “iubenda Cookie Solution”.

Em seguida, clique no menu Settings localizado próximo ao menu de plug-ins na parte superior da tela.

Role para baixo até encontrar ‘iubenda code’ e cole o código da Cookie Solution do painel do iubenda na caixa de texto.

Sendo PHP nativo, recomendamos selecionar a opção primary, mais rápida para o mecanismo de análise. Se você estiver enfrentando alguns problemas, tente a alternativa com base em um HTML DOM class personalizado.

Em seguida, no canto superior esquerdo da tela, clique em save & close e pronto! 

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. O plugin também irá reconhecer, detectar e bloquear automaticamente os cookies indicados na lista de bloqueio acima que estão presentes em seu site.

Importante

Nossas extensões Joomla! bloqueiam automaticamente os scripts gerados pelo servidor (portanto, retornados pelo PHP pelo Joomla). Os scripts inseridos na página através do 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 script customizado de dentro 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 painel de Administração, acesse Extensões > Plugins.
  • Em seguida, pesquise por “iubenda”, clique no nome do plugin e na guia Configurações na parte superior.
  • Deslize para baixo para encontrar os campos Custom Scripts e Custom Iframes na parte inferior da página.Campos de scripts personalizados e iframe do Joomla
  • Insira suas fontes de script ou iframe conforme necessário, atribua a categoria (opcional) e clique no botão Salvar e Fechar na parte superior da página.

Exemplos de utilização

Usar esses campos é muito simples. Basta inserir o script ou o 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, uma vez 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 guia (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.

Segue aqui um exemplo de como fazer o plugin funcionar manualmente em um botão Social (que insere scripts na página através do JavaScript).

<!--IUB-COOKIE-BLOCK-START-->
<script>
    (function(d, s, id) {
        var js, fjs = d.getElementsByTagName(s)[0];
        if (d.getElementById(id)) return;
        js = d.createElement(s);
        js.id = id;
        js.src = "//connect.socialwebsite.net/en_US/sdk.js#xfbml=1&version=v2.3&appId=808061959224601";
        fjs.parentNode.insertBefore(js, fjs);
    }(document, 'script', 'socialwebsite-jssdk'));
</script>
<!--IUB-COOKIE-BLOCK-END-->

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

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

Se você ativou o recurso de consentimento por categoria, precisará atribuir a finalidade. Voltando ao exemplo do botão social, fazendo parte da finalidade de “Otimização da experiência” (id 3):

<!--IUB-COOKIE-BLOCK-START-PURPOSE-3-->
<script>
    ...
</script>
<!--IUB-COOKIE-BLOCK-END-PURPOSE-3-->

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-->

Veja também