Teste sua configuração e confirme se seu plugin e tema são compatíveis com o WPML.
Baixar plugin
O Multilingual Tools é um complemento gratuito para testar a compatibilidade do seu plugin e tema com o WPML.
Usando este complemento, você pode identificar quais textos e elementos estão configurados corretamente para tradução (e quais não estão), além de gerar um arquivo de configuração de idioma.
Primeiros passos
Para começar, instale e ative:
- WPML
- Multilingual Tools
- Plugins / temas que você quer testar
Lembre-se de que o Multilingual Tools é um plugin de teste, portanto, nunca o use em sites de produção ou de clientes.
Como usar o Multilingual Tools
Para começar, vá para Multilingual Tools → Overview para visualizar um resumo do seu arquivo de configuração de idioma atual.

Se você estiver satisfeito com sua configuração, siga os passos abaixo para testá-la. Caso contrário, gere um novo arquivo de configuração de idioma para atualizar suas configurações.
1. Verifique se os textos no código estão envolvidos em chamadas gettext
Para traduzir seu plugin ou tema, você precisa envolver todos os textos no código com chamadas gettext. Se você ainda não fez isso, ou quer verificar sua configuração, siga estas diretrizes de i18n do WordPress para obter instruções.
2. Analise seu plugin ou tema em busca de textos no código
Em seguida, use o WPML para analisar seu plugin ou tema em busca de textos no código:
- Vá para WPML → Localização de temas e plugins.
- Selecione seu tema ou plugin e analise em busca de textos.

3. Escolha os elementos para testar
Em seguida, selecione os elementos para os quais você quer testar a configuração:
- Vá para Multilingual Tools → Configurações.
- Role para baixo até Add language information to post duplicate.
- Marque os elementos que você quer testar e salve.

Para testar strings, abra o menu suspenso de strings na seção Auto generate strings translations, selecione as fontes das suas strings e clique em Generate strings translations.
4. Envie o conteúdo para tradução
Para evitar gastar tempo (ou dinheiro) traduzindo conteúdo de teste, o Multilingual Tools adiciona um prefixo de idioma aos textos. Para executar essa ação, duplique seu conteúdo usando o WPML e deixe o Multilingual Tools cuidar do resto:
- Vá para WPML → Painel de tradução.
- Selecione o conteúdo que você quer testar.
- Escolha Duplicar como o método de tradução e traduza.
5. Confirme a compatibilidade
Por fim, acesse o conteúdo que você acabou de traduzir no front-end e alterne os idiomas. Seus elementos serão compatíveis se os textos incluírem um prefixo de idioma. Se alguns textos não contiverem um prefixo, eles não são compatíveis e precisam de configuração adicional.

Torne os blocos personalizados do Elementor e Gutenberg traduzíveis
Se o seu plugin usa widgets do Elementor ou blocos do Gutenberg, o plugin Multilingual Tools facilita o processo de torná-los traduzíveis. O plugin gera a versão inicial do código XML que você precisa para registrar widgets e blocos, para que você não precise criá-lo do zero.
Veja como tornar os blocos personalizados do Gutenberg traduzíveis e como registrar widgets personalizados do Elementor.
Gere um arquivo de configuração de idioma
Para gerar um arquivo de configuração de idioma, vá para Multilingual Tools → Configuration File e defina suas preferências.
Visão geral das configurações
Tipo de post personalizado / Taxonomias personalizadas
- Não fazer nada – ignorar e não traduzir
- Traduzível – mostrar apenas itens traduzidos
- Traduzível – usar a tradução se disponível ou recorrer ao idioma padrão
Campos personalizados
- Não traduzir – ignorar e não traduzir
- Copiar – copiar o valor do idioma padrão e manter sincronizado (bom para números)
- Copiar uma vez – copiar o valor do idioma padrão apenas uma vez (bom para criar valores de campo diferentes por idioma)
- Traduzir – traduzir para outros idiomas
Textos de administração
Registre strings na tabela wp_options para tradução. Por exemplo, o título do site ou as configurações de widget costumam ser armazenados nesta tabela. Ao registrá-los no arquivo de configuração, você garante que os usuários possam traduzi-los.
Shortcodes
Registre textos ou atributos dentro de shortcodes para tradução.