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

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/de consentimento 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.
- O recurso de configuração remota permite que a maioria das alterações feitas no configurador sejam aplicadas diretamente ao seu site, sem a necessidade de reincorporar o código.
- 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.
- 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.
- Acesse o site oficial do Joomla! Extension Directory aqui e baixe o plugin.
- 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
Joomla 3.10 (instruções antigas)
- 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):
Copie o código do Privacy Controls and Cookie Solution na seção de incorporação do Privacy Controls and Cookie Solution da sua conta iubenda
(se você ainda não gerou o código do Privacy Controls and Cookie Solution na sua conta da iubenda, saiba mais sobre como gerar aqui: introdução ao Privacy Controls and Cookie Solution da iubenda)
Clique em Configurações, cole o código no formulário do plugin e salve:
(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 Privacy Controls and Cookie Solution”.

É isso! Você ativou com sucesso o seu privacy controls and cookie solution iubenda no Joomla!

Como adicionar e modificar as configurações do banner de cookie/de consentimento
Vamos começar copiando o código do Privacy Controls and Cookie Solution na seção de incorporação do Privacy Controls and Cookie Solution na sua conta iubenda. Sob o título ‘Privacy Controls and 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 do Privacy Controls da Cookie Solution em sua conta da iubenda, pode ler mais sobre como fazer isso em: Privacy Controls and 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 Privacy Controls and 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 do Privacy Controls and Cookie Solution do painel da 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.
- 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á videowebsite.com/embed/
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
<!--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 “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-->
⚠️ Caution
Após a instalação, certifique-se de configurar o bloqueio prévio, uma vez que isso é legalmente obrigatório de acordo com a legislação da UE. Você pode encontrar vários métodos de bloqueio prévio juntamente com instruções completas neste guia.