DF Translate: guia completo
Instalar, configurar e usar o DF Translate: idiomas, motor de tradução por IA com a sua própria chave, tradução dos conteúdos e das cadeias, SEO multilingue (hreflang, slugs), editor lado a lado, migração do Polylang e WooCommerce.
O DF Translate torna o seu site WordPress e a sua loja WooCommerce verdadeiramente multilingues. Cada tradução é um conteúdo real na base de dados (à maneira do Polylang ou do WPML), e não uma camada de texto reescrita em tempo real: é isso que garante um SEO impecável e uma compatibilidade total com o seu tema, o seu construtor de páginas e as suas extensões. A tradução automática é opcional e assenta na sua própria chave de API. Este guia cobre a instalação, a configuração dos idiomas e do motor de IA, a tradução dos conteúdos e das cadeias, o SEO multilingue, o editor lado a lado, a migração a partir do Polylang, o WooCommerce e a resolução de problemas.
Instalação
- Descarregue o arquivo
dftranslate.zipa partir da sua conta DataFirefly. - Back-office do WordPress → Plugins → Adicionar → Carregar plugin → envie o ZIP e depois Ativar.
- Na ativação, a extensão cria as suas tabelas (grupos de tradução, cadeias, traduções de cadeias) e acrescenta o menu DF Translate.
Compatível com WordPress 6.2 e superior, PHP 8.0 a 8.3 e multisite. Compatível com o WooCommerce (produtos simples, categorias, etiquetas) e com as extensões de SEO Yoast, Rank Math, AIOSEO e SEOPress. Sem dependências do Composer na implantação.
Primeiros passos em cinco minutos
- Abra DF Translate → Definições, separador Idiomas, e acrescente o seu segundo idioma a partir da lista de predefinições (a versão gratuita cobre 2 idiomas). Defina o idioma predefinido.
- Separador Tradução: escolha um motor de IA e introduza a sua chave de API (ou deixe vazio para traduzir tudo à mão). Clique em Testar a ligação.
- Abra um artigo ou um produto: na caixa Idioma e traduções, clique em ⚡ Criar e traduzir para o idioma de destino.
- Releia a tradução no editor lado a lado e publique-a.
- Acrescente o seletor de idioma ao seu site (bloco, widget, menu ou barra de administração) para que os seus visitantes possam mudar de idioma.
O DeepL oferece um patamar gratuito de API: é uma boa opção para começar sem custos. Para a melhor qualidade de escrita em fichas de produto, recomenda-se o Claude (Anthropic).
Configurar os idiomas
Tudo se passa em DF Translate → Definições → Idiomas.
Acrescentar um idioma
Use o menu pendente de predefinições (27 idiomas com código, locale, nome e bandeira pré-preenchidos) ou o botão Personalizado… para introduzir manualmente o código (por exemplo de), a locale (por exemplo de_DE) e o nome apresentado. A versão gratuita permite 2 idiomas; o DF Translate Pro torna-os ilimitados.
Idioma predefinido, ordem e remoção
O idioma predefinido é o dos seus conteúdos de origem (não tem prefixo de URL). Reordene os idiomas com as setas ▲▼ (a ordem reflete-se no seletor) e retire um com ✕. Retirar um idioma da configuração não destrói os conteúdos: ficam na base de dados e voltam a ser associados se acrescentar de novo o idioma.
Não pode remover o idioma predefinido: designe primeiro outro idioma como predefinido. Depois de alterar os idiomas ou os prefixos de URL, limpe a cache do seu site e, se for preciso, atualize os permalinks (Definições → Permalinks → Guardar).
Configurar o motor de tradução por IA
Em DF Translate → Definições → Tradução, escolha o motor e indique a sua chave.
- Claude (Anthropic): melhor qualidade de escrita, ideal para conteúdo de marketing e fichas de produto.
- DeepL: excelente relação qualidade/preço, com patamar gratuito disponível.
- OpenAI: motor generalista GPT.
- LibreTranslate: servidor autoalojado, para uma soberania total dos dados (indica o URL da sua instância).
O campo Tonalidade permite orientar o estilo (por exemplo «profissional», «caloroso»). As suas chaves são cifradas em repouso (libsodium, com recurso ao OpenSSL) e nunca são expostas do lado do visitante.
Sem subscrição por palavra e sem proxy: o seu conteúdo só sai do seu site para o fornecedor que configurar, e apenas quando desencadear uma tradução. Também pode não configurar motor nenhum e traduzir inteiramente à mão.
Traduzir um conteúdo
Cada artigo, página, produto, categoria ou etiqueta tem uma caixa Idioma e traduções no editor, e uma coluna Idioma nas listagens.
A partir do editor
A caixa mostra o idioma do conteúdo e o estado de cada tradução. Em cada idioma em falta, ⚡ Criar e traduzir cria a tradução e preenche-a com o motor de IA; sem motor configurado, + Criar cria um rascunho vazio. Um conteúdo traduzido por IA é marcado com ⚑ MT («a rever») até que um humano o edite.
A partir das listagens (matriz de traduções)
Na coluna Idioma, uma matriz mostra em cada linha: o seu próprio idioma (bandeira cheia), uma ligação ✎ para cada tradução existente (contorno tracejado se for rascunho, laranja se estiver desatualizada), e um botão ⚡ ou + para criar as que faltam. Os conteúdos sem idioma («órfãos») propõem uma atribuição rápida diretamente na célula.
Filtrar e editar em massa
Por cima das listagens, ligações de vista filtram por idioma com contadores, mais uma vista ⚑ A rever. O idioma também se define na Edição rápida e na Edição em massa (opção «— Sem alteração —» para não substituir as linhas que não estão em causa).
O editor lado a lado
A partir de uma tradução, o botão ⇆ Lado a lado (na caixa de tradução, nas ações de linha ou no editor) abre um ecrã que compara a origem e o destino: título, slug, excerto e metadados de SEO alinhados. Cada campo tem um botão ⧉ (copiar da origem) e ⚡ (traduzir este campo por IA). Um seletor de estado, a navegação entre os idiomas do grupo e um indicador de desatualização completam o ecrã. Atalho Ctrl/Cmd + S para guardar.
Quando altera um conteúdo de origem já traduzido, as suas traduções são assinaladas como «desatualizadas» (↻). Abra-as lado a lado para voltar a traduzir apenas os campos em causa.
Traduzir as cadeias (textos da interface)
Os textos que não são conteúdo editorial (título do site, slogan, títulos de widgets, designações do tema) são geridos em DF Translate → Cadeias. Introduza a tradução de cada cadeia por idioma, ou use a importação/exportação .po para confiar este trabalho a um tradutor ou reutilizar um catálogo existente.
SEO multilingue
- hreflang: as etiquetas
hreflang(comx-default) são acrescentadas automaticamente em cada página para indicar aos motores as versões linguísticas. - URL por idioma: cada idioma não predefinido leva prefixo (por exemplo
/pt/), para URL limpos e indexáveis. - Slugs traduzidos: o slug da tradução é regenerado a partir do título traduzido.
- Metadados de SEO: os títulos, as descrições e as palavras-chave do Yoast, do Rank Math, do AIOSEO e do SEOPress são traduzidos ao mesmo tempo que o conteúdo.
O seletor de idioma
Ofereça a mudança de idioma aos seus visitantes da forma que melhor se adequa ao seu tema:
- Bloco Gutenberg «Seletor de idioma» no editor de site ou de conteúdo.
- Widget clássico numa zona de widgets.
- Shortcode
[dft_switcher]em qualquer sítio. - Num menu: acrescente uma ligação personalizada com o URL
#dft_switcher, que se desdobra num elemento por idioma. - Barra de administração: está disponível um seletor para os utilizadores com sessão iniciada.
As bandeiras são SVG integrados, nítidas em todos os sistemas (incluindo no Windows, onde as bandeiras em emoji não são apresentadas).
Menus traduzidos
Em Definições → Menus, atribua um menu diferente por idioma a cada localização do tema, ou deixe vazio para reutilizar o menu predefinido. O botão ⚡ Gerar clona o menu predefinido, remapeando cada elemento para a sua tradução (as designações passam então a seguir os títulos traduzidos) e traduzindo as ligações personalizadas.
WooCommerce
O DF Translate traduz os produtos simples, as categorias e as etiquetas de produto como qualquer outro conteúdo. O stock e o preço mantêm-se sincronizados entre os idiomas de um mesmo produto, e o idioma do cliente é guardado na encomenda.
Os produtos variáveis, os e-mails de encomenda no idioma do cliente e as bases de URL traduzidas fazem parte do DF Translate Pro.
Migrar a partir do Polylang
Se já usa o Polylang, abra DF Translate → Definições e lance a migração num clique. Os seus idiomas, as atribuições de idioma dos seus conteúdos e os seus grupos de tradução são importados automaticamente. Os seus dados do Polylang não são alterados e os seus idiomas existentes são preservados (fusão, não substituição).
Faça uma cópia de segurança da base de dados antes de qualquer migração, por princípio. A migração foi concebida para não ser destrutiva, mas uma cópia de segurança continua a ser a boa prática.
Painel e verificações de saúde
O painel (DF Translate) mostra a cobertura de tradução por tipo de conteúdo e por idioma, os conteúdos a rever, e verificações de saúde: permalinks, conteúdos sem idioma, motor não configurado. Vários problemas (como os conteúdos órfãos) resolvem-se num clique.
Suporte REST / headless
Os campos dft_lang e dft_translations são expostos na API REST nos tipos de conteúdo traduzíveis. A filtragem por idioma faz-se explicitamente através de ?lang=; as respostas da API nunca são filtradas implicitamente por um cookie de idioma, o que evita corromper os resultados de um front-end headless.
Desinstalação
A simples desativação conserva todos os seus dados. Se assinalar a opção de eliminação dos dados nas definições, a remoção da extensão apaga as tabelas e as opções do DF Translate; os seus conteúdos WordPress e as suas encomendas nunca são tocados.
FAQ e resolução de problemas
O teste de ligação ao motor falha. Verifique a chave de API, a quota do lado do fornecedor, e que o seu servidor consegue alcançar a API em saída. No LibreTranslate, verifique o URL da instância.
Uma tradução continua marcada como «a rever» (⚑ MT). É normal depois de uma tradução automática: abra-a e grave uma alteração humana (editor, lado a lado ou importação) para levantar a marca.
O seletor de idioma não aparece no meu menu. Verifique que a ligação personalizada tem mesmo o URL exato #dft_switcher e volte a guardar o menu.
Havia bandeiras a aparecer como letras. O DF Translate usa bandeiras em SVG integradas precisamente para evitar este problema (as bandeiras em emoji não são desenhadas no Windows). Limpe a cache se persistir uma apresentação antiga.
Uma página traduzida devolve um erro 404. Atualize os permalinks (Definições → Permalinks → Guardar) depois de acrescentar um idioma ou de alterar os prefixos de URL.
Como passar a mais de 2 idiomas? O DF Translate Pro torna os idiomas ilimitados e acrescenta a tradução em massa, o piloto automático, a memória de tradução, o glossário, a exportação/importação XLIFF e os comandos WP-CLI.