Configure a compatibilidade do WPML com temas e plugins do WordPress – Configurações e wpml-config.xml personalizado

Esta página existe para o restante: temas e plugins menos populares, versões muito recentes em que o autor lançou antes que a compatibilidade do WPML fosse atualizada, e um pequeno número de ajudantes genéricos para sites que apresentam sintomas específicos. A maioria dos clientes nunca acessa esta página. Quando você o faz, geralmente é porque o Suporte do WPML indicou uma opção específica ou um wpml-config.xml para colar.

Duas subpáginas de Configurações cobrem a compatibilidade, e esta página abrange ambas. Configurações > Compatibilidade contém as opções para sintomas comuns. Configurações > Configuração XML personalizada é onde você escreve o seu próprio wpml-config.xml – descrito na segunda metade desta página. A interface para os padrões mais comuns (preferências de tradução por tipo de post, por taxonomia e por campo) fica em uma página de Configurações separada, coberta em O que é traduzido – e o que não é; a maioria dos clientes usa essa interface e só vem aqui quando ela não atende ao que eles precisam.

Opções de compatibilidade

Abra WPML > Configurações > Compatibilidade. A página tem quatro cartões. Cada cartão é voltado para uma classe específica de problema de compatibilidade.

Opções de localização – para temas e plugins cujas traduções não carregam

Quando um tema ou plugin já inclui suas próprias traduções de interface (arquivos .mo em uma pasta /languages/), mas essas traduções não aparecem no seu site, o cartão Opções de localização tem três opções que ajudam o WPML a encontrá-las e aplicá-las.

• Carregar automaticamente o arquivo .mo do tema usando load_textdomain. Força o WPML a chamar load_textdomain() para o domínio de texto do tema. Use quando as traduções do tema estão no disco, mas não aparecem.
• Inserir textdomain. Substitui o domínio de texto detectado automaticamente. Alguns temas registram seu domínio de texto de maneiras não padronizadas; este campo permite que você o especifique explicitamente.
• Usar domínios de texto do tema ou plugin quando as chamadas gettext não usam uma string literal. Um sinalizador de compatibilidade para temas/plugins que usam chamadas __() com argumentos variáveis em vez de strings literais. O WPML não consegue detectá-las automaticamente, e essa opção ajuda a aplicar as traduções mesmo assim.

Se o Suporte do WPML direcionar você para cá, eles dirão qual opção e qual domínio de texto configurar.

Fazer com que os temas funcionem de forma multilíngue

Ajustar IDs para funcionalidade multilíngue. Uma camada de compatibilidade para temas que codificam rigidamente suposições de idioma único (por exemplo, um tema que armazena um “ID de imagem destacada” uma vez e usa a mesma imagem em todos os idiomas).

A maioria dos temas modernos compatíveis com WPML não precisa disso. Temas mais antigos ou com menos suporte ao WPML às vezes precisam. Ative essa opção se você vir referências de conteúdo (imagens, menus, itens em destaque) vazando incorretamente entre os idiomas.

Filtragem de idioma para operações AJAX

Armazenar um cookie de idioma para suportar a filtragem de idiomas para AJAX. Alguns plugins usam AJAX para buscar conteúdo: listagens de produtos filtradas, listas de posts paginadas por AJAX, resultados de pesquisa conforme você digita. Sem um cookie de idioma, o endpoint AJAX não sabe em qual idioma responder e retorna resultados no idioma errado.

Ative o cookie se você vir este sintoma: os visitantes na página em francês recebem resultados em inglês de seções carregadas por AJAX. É uma correção de uma única caixa de seleção para toda uma classe de bugs.

Páginas de login e registro

Permitir a tradução das páginas de login e registro. O /wp-login.php integrado do WordPress e a tela de registro não fazem parte do conteúdo regular que o WPML traduz. Eles ficam fora da cadeia de templates do tema. Essa opção os adiciona ao conjunto de páginas traduzíveis do WPML.

Se o seu site roda em nginx, a opção também requer um ajuste na configuração do servidor. A página tem um link para o guia de nginx do WPML com o bloco de configuração exato.

Textos de temas e plugins – configurações aqui, analisador em outro lugar

Dois tipos de trabalho com strings de temas/plugins se dividem em duas telas:

• As configurações nesta página. Elas lidam com a compatibilidade para traduções que o tema/plugin já inclui: load_textdomain, substituição de domínio de texto, gettext não literal.
• O analisador tem sua própria tela. Quando você precisar encontrar strings de temas e plugins que ainda não estão registradas para tradução, use a tela Tradução de textos de administração. Ela é acessada a partir da aba Strings em Traduções, na seção “não está vendo as strings que você está procurando?”.

Para o fluxo de trabalho completo de análise de strings, consulte Tradução de strings.

wpml-config.xml personalizado

Temas e plugins compatíveis com WPML incluem um arquivo wpml-config.xml que diz ao WPML exatamente quais dos seus campos, tipos de post, taxonomias, shortcodes e chaves meta devem ser traduzíveis. O WPML o lê na ativação. Para todos os principais e mais populares temas e plugins, isso significa que a tradução funciona corretamente sem configuração adicional. Você não precisa fazer nada.

Quando o wpml-config.xml que vem com um tema ou plugin não é suficiente para o seu site, você escreve o seu próprio. O WPML o aplica sobre o que o tema ou plugin fornece.

Quando você deve escrever o seu próprio wpml-config.xml

Três cenários.

• Um campo que você precisa traduzir não está no wpml-config.xml fornecido. O autor do tema ou plugin não declarou um campo personalizado como traduzível, mas você precisa que ele seja traduzido no seu site.
• Um campo tem o padrão errado. O wpml-config.xml fornecido marca algo como Copiar e você quer Traduzir, ou vice-versa.
• Você está construindo um tema ou plugin personalizado e quer declarar seu comportamento de tradução a partir da página de Configurações do WPML em vez de incluir um arquivo wpml-config.xml com o seu código.

Em todos os casos, o Suporte do WPML pode direcionar você para cá com o wpml-config.xml exato para colar. Na maioria das vezes, é uma ação orientada pelo Suporte e, ocasionalmente, pelo desenvolvedor.

Por que editar o wpml-config.xml no painel de administração do WPML em vez de no arquivo do tema

Você poderia editar o próprio wpml-config.xml do tema ou plugin diretamente. Mas essa alteração é perdida na próxima vez que o tema ou plugin for atualizado. O editor interno do WPML em WPML > Configurações > Configuração XML personalizada sobrepõe o seu wpml-config.xml ao que o tema ou plugin fornece e sobrevive às atualizações. É o lugar certo para ajustes específicos do site.

A estrutura de um wpml-config.xml

A página é um editor de XML. Cole um bloco <wpml-config>...</wpml-config>, salve, e o WPML aplica o seu wpml-config.xml.

Um wpml-config.xml mínimo declarando um shortcode como traduzível:

<wpml-config>
  <shortcodes>
    <shortcode>
      <tag>add_to_cart_link</tag>
    </shortcode>
  </shortcodes>
</wpml-config>

Os tipos de elementos que você normalmente declararia:

• <custom-fields>. Marca um campo personalizado como translate, copy, copy-once ou nothing.
• <custom-types>. Declara um tipo de post personalizado como traduzível.
• <taxonomies>. Declara uma taxonomia personalizada como traduzível.
• <shortcodes>. Lista os shortcodes cujo conteúdo o WPML deve traduzir.
• <custom-term-fields>. Para metadados de termo.

Cada elemento tem seus próprios atributos (por exemplo, action="translate" em um campo personalizado). Para a referência completa do wpml-config.xml (cada elemento, cada atributo, cada valor permitido), consulte as Informações para desenvolvedores do WPML.

Um fluxo de trabalho prático

Se o Suporte do WPML fornecer um bloco wpml-config.xml para colar:

1. Abra WPML > Configurações > Configuração XML personalizada.
2. Cole o XML deles dentro do bloco <wpml-config> existente (ou substitua o conteúdo se eles tiverem fornecido o bloco completo).
3. Salve.
4. O WPML aplica o seu wpml-config.xml imediatamente. Se ele declarar um novo tipo de post ou campo traduzível, a entrada aparecerá em Configurações > Tradução de tipos de post / Tradução de campos personalizados na mesma hora.

Se você estiver construindo um tema ou plugin personalizado e quiser enviar a configuração do WPML com o código, você colocaria o mesmo bloco <wpml-config> em um arquivo wpml-config.xml na raiz do seu tema ou plugin. O WPML o lê na ativação. O editor no painel de administração é para ajustes específicos do site; o arquivo empacotado é para os próprios padrões do tema/plugin.