WPML

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:

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.

Página Overview do Multilingual Tools

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:

  1. Vá para WPML Localização de temas e plugins.
  2. Selecione seu tema ou plugin e analise em busca de textos.
Página Overview do Multilingual Tools
Página Overview do Multilingual Tools

3. Escolha os elementos para testar

Em seguida, selecione os elementos para os quais você quer testar a configuração:

  1. Vá para Multilingual Tools Configurações.
  2. Role para baixo até Add language information to post duplicate.
  3. Marque os elementos que você quer testar e salve.
Analisando textos no tema
Analisando textos no tema

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:

  1. Vá para WPML Painel de tradução.
  2. Selecione o conteúdo que você quer testar.
  3. 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.

Verificando a compatibilidade no front-end

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.

Mais nesta seção

Escrito por Amir · Última atualização em 10 de setembro de 2025