WPML pode ler um arquivo de configuração que informa o que precisa ser traduzido em temas e plugins. O arquivo é chamado wpml-config.xml e é colocado na pasta raiz do plugin ou tema.
O objetivo do arquivo de configuração de idioma
Como parte de alcançar a compatibilidade com WPML, você também deve criar um arquivo de configuração que o ajudará a manter a compatibilidade em suas futuras versões. WPML pode traduzir qualquer coisa no seu site WordPress, mas você precisa informá-lo o que precisa ser traduzido. Esse arquivo faz isso.
Vá para a página WPML → Configurações.
Página de Configurações do WPML
Esta página informa ao WPML tudo o que ele precisa saber, incluindo quais campos personalizados traduzir ou sincronizar, quais postagens e taxonomias personalizadas devem ser multilíngues e até mesmo quais textos administrativos traduzir.
O arquivo de configuração de idioma inclui essas informações para que cada usuário não precise 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. Você pode ver uma lista aqui. Ele está configurado para substituir o arquivo de configuração de idioma local que está colocado dentro da pasta raiz do tema ou plugin.
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 aparece corretamente no Editor de Tradução Avançada do WPML, pode ser necessário configurar manualmente suas opções de tradução.
Para configurar opções de tradução para temas e plugins de terceiros, vá para WPML → Configurações e clique na aba Configuração XML Personalizada. Use o editor de texto nesta página para inserir o código como 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 plugin Multilingual Tools que torna essa tarefa mais fácil. Embora tenha sido inicialmente concebido como uma ferramenta para ajudar autores de temas e plugins a tornar seus produtos prontos para multilíngues, ele pode ser facilmente usado para gerar seu próprio arquivo wpml-config.xml.
Para saber mais sobre como gerar seu arquivo wpml-config.xml, visite a página do plugin Multilingual Tools. Especificamente, procure na seção Como faço para gerar arquivos de configuração de idioma usando o Multilingual Tools?
Uma vez que você tenha o arquivo de configuração, adicione-o à raiz da pasta do seu tema. Se você já tiver um, não o substitua. Em vez disso, edite seu arquivo XML original e adicione o código gerado com o plugin Multilingual Tools.
Observe que este plugin não é destinado a ser usado em sites ao vivo, de produção.
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 vários elementos usando o arquivo wpml-config.xml. Use os seguintes guias para encontrar informações adicionais e instruções sobre como tornar elementos específicos do site traduzíveis:
Usando o Arquivo de Configuração de Idioma do WPML com Temas Filhos
Se você estiver usando um tema filho, o arquivo de configuração de idioma do tema pai substitui o encontrado no tema filho. WPML fornece uma página de configuração que permite substituir isso facilmente com quaisquer configurações personalizadas.
Vamos considerar um exemplo onde o arquivo de configuração de idioma do tema pai está configurando o tipo de postagem personalizada “Propriedade” para ser traduzível.
O arquivo de configuração de idioma do tema pai está configurando o tipo de postagem personalizada de propriedade para traduzir
Se você estiver usando um tema filho e quiser definir o tipo de postagem personalizada “Propriedade” como não traduzível, navegue até a página WPML → Configurações e clique na aba Configuração XML Personalizada. Use o editor para definir o tipo de postagem personalizada “Propriedade” como não traduzível. Simplesmente, defina o valor do atributo translate como 0 em vez de 1.
Substituindo as configurações de configuração de idioma do tema pai
As configurações na aba Configuração XML Personalizada têm prioridade sobre as configurações no arquivo de configuração de idioma no tema pai.
