Skip Navigation
Atualizado
Março 21, 2024

WPML pode ler um arquivo de configuração que informa o que precisa ser traduzido em temas e plugins. O arquivo chama-se wpml-config.xml e é colocado na pasta raiz do plug-in ou do tema.

Nesta página:

O objetivo do arquivo de configuração de idioma

Como parte da obtenção de compatibilidade com o WPML, você também deve criar um arquivo de configuração que o ajudará a manter a compatibilidade em suas versões futuras. WPML pode traduzir qualquer coisa em seu site WordPress, mas você precisa dizer a ele o que precisa ser traduzido. Este ficheiro faz isso.

Vá para a seção WPML → Página de configurações.

Página de configurações WPML

Essa página informa ao WPML tudo o que ele precisa saber, inclusive quais campos personalizados devem ser traduzidos ou sincronizados, quais posts personalizados e taxonomias devem ser multilíngues e até mesmo quais textos administrativos devem ser traduzidos.

O arquivo de configuração de idioma inclui essas informações para que todos os usuários não precisem inseri-las manualmente na página de administração.

Para alguns dos temas e plug-ins, estamos hospedando os arquivos de configuração de idioma em nossos servidores. Pode ver uma lista aqui. Ele é definido para substituir o arquivo de configuração do idioma local que é colocado dentro da pasta raiz do tema ou plug-in.

WPML também permite que você substitua manualmente quaisquer configurações carregadas pelos arquivos de configuração de idioma do tema e do plug-in. Isso se aplica tanto aos arquivos de configuração de idioma dentro da pasta raiz do tema ou plug-in quanto aos arquivos de configuração de idioma hospedados em nossos servidores.

Configuração de opções de tradução para temas e plug-ins de terceiros

WPML é compatível com muitos temas e plugins populares e, para eles, você não precisa criar um arquivo de configuração de idioma.

No entanto, se você estiver usando um tema ou plugin cujo conteúdo não apareça corretamente no Advanced Translation Editor do WPML, talvez seja necessário configurar as opções de tradução manualmente.

Para configurar opções de tradução para temas e plug-ins de terceiros, acesse WPMLConfigurações e clique na guia Configuração de XML personalizado. Use o editor de texto nesta página para inserir o código, como você faria se estivesse criando um arquivo wpml-config.xml.

Definir opções de tradução para temas e plug-ins de terceiros na guia Custom XML Configuration

Geração automática do arquivo wpml-config.xml

Se você não estiver familiarizado com a criação de arquivos XML, nossa equipe criou o plug-in Multilingual Tools que facilita essa tarefa. Embora tenha sido inicialmente concebido como uma ferramenta para ajudar os autores de temas e plug-ins a preparar seus produtos para vários idiomas, ele pode ser facilmente usado para gerar seu próprio arquivo wpml-config.xml .

Para saber mais sobre como gerar o arquivo wpml-config.xml, visite a página do plug-in Multilingual Tools. Especificamente, veja na secção Como gerar ficheiros de configuração linguística usando Ferramentas Multilingues?

Quando você tiver o arquivo de configuração, adicione-o à raiz da pasta do seu tema. Se já tiver um, não o sobreescreva. Em vez disso, edite o arquivo XML original e adicione o código gerado com o plug-in Multilingual Tools.

Observe que este plug-in não se destina a ser usado em sites de produção ao vivo.

Para ler este tutorial e criar arquivos de configuração de idioma para seus temas e plug-ins, você pode começar com este exemplo – wpml-config.zip .

Você precisará editá-lo, mas poderá usar as seções e a estrutura desse arquivo.

Estrutura e Sintaxe

WPML permite que você configure uma série de elementos usando o arquivo wpml-config.xml. Use os guias a seguir para encontrar informações e instruções adicionais sobre como tornar elementos específicos do site traduzíveis:

Usando o arquivo de configuração de idioma WPML com temas filhos

Se você estiver usando um tema filho, o arquivo de configuração de idioma do tema pai substituirá o arquivo encontrado no tema filho. WPML oferece uma página de configuração que permite que você substitua isso facilmente por quaisquer configurações personalizadas.

Vamos considerar um exemplo em que o arquivo de configuração de idioma do tema principal está definindo o tipo de post personalizado “Property” como traduzível.

O arquivo de configuração do idioma principal está definindo a propriedade custom post type para traduzir

Se você estiver usando um tema filho e quiser definir o tipo de post personalizado “Property” como não traduzível, navegue até a seção WPMLConfigurações e clique na guia Configuração de XML personalizado. Use o editor para definir o tipo de post personalizado “Property” como não traduzível. Simplesmente, defina o valor do atributo translate como 0 em vez de 1.

Substituir as definições de configuração de idioma do tema principal

As configurações na guia Custom XML Configuration são priorizadas em relação às configurações no arquivo de configuração de idioma no tema pai.