O WPML pode ler um arquivo de configuração que informa o que precisa de tradução em temas e plugins. O arquivo se chama wpml-config.xml e é colocado na pasta raiz do plugin ou tema.
O propósito do arquivo de configuração de idioma
Como parte de alcançar a 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. O WPML pode traduzir qualquer coisa no seu site WordPress, mas você precisa informar a ele o que precisa de tradução. Este arquivo faz isso.
Vá para a página WPML→ Configurações.
Esta página informa ao WPML tudo o que ele precisa saber, incluindo quais campos personalizados traduzir ou sincronizar, quais tipos de post personalizados e taxonomias devem ser multilíngues e até mesmo quais textos de administração 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 plugins, nós hospedamos os arquivos de configuração de idioma em nossos servidores. Você pode ver uma lista aqui. Ele é configurado para substituir o arquivo de configuração de idioma local que é colocado dentro da pasta raiz do tema ou plugin.
O WPML também permite que você substitua manualmente quaisquer configurações carregadas pelos arquivos de configuração de idioma de temas e plugins. Isso se aplica a ambos, os arquivos de configuração de idioma dentro da pasta raiz do tema ou plugin e os arquivos de configuração de idioma hospedados em nossos servidores.
Como definir opções de tradução para temas e plugins de terceiros
O 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çado do WPML, pode ser necessário configurar as opções de tradução deles manualmente.
Para configurar as 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 exatamente como você faria se estivesse criando um arquivo wpml-config.xml.
Como gerar o arquivo wpml-config.xml automaticamente
Se você não está familiarizado com a criação de arquivos XML, nossa equipe criou o plugin Multilingual Tools que facilita essa tarefa. Embora tenha sido concebido inicialmente como uma ferramenta para ajudar os autores de temas e plugins a tornarem seus produtos Multilingual Ready (prontos para sites 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 a seção Como gerar arquivos de configuração de idioma usando o Multilingual Tools?.
Assim que você tiver 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 se destina a ser usado em sites de produção ativos.
Para ler este tutorial e criar arquivos de configuração de idioma para seus temas e plugins, você pode começar com este de exemplo – wpml-config.zip.
Você precisará editá-lo, mas pode usar as seções e a estrutura deste arquivo.
Estrutura e sintaxe
O 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:
- Traduza shortcodes personalizados com o WPML
- Registre o conteúdo do construtor de páginas para tradução
- Registre widgets personalizados de construtores de páginas para tradução
- Defina opções de tradução para campos personalizados usando o arquivo de configuração do WPML
- Registre termos, tipos e taxonomias personalizados como traduzíveis
- Torne blocos personalizados do Gutenberg traduzíveis
- Traduza textos que temas e plugins salvam em wp_options
- Personalize o seletor de idiomas do WPML usando o arquivo de configuração do WPML
- Ative valores numéricos para tradução
Como usar 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. O WPML fornece uma página de configuração que permite que você substitua isso facilmente por quaisquer configurações personalizadas.
Vamos considerar um exemplo onde o arquivo de configuração de idioma do tema pai está definindo o tipo de post personalizado “Property” como traduzível.
Se você estiver usando um tema filho e quiser definir o tipo de post personalizado “Property” 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 post personalizado “Property” como não traduzível. Simplesmente, defina o valor do atributo translate como 0 em vez de 1.
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.
