Topic Translate Single

[Chico Gois]

Transforme seu fórum em uma comunidade verdadeiramente global! Agora, seus usuários podem traduzir posts individuais com apenas um clique, mantendo a leitura fluida e o layout impecável.

O que há de novo:
Tradução Inteligente por Post: Chega de traduzir a página inteira e perder a referência. Traduza apenas o conteúdo que importa, post por post.

Exclusivo: Pacote "Extra Dark": Pensado para comunidades modernas, incluímos um conjunto de estilos otimizados para Temas Escuros. O menu e os destaques se adaptam perfeitamente a fundos pretos ou grafites, garantindo conforto visual.

Detecção Automática: O tradutor identifica o idioma do visitante e sugere a melhor tradução instantaneamente.

Nomes Nativos: Opção de exibir os idiomas em sua escrita original (ex: Español, Français, 日本語), facilitando a vida de quem vem de fora.

Privacidade e Performance: O motor de tradução só é ativado quando o usuário clica. Isso mantém seu fórum rápido e limpo para quem não precisa de tradução.

Download: https://github.com/mundophpbb/topictranslatesingle

[Chico Gois]

Por que usar esta extensão em vez da tradução integrada do navegador?
Vi alguns comentários mencionando que os navegadores modernos (Chrome, Edge) já possuem tradução integrada. Embora isso seja verdade, esta extensão resolve três problemas principais causados ​​pela tradução em nível de navegador:

1. Preservação da interface: A tradução do navegador geralmente traduz tudo — incluindo nomes de usuário, rótulos de botões, categorias do fórum e termos técnicos. Isso pode quebrar o layout do fórum e tornar a navegação confusa. Minha extensão traduz **apenas** a área de conteúdo do post, mantendo a interface do usuário do fórum no idioma preferido do usuário.
2. Tópicos multilíngues: Em tópicos onde os usuários falam idiomas diferentes (por exemplo, um post em inglês seguido por uma resposta em português), os tradutores do navegador frequentemente se confundem ou "traduzem duas vezes" o conteúdo. Esta extensão permite que o usuário traduza cirurgicamente apenas o post específico que não entende.
3. Experiência do Usuário e Inclusão: ** Torna o fórum mais acolhedor para membros internacionais que possam se sentir intimidados pela barreira do idioma. Fornecer um botão visível e fácil de usar demonstra que "somos uma comunidade global" e auxilia usuários que podem não ter conhecimento técnico suficiente para usar as ferramentas do navegador.

Principais Recursos:

- Botões "Traduzir" e "Redefinir"** em cada postagem.
- Detecção Dinâmica de Idioma:** Define automaticamente o idioma padrão com base na sessão phpBB do usuário (`{S_USER_LANG}`).
- Redefinição Limpa:** Um botão dedicado para reverter a postagem ao seu estado original sem atualizar a página.
- Foco na Privacidade: Usa tags `notranslate` para garantir que dados privados, nomes de usuário e elementos da interface do usuário nunca sejam enviados para servidores de tradução.

A tradução do navegador é uma abordagem "bruta". Esta extensão é como um bisturi. Ela dá ao usuário controle sobre exatamente o que é traduzido e quando, preservando a integridade do design do fórum.

[Chico Gois]

[center]Topic Translate Single
Extensão para phpBB com tradução de conteúdo de tópico usando GTranslate[/center]

Visão geral

A extensão Topic Translate Single foi pensada para traduzir somente o conteúdo do post, sem traduzir o fórum inteiro.

A proposta é simples:

• o usuário clica no botão de tradução do post
• escolhe o idioma desejado
• a tradução é aplicada apenas naquele conteúdo

Isso evita poluição visual na página inteira e torna o recurso mais útil em fóruns multilíngues.

Principais pontos da refatoração

Nesta etapa foi feita uma refatoração completa com foco em robustez, manutenção, compatibilidade e experiência de uso.

• carregamento restrito ao viewtopic, evitando script global desnecessário em outras páginas
• remoção de JS inline, com frontend separado em arquivo próprio
• lista de idiomas centralizada em uma única fonte
• validação real no ACP dos idiomas permitidos
• remoção de dependências externas desnecessárias no ACP, como fontes e ícones via CDN
• modo de compatibilidade para ambientes mais sensíveis a bloqueios
• suporte a habilitação por fórum
• restauração do conteúdo original sem recarregar a página
• melhoria do controle de estado do widget, evitando falsos erros de carregamento
• melhor acessibilidade no botão e no seletor
• melhor UX com fechamento por botão, tecla ESC e reaproveitamento do último idioma usado

Recursos atuais

• tradução apenas do conteúdo do post
• idioma padrão configurável
• idiomas disponíveis configuráveis
• nomes nativos dos idiomas
• detecção opcional do idioma do navegador
• habilitação por fórum
• modo de compatibilidade
• botão para restaurar o conteúdo original
• memória do último idioma usado
• botão rápido para reutilizar o último idioma

Melhorias de interface e usabilidade

• o seletor pode ser aberto e fechado pelo mesmo botão
• o seletor pode ser fechado com a tecla Esc
• o foco vai automaticamente para o campo de idioma
• o botão indica melhor o estado ativo/traduzido
• o conteúdo original pode ser restaurado sem reload
• mensagens de erro e carregamento ficaram mais claras

Compatibilidade técnica

• phpBB 3.3+
• suporte a estilos com implementação em prosilver e extra_dark
• integração com GTranslate para tradução do conteúdo

Resumo das versões refatoradas

1.1.0

• carregamento restrito ao viewtopic
• JS extraído para arquivo próprio
• idiomas centralizados
• ACP com validação
• limpeza de dependências externas do ACP

1.2.0

• habilitação por fórum
• nova migration para upgrade
• restauração sem reload
• botão de restaurar original

1.3.0

• substituição da restauração baseada em innerHTML
• uso de snapshot do nó original do post
• retorno mais limpo do DOM original

1.4.0

• estado de carregamento real
• detecção melhor de falha do widget
• modo de compatibilidade

1.4.1 / 1.4.2

• correções de regressão no seletor e nos créditos
• ajuste do controle de estado do widget
• eliminação de falsos erros em localhost e cenários com cache

1.5.0

• lembrar último idioma usado
• usar último idioma com um clique
• fechar com o mesmo botão
• fechar com ESC
• melhor estado visual do botão

Observações importantes

• como a extensão depende de serviço externo, o funcionamento pode variar conforme CSP, AdBlock, proxy, firewall ou filtros de rede
• após substituir arquivos, recomenda-se purgar o cache do phpBB
• em ambientes mais restritivos, o modo de compatibilidade pode ser a melhor escolha

Conclusão

A extensão evoluiu de uma integração funcional para uma solução bem mais madura, com melhor organização interna, menos fragilidade estrutural e experiência de uso mais refinada.

[Chico Gois]

Topic Translate Single — Versão 1.6.3

Esta atualização traz melhorias importantes de segurança, desempenho, compatibilidade e organização do ACP, além de permitir definir o idioma original individualmente para cada fórum ou subfórum.

Novidades da versão 1.6.3

• Idioma original por fórum: agora é possível definir um idioma de origem diferente para cada fórum ou subfórum.
• Fóruns sem configuração específica continuam utilizando o idioma global.
• Quando uma seção usa outro idioma de origem, o idioma global é incluído automaticamente como destino da tradução.
• Exemplo: fórum global em português e seção em inglês permitem traduzir os tópicos dessa seção para português.
• Configurações inválidas ou idiomas removidos retornam automaticamente ao idioma global.
• O mapa de idiomas utiliza o armazenamento de texto longo do phpBB, evitando truncamento em fóruns com muitas seções.

ACP mais compacto

• Idiomas de destino organizados em um menu recolhível com múltipla escolha.
• Fóruns habilitados organizados em um menu recolhível com múltipla escolha.
• Novo painel pesquisável para definir o idioma original de cada fórum.
• Adicionados contadores dinâmicos de opções selecionadas.
• Adicionada pesquisa por nome de idioma e fórum.
• Botões para selecionar idiomas populares, todos ou nenhum.
• Ao abrir um painel, os demais são fechados automaticamente.
• Interface responsiva e adequada para instalações com muitos fóruns.

Compatibilidade com GTranslate

• Detecção de outro widget GTranslate já carregado na página.
• Detecção de alterações ou substituições em window.gtranslateSettings.
• A extensão não carrega um segundo widget quando encontra um conflito.
• Uma mensagem clara é exibida ao visitante quando a tradução individual não pode ser iniciada.
• A configuração existente do outro widget é preservada.

Tema claro e escuro

• Adicionada paleta escura completa para o popover, seletor, botões, mensagens e estados.
• Novo modo automático que analisa o fundo utilizado pelo estilo do fórum.
• A preferência de tema do navegador é utilizada quando a detecção do estilo não for conclusiva.
• O ACP permite escolher entre paleta automática, clara ou escura.

Segurança e privacidade

• O serviço externo pode ser carregado somente depois que o visitante clicar no botão de tradução.
• Removido JavaScript inline das páginas públicas, melhorando a compatibilidade com políticas CSP.
• Adicionado aviso no ACP sobre o processamento de conteúdo por serviços externos.
• Corrigida a remoção de cookies em domínios como example.com.br.
• O domínio e o caminho de cookies configurados no phpBB agora são respeitados.
• Removida a limpeza genérica de elementos .skiptranslate, evitando interferências em outras extensões.

Desempenho e arquitetura

• O conteúdo original dos posts não é mais substituído no DOM.
• A tradução é renderizada em uma cópia isolada somente do post selecionado.
• Eventos, players, spoilers e estados do conteúdo original são preservados.
• Removida a clonagem antecipada de todos os posts do tópico.
• Implementado um único widget compartilhado por toda a página.
• Somente um post permanece traduzido por vez.
• Ao traduzir outro post, o anterior retorna automaticamente ao conteúdo original.
• Removida a execução duplicada do listener no cabeçalho e rodapé.
• Os códigos JavaScript dos temas claro e escuro foram unificados.

Correções

• Corrigida a tradução automática baseada no idioma do navegador.
• A inicialização agora utiliza o evento real de visualização de tópico do phpBB.
• Corrigida a identificação do fórum em URLs que possuem somente o parâmetro do tópico.
• Melhorada a compatibilidade com extensões que utilizam URLs amigáveis ou reescritas.
• As restrições por fórum não podem mais ser ignoradas quando o parâmetro f não estiver presente.
• Rotas genéricas em app.php não são mais identificadas incorretamente como tópicos.
• O contêiner de proteção contra tradução é inserido somente quando a extensão está ativa no fórum atual.
• Corrigidas chaves ausentes na tradução francesa.
• Restaurado o botão para exibir novamente o conteúdo original no prosilver.

Experiência do usuário

• Idioma original separado dos idiomas oferecidos como destino.
• Seleção dos fóruns pelo nome, sem necessidade de informar IDs manualmente.
• Modos de inclusão e exclusão de fóruns.
• Opção para lembrar o último idioma escolhido.
• Melhorias de navegação por teclado, foco e leitores de tela.
• Melhorias para dispositivos móveis e páginas RTL.
• Blocos de código e outros conteúdos técnicos permanecem fora da tradução.

Idiomas disponíveis na extensão

• Português do Brasil
• Inglês
• Francês

Atualização

Para atualizar uma instalação existente:

1. Desative a extensão no ACP sem excluir seus dados.
2. Substitua os arquivos antigos pelos arquivos da versão 1.6.3.
3. Ative novamente a extensão.
4. Limpe o cache do phpBB.
5. Acesse as configurações da extensão e defina o idioma original das seções que não utilizam o idioma global.

As configurações existentes serão preservadas. Inicialmente, todos os fóruns continuarão utilizando o idioma global até que um idioma específico seja selecionado.

[Chico Gois]

Topic Translate Single 1.6.4

Compatibilidade com Brave e bloqueadores

• Corrigido o problema que impedia a exibição do menu de idiomas no navegador Brave.
• O seletor de idiomas agora é gerado localmente pela extensão e aparece imediatamente, mesmo quando um recurso externo é bloqueado.
• Removida a dependência do arquivo widgets/latest/dwf.js para construir o menu de idiomas.
• Corrigida a incompatibilidade com a marcação atual do widget GTranslate, que deixou de utilizar o elemento select esperado pela extensão.
• O carregamento agora utiliza primeiro o endpoint do Google Translate reconhecido pelo mecanismo de tradução do Brave.
• Adicionada uma segunda origem oficial como alternativa caso o primeiro endpoint não esteja disponível.

Interface e experiência do usuário

• O menu permanece visível quando o serviço externo é bloqueado, permitindo que o visitante veja uma mensagem de erro clara.
• O idioma original do fórum ou da seção é exibido diretamente no seletor.
• Mantido o suporte aos idiomas de destino configurados no ACP.
• Mantido o suporte aos nomes nativos dos idiomas.
• Mantidas a detecção do idioma do navegador e a opção de repetir o último idioma utilizado.
• Preservadas as paletas automática, clara e escura.

Confiabilidade

• Adicionado cancelamento seguro de traduções ainda em carregamento.
• O post original é restaurado automaticamente quando o serviço de tradução não pode ser carregado.
• Uma tradução com falha não deixa mais o post oculto ou preso em estado de carregamento.
• Mantida a tradução isolada somente do post selecionado.
• Mantida a proteção contra conflitos com outros widgets GTranslate ou Google Translate presentes na mesma página.
• Mantidas as configurações de idioma original específico por fórum e subfórum.

Documentação e distribuição

• Atualizadas as instruções de compatibilidade com políticas CSP e bloqueadores de conteúdo.
• Atualizadas as mensagens de erro em português do Brasil, inglês e francês.
• Atualizados o README e o changelog da extensão.
• Versão atualizada para 1.6.4.

Importante: depois de substituir os arquivos da extensão, limpe o cache do phpBB e o cache do navegador para garantir o carregamento do novo JavaScript.