Este documento destina-se a desenvolvedores que desejam traduzir seus construtores de páginas baseados em shortcodes usando o WPML. Usamos o Visual Composer como exemplo, mas você pode usar a mesma técnica descrita abaixo para qualquer construtor de páginas que usa shortcodes.

Como obter o plugin WPML?

Primeiro, você precisa ter uma conta no WPML.org. Se ainda não tiver uma e for desenvolvedor de tema ou plugin, entre em contato com nosso programa Go Global e receba sua conta e auxílio sem custo.

Recebeu sua conta? Então, prossiga instalando o WPML, Translation Management e o String Translation.

Página de downloads do WPML

Página de downloads do WPML

* O suporte à tradução com construtores de páginas é novo na versão 3.6.0 do WPML. Se estiver usando uma versão mais antiga do WPML, atualize primeiro.

Como funciona?

Vamos criar uma página de exemplo usando o construtor de páginas. Usaremos o Visual Composer para este exemplo. Você pode usar o seu próprio construtor de páginas baseado em shortcodes.

Crie uma nova página do WordPress e desenvolva-a usando o construtor. Inclua elementos que contenham textos que precisarão ser traduzidos. A maioria dos construtores têm elementos de “texto”. Outros elementos incluem atributos de texto, como “title”.

Abaixo, há uma página de exemplo que criamos usando o Visual Composer. Ela usa uma célula de texto e outros tipos diferentes de células com atributos textuais.

Exemplo na interface de uma página criada com seu construtor de páginas

Exemplo na interface de uma página criada com seu construtor de páginas

Ao observarmos o código fonte da página (no modo HTML), podemos ver os shortcodes que compõem o design e os textos dela.

Exemplo do código HTML da página

Exemplo do código HTML da página

Nosso objetivo é configurar o WPML para encontrar esses textos no código fonte da página.

Criação de um arquivo de configuração de idioma para seu construtor de páginas

Felizmente, o WPML pode extrair os textos para tradução das páginas que você cria com construtores de páginas (que usam shortcodes). Só precisamos configurar o WPML para identificar quais shortcodes e atributos contêm textos que exigem tradução. Fazemos isso usando um arquivo com o nome wpml-config.xml, que precisa ser colocado na pasta raiz de seu tema ou plugin.

Criação do arquivo de configuração de idioma para o construtor de páginas

Criação do arquivo de configuração de idioma para o construtor de páginas

Esse arquivo de configuração de idioma também pode ser usado para guiar o WPML em outros aspectos de seu tema ou plugin.

Como exemplo, veja o arquivo de configuração de idioma para o Visual Composer que criamos:

<wpml-config>
    <shortcodes>
        <shortcode>
            <tag>vc_column_text</tag>
        </shortcode>
        <shortcode>
            <tag>vc_text_separator</tag>
            <attributes>
                <attribute>title</attribute>
            </attributes>
        </shortcode>
        …
</wpml-config>

Há uma entrada para todo shortcode que você deseja que o WPML identifique. Dentro delas há uma entrada para atributos que contenham texto.

No exemplo acima, o WPML extrai textos de shortcodes como:

[vc_column_text]Texto para traduzir[/vc_column_text]

[vc_text_separator title="texto para traduzir"]

Você sabe quais os shortcodes que seu construtor usa e quais atributos têm textos que precisam ser traduzidos. Crie o arquivo XML que corresponda a esses shortcodes e seus atributos. Quando o arquivo XML estiver pronto, salve-o na pasta raiz de seu tema ou plugin. O nome desse arquivo precisa ser wpml-config.xml.

Após criar ou atualizar o arquivo wpml-config.xml para o tema ou plugin, é preciso forçar o WPML a carregá-lo. Desative o tema/plugin e ative-o. O WPML carrega os arquivos de configuração quando os temas e plugins são ativados ou atualizados.

Tradução de páginas criadas com construtores de páginas

Após ter criado o arquivo wpml-config.xml, você deve testar a tradução de conteúdos criados com seu construtor de páginas.

Assista ao vídeo abaixo para ter uma visão geral do processo de tradução com o exemplo do Visual Composer.

 

Primeiro, é preciso configurar o WPML para usar o Translation Editor (que oferece suporte a construtores de páginas). Após ter instalado os plugins necessários (WPML, Translation Management, String Translation) e devidamente configurado o WPML, acesse WPML -> Translation Management -> Configuração de Conteúdo Multilíngue. Lá, selecione a opção “Utilizar o editor de tradução” na seção Como traduzir posts e páginas e clique em Salvar.

Seleção da opção de usar o editor de traduções

Seleção da opção de usar o editor de traduções

Agora está tudo pronto para você traduzir.

  1. Crie uma página do WordPress e desenvolva-a com seu construtor. Salve a página.
  2. Ao editá-la, clique no ícone + na caixa de idiomas (isso criará uma nova tradução).

Tradução da página de exemplo

Início da tradução da página de exemplo

  1. Agora, aparecerá a tela do editor de tradução. Você deve ver campos para cada um dos textos na página que criou. Sempre haverá um campo de título e deve haver campos para cada um dos elementos de texto no design do construtor de página.
  2. Adicione seus textos traduzidos aos campos e marque a opção Tradução concluída.
  3. Clique no botão Salvar e fechar.

Tradução dos textos da página

Tradução dos textos da página

No editor de página, o ícone + deve mudar para um ícone de lápis, indicando que a tradução está concluída (e agora você pode editá-la).

É possível ver a página traduzida acessando-a na interface e trocando de idioma.

Exemplo da página traduzida na interface

Exemplo da página traduzida na interface

Vamos editar a página para ver como a tradução funciona. Na barra de administração, clique em “Editar página”. Daí, abra o modo HTML para ver o código fonte da página.

Exemplo do código HTML da página traduzida

Exemplo do código HTML da página traduzida

Distribuição do seu construtor de páginas com compatibilidade com o WPML

Se seu construtor de páginas usa shortcodes, a única coisa que precisa fazer é adicionar o arquivo wpml-config.xml. Esse arquivo não interfere em nada se o WPML não estiver ativo. Ele orienta o WPML sobre como traduzir as páginas criadas com seu construtor.

Precisa de ajuda?

Fique à vontade para pedir ajuda à equipe de compatibilidade do WPML (use o contato que recebeu do programa Go Global). Se preferir, também pode usar nosso fórum de suporte geral.

Estamos trabalhando para proporcionar compatibilidade com construtores de páginas que não usam shortcodes. Entre em contato conosco para mais detalhes e disponibilidade de versões em desenvolvimento.