rx_shariff para TYPO3

Por que botões sociais padrão são um problema de LGPD e rx_shariff foi a solução

Todo botão de curtir do Facebook, todo widget de compartilhamento do Twitter e todo embed do LinkedIn transfere dados pessoais para a plataforma - e isso ao carregar a página, não apenas ao clicar. Endereço IP, browser fingerprint e referrer fluem para o Facebook antes que o visitante sequer tenha a possibilidade de consentir. Isso é juridicamente problemático desde a entrada em vigor da LGPD e regulamentos similares, e já levou a notificações contra operadores de sites.

rx_shariff implementa o princípio Shariff, desenvolvido pela editora alemã Heise em 2014 como resposta a esse problema: em vez de incorporar os widgets originais das plataformas, rx_shariff renderiza botões próprios em conformidade com a privacidade. Somente quando um visitante clica no botão é que uma conexão com a plataforma é estabelecida. Sem rastreamento, sem requests de terceiros, sem cookies sem interação.

Cenários típicos de uso

Sites corporativos com requisito de conformidade LGPD. Uma empresa de médio porte quer oferecer botões de compartilhamento social em seus artigos de blog, sem violar a LGPD. O encarregado de proteção de dados proibiu explicitamente os widgets padrão do Facebook e Twitter. rx_shariff entrega botões que só estabelecem conexão ao clicar.

Sites de mídia com contador de compartilhamentos. Uma editora especializada quer exibir sob cada artigo quantas vezes ele foi compartilhado no Facebook e LinkedIn. rx_shariff oferece essa função via proxy de backend opcional: o servidor TYPO3 consulta regularmente as contagens de compartilhamento nas plataformas e cacheia os resultados. As plataformas veem apenas o servidor, nunca o visitante individual.

Portais intranet com compartilhamento controlado. Uma empresa opera um intranet TYPO3 e quer tornar certos artigos compartilháveis especificamente via LinkedIn, mas excluir Facebook e Twitter. rx_shariff pode ser configurado para que apenas plataformas selecionadas apareçam como botões.

Arquitetura técnica

rx_shariff consiste em dois componentes: um widget frontend e um serviço backend opcional.

Widget frontend: O plugin TYPO3 renderiza para cada plataforma configurada um botão HTML. Este botão é um simples anchor link (<a href="...">) com uma URL de compartilhamento como destino. Ao clicar, a página de diálogo de compartilhamento da plataforma se abre em uma nova janela. Nenhum JavaScript é carregado ao carregar a página, nenhum cookie é definido, nenhum recurso externo é requisitado.

Serviço backend (opcional): Para contadores de compartilhamento, rx_shariff opera um proxy server-side. Um script PHP consulta as APIs das plataformas e cacheia os resultados em uma tabela de banco de dados. O frontend exibe o contador cacheado. As APIs das plataformas veem apenas o IP do servidor, nunca o IP do visitante do site.

A configuração ocorre via TypoScript: seleção de plataformas (Facebook, Twitter/X, LinkedIn, Pinterest, WhatsApp, Telegram, e-mail), variante de exibição, ajuste de tema via classes CSS, ativação/desativação de contadores.

Problemas frequentes e soluções

Contadores de compartilhamento sempre mostram 0. As APIs das plataformas requerem autenticação. Sem API key válida, Facebook e LinkedIn não entregam contadores. Twitter/X desativou completamente sua API de contagem de compartilhamentos em 2015. Solução: criar Facebook App no Meta Developer Portal e configurar o token no rx_shariff. Para Twitter, desativar o contador.

Botões não são visíveis após atualização TYPO3. rx_shariff usa um plugin TYPO3 com elemento de conteúdo próprio. Se o plugin não está mais registrado após uma atualização, o elemento de conteúdo desaparece do frontend. Solução: verificar extensão no Extension Manager, atualizar dependências Composer.

Compartilhamento WhatsApp funciona apenas em dispositivos móveis. WhatsApp Web e o app desktop não suportam uniformemente o URL scheme whatsapp://. Solução: em desktop, usar a URL web https://api.whatsapp.com/send?text=..., em dispositivos móveis o app scheme. rx_shariff detecta o user-agent e escolhe o link correto automaticamente.

Migração e compatibilidade de versões

rx_shariff está disponível como pacote Composer estável para TYPO3 v10 e v11. Para TYPO3 v12 existem forks da comunidade. O projeto JavaScript Shariff da Heise foi colocado em modo de manutenção em 2022.

Para novos projetos a partir de TYPO3 v12, a Gosign recomenda uma reavaliação: links de compartilhamento simples (href="https://www.facebook.com/sharer/sharer.php?u=...") são mais leves que rx_shariff, em conformidade com a LGPD e não requerem extensão. A desvantagem: sem contador de compartilhamentos.

A migração de rx_shariff para links de compartilhamento simples leva tipicamente meio dia: remover plugin antigo, criar novos partials Fluid para links de compartilhamento, ajustar CSS. A Gosign realizou essa troca em vários clientes e melhorou o tempo de carregamento da página em 150 a 300ms.

A abordagem de links simples cobre as plataformas comuns: Facebook, LinkedIn, X/Twitter, e-mail e WhatsApp. Todos os links são em conformidade com a proteção de dados, pois nenhum JavaScript é carregado e nenhum cookie de terceiros é definido.