Manter a compatibilidade do Avia Layout Builder (Enfold) com o WPML

A compatibilidade do Avia Layout Builder com o WPML é garantida através do arquivo de configuração de idioma. Aprenda como usar este arquivo para manter a compatibilidade.

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

Como a integração do Avia Layout Builder funciona com o WPML

Para entender como o Avia Layout Builder funciona com o WPML, vamos começar criando uma página simples usando o Avia Layout Builder. Incluiremos alguns módulos, como um Text Block, um Icon Box e um Button.

Esses módulos envolvem o conteúdo em shortcodes:

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

Isso abre a página no Editor de tradução avançado, onde você pode traduzir sua página. Adicione suas traduções e clique em Completo.

Agora, quando visualizamos a página traduzida no front-end, podemos ver o conteúdo traduzido.

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.

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

Para extrair strings de páginas criadas usando o Avia Layout Builder 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 Enfold, 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 Enfold, 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

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

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

<wp-config>
   <shortcodes>
      <shortcode>
         <tag>av_button</tag>
         <attributes>
            <attribute>label</attribute>
            <attribute type="link" encoding="av_link">link</attribute>
         </attributes>
      </shortcode>
   </shortcodes>
</wp-config>

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

• Todos os shortcodes são envolvidos pela tag principal shortcodes (plural).
• A tag shortcode (singular) envolve todas as tags pertencentes a um único shortcode.
• A tag tag define o nome do shortcode, que neste caso é av_button.
• 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 os atributos label e link.

Para shortcodes que incluem atributos de link, você pode fazer com que links internos apontem automaticamente para a versão traduzida daquele post usando a opção de tipo “link” para o atributo, como mostrado no exemplo anterior.

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 Enfold e o WPML ativados. Ative os complementos Tradução de Strings e Tradução de mídia.
2. Você precisa 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 clique em Salvar.

3. Crie uma nova página e adicione o(s) novo(s) módulo(s) a ela. Se você atualizou alguns atributos de módulos existentes, adicione-os à página também. Neste exemplo, vamos supor que o módulo Button foi recém-adicionado ao Avia Layout Builder. Adicione-o à página e clique em Publicar.

4. Clique no ícone de mais para traduzir a página. Isso leva você à tela do Editor de tradução avançado.
5. Certifique-se de que o texto do módulo seja exibido no Editor de tradução avançado.
6. Adicione suas traduções, depois clique em Completo para salvar e aplicar as traduções.

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

A página traduzida mostra todas as strings traduzidas, indicando que o arquivo de configuração de idioma atualizado está funcionando corretamente. Se você estiver encontrando algum problema, por favor, entre em contato com nossa equipe de desenvolvimento de compatibilidade. Eles ficarão felizes em verificar problemas relacionados ao arquivo de configuração de idioma.

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