Assistente de Criação de Patch

[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.