iFrames em conformidade com a LGPD no TYPO3
Incorporação de iFrames em conformidade com a LGPD no TYPO3: vídeos, mapas e redes sociais só carregam após o consentimento. Solução de dois cliques.
Agendar reunião inicial gratuitaIncorporar YouTube e Google Maps sem consentimento entrega o IP do visitante antes de qualquer clique
Todo iFrame de um serviço externo transmite o endereço IP do visitante ao provedor do serviço antes mesmo de qualquer interação. Um vídeo do YouTube na página inicial envia o IP ao Google assim que a página carrega; um mapa do Google Maps, também ao Google; um widget do Facebook, à Meta. Para a LGPD (PT: RGPD), o endereço IP pode ser dado pessoal, e esse envio é um tratamento de dados que precisa de uma base legal. Para conteúdo de terceiros que o site não precisa para funcionar, o caminho mais seguro é o consentimento prévio e informado do visitante. Na União Europeia, incluindo Portugal, a questão dos cookies que esses serviços instalam está decidida desde o acórdão Planet49 do Tribunal de Justiça da União Europeia (2019) e, na Alemanha, desde a decisão do Tribunal Federal de Justiça (BGH) sobre o consentimento para cookies: o que não é tecnicamente necessário exige consentimento ativo e informado. O udg_gdpr_iframe implementa no TYPO3 a solução de dois cliques: os iFrames só carregam depois de um clique explícito do visitante. Um placeholder informa qual serviço será carregado e quais dados serão transmitidos.
YouTube, Google Maps e redes sociais são os embeds que mais aparecem
O cenário mais comum são vídeos do YouTube em sites corporativos. Uma empresa mostra um vídeo de recrutamento na página de carreiras. Sem uma solução de consentimento, a página envia o IP de cada visitante ao Google. Com o udg_gdpr_iframe, o visitante vê, no lugar do vídeo, um placeholder com imagem de prévia, o aviso “Este vídeo é fornecido pelo YouTube. Ao reproduzi-lo, dados serão transmitidos ao Google.” e um botão “Carregar vídeo”. Só depois do clique o iFrame carrega e o vídeo começa.
O segundo cenário é o mapa do Google Maps na página de contato. O mapa de como chegar é um elemento padrão, mas também um risco de proteção de dados. O udg_gdpr_iframe mostra no lugar dele uma imagem estática do mapa (uma captura de tela) como placeholder. Quem precisa do mapa interativo clica em “Carregar mapa” e, com isso, aceita a transmissão de dados ao Google.
Terceiro cenário: embeds de redes sociais. Um artigo de blog cita um tweet ou um post do Instagram. Esses embeds também carregam recursos externos e transmitem dados do usuário. O udg_gdpr_iframe bloqueia o embed e mostra um placeholder que identifica o serviço e exibe um texto de prévia.
Um placeholder ocupa o lugar do iFrame, e um loader em JavaScript só carrega o conteúdo após o clique
A extensão registra um elemento de conteúdo próprio ou modifica os elementos de conteúdo existentes do TYPO3 que contêm iFrames. No HTML, o atributo src do iFrame é trocado por um atributo data-src. O navegador não carrega o iFrame, porque falta o atributo src. Em vez disso, uma div de placeholder mostra o nome do serviço, o aviso de privacidade e um botão de ativação.
Ao clicar no botão, um trecho de JavaScript copia o data-src para o atributo src, e o navegador carrega o iFrame. Opcionalmente, o visitante pode marcar a caixa “Sempre carregar”, que guarda a decisão no LocalStorage. Nas visitas seguintes, o iFrame carrega sem nova interação.
A apresentação do placeholder é configurável por template Fluid: imagem de prévia (por exemplo, a miniatura do YouTube), texto, rótulo do botão e link para a política de privacidade. Para vídeos do YouTube, a extensão pode buscar a miniatura automaticamente na API do YouTube. Isso só respeita a proteção de dados se o TYPO3 baixar a imagem no servidor e a entregar ele mesmo: se o navegador a carregar direto do YouTube, o endereço IP também vai para o Google.
A integração com plataformas de gestão de consentimento (CMP) já em uso, como Cookiebot e OneTrust, é possível pela API JavaScript: se o visitante aceitou a categoria “Marketing” no banner de cookies, todos os iFrames de marketing carregam automaticamente, sem os dois cliques.
Achar todos os iFrames e conviver com a plataforma de consentimento são os pontos difíceis
O maior problema é identificar todos os iFrames do site. A equipe editorial não incorpora iFrames só por elementos de conteúdo, mas também direto no RTE (editor de texto rico), em templates Fluid e em TypoScript. A extensão precisa cobrir todas essas fontes. Um erro frequente: os elementos de conteúdo estão protegidos, mas um iFrame do YouTube no template do rodapé continua carregando sem consentimento. A solução: depois da instalação, rastrear o site inteiro e identificar todas as origens de iFrames.
Segundo problema: a integração com a gestão de consentimento. Se o site já usa Cookiebot ou OneTrust, pode haver conflito: a CMP bloqueia o iFrame com o próprio mecanismo, e o udg_gdpr_iframe o bloqueia de novo. O resultado são placeholders duplicados ou um iFrame que não carrega nem depois do consentimento dado na CMP. A solução: usar o udg_gdpr_iframe ou a CMP para bloquear iFrames, nunca os dois.
Terceiro ponto: acessibilidade. O placeholder precisa funcionar com leitores de tela: o botão precisa de um aria-label, o aviso de privacidade tem de estar em texto (não em imagem), e a navegação por teclado precisa funcionar.
O TYPO3 v12 é suportado, e a extensão continua relevante enquanto existirem iFrames
O udg_gdpr_iframe resolve um problema que ganha peso a cada nova interpretação da LGPD pela ANPD (Agência Nacional de Proteção de Dados) e do RGPD pelas autoridades europeias. A extensão roda de forma estável no TYPO3 v12. Para o v13, é preciso atualizar o registro dos elementos de conteúdo e o loader em JavaScript. Como a funcionalidade central (trocar o src do iFrame por data-src) é tecnicamente trivial, a extensão pode ser portada para qualquer versão do TYPO3 com pouco esforço, se necessário. Nas auditorias de proteção de dados, a Gosign verifica a cobertura completa dos iFrames e recomenda a solução que combina com a gestão de consentimento já existente no site.
Reunião inicial gratuita: 30 minutos com um especialista TYPO3
Analisamos seu projeto, estimamos esforço e prazo - sem compromisso, sem preparação.
Agende uma consultoria sobre LGPD, 30 min, gratuito25 anos de experiência em TYPO3 · mais de 800 extensões analisadas · desenvolvimento acelerado por IA
Desenvolvimento acelerado por IA: 75% mais rápido
Atualização TYPO3 e auditoria LGPD
Atualizamos sua instalação TYPO3 de forma econômica para a versão LTS atual - incluindo todas as extensões, mesmo as obsoletas e sem manutenção.
Todas as extensões migradas
Também obsoletas, sem manutenção ou desenvolvimentos próprios.
Oferta de preço fixo
Custos transparentes, sem retrabalhos escondidos.
Acelerado por IA
30-50% mais barato que o mercado graças à análise de código assistida por IA.
Zero perda de dados
Migração completa com backup e rollback.
Auditoria LGPD: Auditamos sua instalação TYPO3 quanto à conformidade com a LGPD - consentimento de cookies, rastreamento, extensões, formulários e hospedagem - e implementamos todas as medidas de forma econômica.
A Gosign é uma agência digital sediada em Hamburgo com 25 anos de experiência em desenvolvimento TYPO3. Analisamos mais de 800 extensões TYPO3 e hoje desenvolvemos com assistência de IA até 70% mais rápido que com métodos clássicos. Nossos clientes são empresas de médio porte, universidades e instituições públicas em toda a Europa.
Atualizado: abril 2026
Agendar reunião inicial gratuita
30 minutos com um especialista TYPO3, sem compromisso.
Agendar reunião