Widget de Feed Twitter e X - Cronologia ao Vivo ou Tweet em Destaque na Sua Loja, Sem Chaves API

A sua prova social, na página onde ela vende

Um feed activo diz ao visitante que existe um negócio real por detrás da loja — stock novo, respostas a clientes, um anúncio desta manhã. Este módulo coloca esse feed onde ele rende mais, e a configuração demora cerca de um minuto.

Sem chaves API. Nenhumas. Nunca.

É este o propósito da versão 4. Introduza o seu nome de utilizador — cole-o com ou sem o @ inicial, o módulo remove-o por si — e está feito. Não há conta de programador para registar, nem fluxo OAuth, nem aplicação para criar, nem chaves para colar, nem credenciais para guardar, porque o módulo nunca lida com nenhumas.

Cronologia ao vivo, ou um tweet em destaque

A cronologia ao vivo mostra um fluxo continuamente actualizado das suas publicações mais recentes. O tweet em destaque mostra uma publicação específica à sua escolha — cole a ligação e é essa que os visitantes vêem.

O segundo modo merece atenção por uma razão prática. O serviço público de incorporação do Twitter/X impõe um limite de pedidos bastante apertado, e uma cronologia que se actualiza continuamente consegue esgotar sozinha grande parte dessa quota. Como o tweet em destaque só pede sempre uma publicação fixa, aguenta-se melhor quando a plataforma está sob carga. Se valoriza a fiabilidade mais do que as actualizações automáticas, é esse o modo a escolher.

Cinco posicionamentos, escolhidos na página de configuração

Coluna esquerda, coluna direita, rodapé, página inicial ou um botão flutuante fixo ao canto inferior esquerdo. Escolhe o local na própria página do módulo — não é preciso ir a Design → Posições, e a alteração produz efeito de imediato.

Há um ponto a deixar claro, porque condiciona a forma como usa o módulo: todos os posicionamentos apresentam um botão compacto, e o feed abre numa janela sobreposta quando o visitante clica nele. A cronologia não fica embutida na sua coluna. Isso mantém uma incorporação de terceiros fora do seu caminho crítico de renderização, e significa que o módulo nunca empurra o seu próprio conteúdo para baixo na página.

Feito para condizer com o seu tema

Claro ou escuro, mais uma cor de destaque opcional para as ligações dentro do widget. Outros quatro interruptores ocultam o cabeçalho, ocultam o rodapé, retiram os contornos ou tornam o fundo transparente — aplicam-se à cronologia ao vivo, e a ajuda de cada campo di-lo. Escolha um número fixo de tweets de 1 a 20, ou um feed com deslocamento com qualquer altura entre 200 e 1200 píxeis.

Para o tweet em destaque há mais dois interruptores: ocultar a ligação Ver esta conversa e ocultar as pré-visualizações de fotografias, vídeos e ligações, se quiser apenas as palavras.

Tudo o que um visitante espera de um tweet

Por se tratar do widget oficial do Twitter/X e não de texto extraído, os visitantes recebem a coisa verdadeira — responder, retweetar e gostar funcionam todos nativamente, tal como na própria plataforma. Multimédia, conversas e pré-visualizações de ligações são apresentadas como devem ser.

Validação clara, e uma pré-visualização antes de publicar

Não há adivinhação sobre se as definições estão correctas. Se algo estiver errado, a gravação é rejeitada com uma mensagem em linguagem simples — "Introduza um nome de utilizador Twitter/X válido: letras, números e sublinhados apenas, até 15 caracteres", ou o equivalente para uma ligação de tweet malformada ou uma cor hexadecimal inválida — e nada é escrito, pelo que uma gralha não pode substituir em silêncio uma configuração que funciona. Assim que um nome de utilizador ou tweet é guardado, uma pré-visualização ao vivo na página de configuração mostra o que os visitantes vão ver.

Uma nota honesta sobre personalização

O widget oficial expõe um tema claro/escuro e uma única cor de destaque, e é genuinamente tudo o que expõe. Se quiser reformular livremente o estilo do texto dos tweets, nenhum módulo lho consegue dar através da incorporação oficial — é essa a contrapartida de um feed que não precisa de chaves API e não deixa de funcionar quando a plataforma muda as regras.

A versão 4 eliminou um problema de segurança real

Isto importa mais do que qualquer funcionalidade. As versões anteriores obtinham os tweets através da API v1.1 do Twitter usando uma biblioteca OAuth incorporada com uma década de idade e credenciais de programador fixas no código, distribuídas dentro de cada cópia do módulo. O Twitter/X encerrou o acesso gratuito a essa API em 2023, pelo que a integração tinha deixado de funcionar de forma fiável — e pior, essas credenciais expostas faziam com que uma instalação não configurada mostrasse silenciosamente, por predefinição, o feed de outra pessoa.

A versão 4 remove tudo isso: sem camada API, sem biblioteca OAuth incorporada, sem credenciais para fugirem e sem nada no módulo que uma mudança de política da plataforma possa quebrar.

A actualização limpa o que a versão antiga deixou

Abra o módulo e ele migra-se sozinho. As antigas chaves API e as definições legadas que já não se aplicam são removidas deliberadamente, em vez de ficarem esquecidas na sua base de dados. O seu nome de utilizador e o posicionamento transitam intactos.

A versão 4.1.1 corrigiu também uma falha de actualização que merece ser dita com clareza: o passo da 4.0.1 fazia depender o seu êxito de uma chamada registerHook() devolver true, pelo que uma falha transitória — ou um hook já registado por uma tentativa anterior incompleta — marcava o passo como falhado e o PrestaShop desactivava o módulo. O hook passou a ser registado de forma idempotente e o passo comunica sempre êxito.

Uma definição de privacidade, e uma resposta directa sobre rastreio

Um interruptor Do Not Track opcional pede ao Twitter/X que não personalize nem rastreie os visitantes através do widget. Tenha noção do que isso faz e não faz: não impede o carregamento do ficheiro de código. Este módulo carrega um ficheiro de platform.twitter.com nas páginas onde o feed aparece, e deve divulgá-lo na sua política de cookies e de privacidade, tal como faria com qualquer incorporação de terceiros.

Compatibilidade

PrestaShop 1.7, 8 e 9, em oito idiomas: alemão, espanhol, francês, inglês, italiano, neerlandês, polaco e turco. Como o feed abre numa janela sobreposta, todos os posicionamentos dependem da modal Bootstrap do seu tema — algo padrão no tema classic e nos seus derivados, e que vale a pena verificar num tema muito personalizado. O nome técnico do módulo mantém-se inalterado face às versões anteriores, pelo que as instalações existentes actualizam sem sobressaltos.

Perguntas frequentes

Preciso de uma conta de programador do Twitter ou de chaves API?

Não. Introduza o seu nome de utilizador sem o @ e está feito. Não há nada para registar nem credenciais para guardar.

Qual é a diferença entre os dois modos?

A cronologia ao vivo actualiza-se automaticamente com as suas publicações mais recentes. O tweet em destaque mostra uma publicação à sua escolha e, como só pede sempre essa única publicação, é mais resistente quando o Twitter/X limita os pedidos ao seu serviço de incorporação.

Onde o posso colocar, e o feed aparece embutido?

Coluna esquerda, coluna direita, rodapé, página inicial ou um botão flutuante no canto inferior esquerdo, à escolha na página de configuração. Em todos os casos o posicionamento apresenta um botão e o feed abre numa janela sobreposta à sua loja — não fica embutido na coluna.

O meu feed mostra "Não foi possível carregar o feed ao vivo neste momento."

O próprio serviço de incorporação do Twitter/X rejeitou o pedido ou aplicou-lhe um limite. Não é algo que o módulo controle e, normalmente, resolve-se sozinho em poucos minutos. Se acontecer com frequência, mude para o modo de tweet em destaque.

Posso alterar o estilo dos tweets para condizer exactamente com a minha marca?

Só até certo ponto — o widget oficial oferece um tema claro ou escuro e uma cor de destaque. Esse limite vem do Twitter/X, não deste módulo.

Os visitantes podem responder e retweetar a partir da minha loja?

Sim. É a incorporação oficial, por isso responder, retweetar e gostar funcionam nativamente.

Actualizei a partir de uma versão antiga — o que aconteceu às minhas chaves API?

Foram removidas de propósito, juntamente com outras definições legadas. A antiga integração precisava de credenciais que estiveram publicamente expostas durante anos; a nova precisa apenas do seu nome de utilizador.

Funciona com os requisitos do RGPD?

Existe uma opção Do Not Track que pede ao Twitter/X que não personalize a experiência, mas o ficheiro de incorporação continua a ser carregado. Divulgue-o na sua política de privacidade, tal como faria com qualquer incorporação de terceiros.