Manter a compatibilidade do construtor de páginas WPBakery com o WPML

A compatibilidade do construtor de páginas WPBakery com o WPML é garantida por meio do arquivo de configuração de idioma. Aprenda a usar esse arquivo para manter a compatibilidade.

Esta página é destinada à equipe de desenvolvimento do WPBakery, a desenvolvedores que oferecem uma versão personalizada do construtor de páginas, a autores que desenvolvem complementos para o WPBakery e a desenvolvedores web que usam o construtor de páginas WPBakery.

Se você é um cliente que quer traduzir um site construído com o WPBakery, consulte nossa documentação detalhada para saber mais sobre como construir sites multilíngues com o construtor de páginas WPBakery e o WPML.

Como a integração do construtor de páginas WPBakery funciona com o WPML

Para entender como o construtor de páginas WPBakery funciona com o WPML, começaremos criando uma página simples usando o construtor de páginas WPBakery. Incluiremos alguns módulos, como um Text Block, uma Message Box e uma Hover Box.

Para traduzir a página que criamos, clique no ícone de mais encontrado na caixa meta Idioma na barra lateral direita.

Isso levará você à tela do Editor de tradução avançado, onde você pode traduzir a sua página. Preencha as traduções de cada frase e confirme-as clicando na marca de seleção verde. Quando você estiver satisfeito com todas as suas traduções, clique em Completo.

Atualizar o arquivo de configuração de idioma

Você pode precisar atualizar os shortcodes do construtor de páginas no arquivo de configuração de idioma por diferentes motivos:

1. Adicionar um novo shortcode ao construtor de páginas
2. Adicionar um novo atributo a um shortcode existente
3. Remover um shortcode obsoleto

Você pode baixar o arquivo de configuração de idioma do nosso repositório. Adicione os shortcodes ou atributos aos shortcodes existentes dentro do arquivo de configuração de idioma.

Para autores que estão incluindo uma versão personalizada do construtor de páginas WPBakery em seu tema, leve em consideração que você precisará atualizar o arquivo de configuração de idioma da versão personalizada do plugin.

Estrutura dos shortcodes do construtor de páginas no arquivo de configuração de idioma

Para extrair strings de páginas construídas usando o construtor de páginas WPBakery e carregá-las na tela do Editor de tradução, precisamos configurar o WPML para identificar os shortcodes e atributos que contêm as strings que exigem tradução. Isso é feito adicionando um arquivo, chamado wpml-config.xml, que normalmente é colocado na pasta raiz do seu tema. Para o construtor de páginas WPBakery, estamos hospedando o arquivo de configuração de idioma em nossos servidores. Ele é configurado para substituir o arquivo de configuração local colocado na pasta raiz do construtor de páginas WPBakery, garantindo que o arquivo de configuração esteja sempre atualizado.

O arquivo wpml-config.xml também é usado para configurar os seguintes elementos:

1. Campos personalizados
2. Taxonomias personalizadas
3. Textos de administração / wp_options
4. Configuração do seletor de idiomas
5. Shortcodes do construtor de páginas

Consulte nossa documentação detalhada para saber mais sobre a estrutura e a sintaxe do arquivo de configuração de idioma.

Como exemplo, vamos ver como adicionamos o shortcode Tabs ao arquivo wpml-config.xml.

<shortcode>
         <tag>vc_tta_tabs</tag>
         <attributes>
            <attribute encoding="allow_html_tags">title</attribute>
         </attributes>
</shortcode>

A estrutura do exemplo acima pode ser dividida da seguinte forma:

• Todos os shortcodes estão envolvidos pela tag principal shortcodes (plural).
• A tag shortcode envolve todas as tags pertencentes a um único shortcode.
• A tag tag define o nome do shortcode, que neste caso, é o vc_tta_tabs.
• Os shortcodes podem ter um ou mais atributos; portanto, nós os envolvemos na tag attributes (plural) e usamos a tag attribute (singular) para definir o título de cada atributo. Neste caso, temos o atributo title.

Para shortcodes que incluem atributos de link, você pode fazer com que os links internos apontem automaticamente para a versão traduzida desse post usando a opção type para o atributo. Aqui está um exemplo:

<shortcode>
         <tag>vc_button</tag>
         <attributes>
            <attribute encoding="allow_html_tags">title</attribute>
            <attribute encoding="vc_link" type="link">href</attribute>
         </attributes>
</shortcode>

Testar o arquivo de configuração de idioma

Para testar o arquivo de configuração de idioma atualizado, siga estes passos:

1. Configure uma instalação com o construtor de páginas WPBakery e o WPML ativados. Baixe e ative os complementos Tradução de Strings e Tradução de mídia.
2. Você precisará substituir o arquivo de configuração de idioma remoto pelo atualizado. Para fazer isso, vá para a página WPML → Configurações e clique na aba Configuração XML personalizada. Copie o conteúdo do seu arquivo de configuração de idioma atualizado para o editor e, em seguida, clique em Salvar.

3. Crie uma nova página e adicione o(s) novo(s) módulo(s) a ela. Caso você tenha atualizado alguns atributos para módulos existentes, adicione-os à página também. Neste exemplo, assumiremos que o módulo Call To Action foi recém-adicionado ao construtor de páginas WPBakery. Adicione-o à página e clique em Publicar.

4. Clique no ícone de mais para traduzir a página. Isso levará você à tela do Editor de tradução avançado.
5. Certifique-se de que os elementos textuais do módulo sejam exibidos no Editor de tradução avançado.
6. Preencha as suas traduções e confirme-as com a marca de seleção verde. Quando você terminar, clique no botão Completo.

7. Verifique a página traduzida no front-end.

A página traduzida mostra todas as strings traduzidas, o que significa que o arquivo de configuração de idioma atualizado está funcionando corretamente.

Observe que os estilos CSS para os elementos da página do idioma original são copiados para o idioma de tradução. Isso garante que tudo ficará correto entre os idiomas. Se você quiser desativar esse recurso, consulte este artigo para obter instruções.

Se você encontrar algum problema, entre em contato com a nossa equipe de desenvolvimento de compatibilidade. Eles ficarão felizes em verificar problemas relacionados ao arquivo de configuração de idioma.

Quando terminar os testes, envie um merge request para o nosso repositório. Nossos desenvolvedores de compatibilidade receberão a sua solicitação e a revisarão.

Observe que o arquivo de configuração de idioma hospedado em nosso repositório é para a versão padrão do construtor de páginas WPBakery. Caso você esteja atualizando o arquivo de configuração de idioma de uma versão personalizada do construtor de páginas WPBakery, aplique as alterações ao arquivo de configuração dentro da pasta raiz do seu plugin.