Como Traduzir Um Tema Ou Plugin WordPress Manualmente

Guia completo para traduzir qualquer tema ou plugin WordPress manualmente sem depender de ferramentas automáticas

Traduzir um tema ou plugin WordPress manualmente é uma tarefa fundamental para quem deseja entregar uma experiência local completa, com textos e mensagens no idioma do público-alvo.
Embora existam plugins que automatizam parte do processo, como o Loco Translate ou o Poedit, o método manual oferece mais controle, precisão e compatibilidade, especialmente quando você precisa traduzir apenas partes específicas de uma interface ou personalizar o tom da tradução.

Neste guia, você vai aprender o processo completo para localizar, editar e carregar as traduções diretamente no seu site WordPress, preservando compatibilidade e segurança.

Entendendo o sistema de tradução do WordPress

O WordPress utiliza três tipos principais de arquivos para gerenciar traduções:

Esses arquivos estão localizados, normalmente, dentro das pastas:

• /wp-content/languages/

• /wp-content/themes/nome-do-tema/languages/

• /wp-content/plugins/nome-do-plugin/languages/

O idioma ativo no WordPress (definido em Configurações → Geral → Idioma do site) determina qual arquivo .mo será carregado.

Passo a passo para traduzir manualmente um tema ou plugin

1. Localizar o arquivo de idioma

Acesse a pasta do tema ou plugin e procure pela subpasta /languages/.
Lá, você encontrará um arquivo .pot (por exemplo, theme-name.pot ou plugin-name.pot).
Esse arquivo contém todas as strings de texto originais que podem ser traduzidas.

Se não houver um arquivo .pot, é possível extraí-lo manualmente com ferramentas como Poedit ou xgettext, mas na maioria dos casos ele já estará disponível.

2. Criar o arquivo de tradução (.po)

Abra o arquivo .pot com o Poedit, um editor gratuito e amplamente usado para traduções WordPress.

No Poedit:

1. Clique em Criar nova tradução.

2. Escolha o idioma (por exemplo, Português do Brasil – pt_BR).

3. O programa criará um novo arquivo no formato nomedoarquivo-pt_BR.po.

4. Para cada linha (string), insira a tradução correspondente no campo de texto.

Exemplo:

• Original: Read More

• Tradução: Leia Mais

Ao salvar, o Poedit automaticamente gera também o arquivo compilado .mo.

3. Nomear corretamente os arquivos

Os arquivos de tradução precisam seguir a convenção correta para serem reconhecidos:

• Tema: nomedotema-pt_BR.po e nomedotema-pt_BR.mo

• Plugin: nomedoplugin-pt_BR.po e nomedoplugin-pt_BR.mo

O sufixo pt_BR representa o idioma português do Brasil.
Outros exemplos:

• pt_PT → Português de Portugal

• es_ES → Espanhol (Espanha)

• en_US → Inglês (EUA)

4. Enviar os arquivos para o servidor

Após salvar os arquivos .po e .mo, envie-os para o local correto via FTP ou painel de hospedagem:

Para temas:

Para plugins:

Em alguns casos, é possível usar a pasta global do WordPress:

ou

Essa abordagem evita que as traduções sejam sobrescritas em futuras atualizações.

5. Ativar a tradução

No painel do WordPress, vá até Configurações → Geral → Idioma do site e selecione o idioma desejado.
Se já estiver configurado como Português do Brasil, basta limpar o cache e atualizar a página para ver as traduções aplicadas.

Se o tema ou plugin foi corretamente configurado para ser traduzível (usando funções como __() ou _e()), o conteúdo aparecerá traduzido automaticamente.

Corrigindo problemas de tradução

A tradução não aparece

• Confirme se o idioma do site está corretamente definido.

• Verifique o nome dos arquivos .po e .mo.

• Certifique-se de que os arquivos estão no diretório correto.

• Limpe o cache do WordPress e do navegador.

O tema/plugin não é traduzível

Alguns desenvolvedores não configuram corretamente as funções de internacionalização.
Para resolver, é possível editar os arquivos PHP e adicionar funções __() e _e() nas strings de texto, tornando-as reconhecíveis pelo sistema de tradução.

Dicas avançadas para manutenção e personalização

• Use Loco Translate para editar traduções diretamente no painel WordPress, mantendo controle manual.

• Armazene cópias das traduções em uma pasta fora do tema principal — isso evita sobrescrita em atualizações.

• Centralize traduções personalizadas em /wp-content/languages/ e configure via filtro load_textdomain_mofile.

• Revise traduções com frequência, pois temas e plugins são atualizados constantemente e podem adicionar novas strings.

Perguntas frequentes

1. Posso traduzir apenas partes específicas de um tema?
Sim. Basta localizar a string desejada no Poedit e traduzir apenas aquela linha.

2. É possível traduzir sem usar o Poedit?
Sim, com qualquer editor de texto, mas o Poedit simplifica e compila o arquivo .mo automaticamente.

3. Posso perder minhas traduções ao atualizar o tema?
Sim, se elas estiverem dentro da pasta do tema. Por isso, é recomendado usar a pasta global /wp-content/languages/.

4. O que fazer se o tema não tiver arquivo .pot?
Você pode gerar um novo arquivo .pot usando o Poedit, extraindo as strings diretamente dos arquivos do tema.

5. Há diferença entre tradução manual e automática?
Sim. A manual é mais precisa e profissional, especialmente para sites corporativos, institucionais e e-commerces.

Traduzir um tema ou plugin manualmente é um investimento em profissionalismo, usabilidade e SEO internacional.
Agende uma consultoria gratuita e aprenda como criar traduções consistentes e otimizadas no WordPress — elevando a experiência do seu público e o alcance global do seu site.