O plugin Multilingual Tools é um plugin de testes que você pode usar ao registrar widgets personalizados do Elementor para tradução. O plugin inclui um WPML – Config Generator for Elementor que gera automaticamente a primeira versão do código XML para esses widgets personalizados.
Usando esta ferramenta, você poderá obter as informações de que precisa para registrar seu widget.
Este guia é para desenvolvedores que criam temas e plugins para Elementor e querem torná-los compatíveis com o WPML. Se você não é um desenvolvedor, confira nosso guia sobre como traduzir um site Elementor com o WPML.
Primeiros passos
Para começar:
- Baixe o plugin Multilingual Tools da página da OnTheGoSystems no GitHub.
- Certifique-se de ter o plugin núcleo WPML Multilingual CMS e o complemento WPML Tradução de Strings instalados e ativados no seu site.
- Certifique-se de que você já tenha algum conteúdo criado com o Elementor no seu site.
Por que usar o plugin Multilingual Tools
No WPML 4.9 e em versões mais recentes, o WPML reconhece automaticamente os widgets personalizados do Elementor e os torna traduzíveis. No entanto, ele pode registrar strings que você não quer que sejam traduzidas.
É por isso que recomendamos usar o Multilingual Tools para registrar seu widget personalizado do Elementor para tradução. Isso dá a você um controle preciso sobre quais campos são traduzíveis.
Como funciona
Quando você cria uma página usando o construtor de páginas do Elementor, todo o conteúdo é salvo no campo personalizado _elementor_data.
Assim que você adiciona os widgets personalizados que quer registrar para tradução a uma página, o WPML – Config Generator for Elementor acessa esse campo _elementor_data para ler o seu conteúdo. Após a leitura, ele converte os dados em código XML que corresponde aos widgets personalizados que você usou na sua página.
Geração de código XML com o WPML — Config Generator
Para gerar automaticamente o código XML para os seus widgets personalizados:
- Crie uma nova página e clique em Editar com Elementor.
- Adicione os widgets personalizados que você quer registrar para tradução à página.
Importante: ao adicionar seu widget para torná-lo traduzível, certifique-se de preencher todos os campos e ativar todas as opções disponíveis.
Isso ocorre porque o WPML – Config Generator for Elementor não gera código XML para nenhum campo ou opção não configurados.
- Publique a página e volte para a tela de edição do WordPress para essa página. Role para baixo até a seção chamada WPML: Elementor Widgets. Você verá o código XML gerado para os campos e configurações do widget que ainda não estão registrados para tradução.
Teste do código XML gerado automaticamente
Antes de disponibilizar o código para os usuários finais, certifique-se de revisá-lo e testá-lo completamente. O WPML – Config Generator for Elementor é apenas um ponto de partida.
Para testar o código XML gerado automaticamente:
- Copie o código XML da seção chamada WPML: Elementor Widgets na tela de edição do WordPress da sua página com os widgets personalizados.
- Vá para WPML → Configurações e clique na aba Configuração XML personalizada.
- Cole o código no editor e pressione o botão Salvar. Verifique se você não vê nenhum aviso ou erro de validação. Certifique-se de remover quaisquer campos que não devam ser traduzidos ou modificados pelos usuários, como campos de configuração e campos com valores booleanos. Deixar esses campos disponíveis para tradução pode causar problemas e erros para os usuários finais.
- Volte para a tela de edição da página com os widgets personalizados. Faça uma pequena alteração na página, como editar o título da página, e clique em Atualizar.
- Na caixa Idioma, clique no ícone de mais para traduzir a página. O Editor de tradução avançado é aberto e você deve ver os campos registrados do widget personalizado disponíveis para tradução. Revise as traduções automáticas ou insira as suas próprias e clique em Completo quando terminar.
- Dê uma olhada na página traduzida no front-end para se certificar de que os campos do widget personalizado aparecem corretamente.
Uso de recursos adicionais de inspeção
Além de gerar automaticamente o código XML para os seus widgets personalizados do Elementor, o WPML – Config Generator for Elementor fornece informações adicionais de depuração.
Essas informações permitem que você inspecione e entenda os dados subjacentes e como eles estão sendo usados. Isso pode ser útil em casos específicos, como quando o código XML não funciona como esperado.
WPML Config XML (gerado para todos os widgets na página)
O que faz: fornece o código XML para todos os widgets na página, incluindo aqueles já registrados para tradução.
Por que é útil: permite que você revise ou edite o código XML das configurações de widgets existentes.
Valor RAW de _elementor_data (JSON)
O que faz: mostra o valor original do campo _elementor_data do post.
Por que é útil: permite que você veja os dados que o WPML – Config Generator for Elementor Widgets usa para gerar o código XML.
Array gerado a partir de _elementor_data
O que faz: fornece o valor do campo _elementor_data do post, convertido em um array.
Por que é útil: você pode usar o array para fins de depuração.
Widgets extraídos de _elementor_data
O que faz: mostra quais widgets personalizados o plugin conseguiu extrair e usar do campo _elementor_data.
Por que é útil: se você não vir um widget personalizado, campo de widget personalizado ou opção de widget personalizado aqui, ele não será adicionado ao XML. Isso é útil para depuração.