L’extension Multilingual Tools est une extension de test que vous pouvez utiliser lors de l'enregistrement de widgets Elementor personnalisés pour la traduction. L'extension inclut l'outil WPML – Config Generator for Elementor qui génère automatiquement la première version du code XML pour ces widgets personnalisés.
Grâce à cet outil, vous pourrez obtenir les informations nécessaires pour enregistrer votre widget.
Ce guide s'adresse aux développeurs qui créent des thèmes et des extensions Elementor et souhaitent les rendre compatibles avec WPML. Si vous n'êtes pas développeur, consultez plutôt notre guide sur la façon de traduire un site web Elementor avec WPML.
Premiers pas
Pour commencer :
- Téléchargez l’extension Multilingual Tools depuis la page GitHub d'OnTheGoSystems.
- Assurez-vous que l'extension noyau WPML Multilingual CMS et le module complémentaire WPML Traduction de chaînes sont installés et activés sur votre site.
- Assurez-vous que vous avez déjà du contenu créé avec Elementor sur votre site.
Pourquoi utiliser l’extension Multilingual Tools
Dans WPML 4.9 et versions ultérieures, WPML reconnaît automatiquement les widgets Elementor personnalisés et les rend traduisibles. Cependant, il se peut qu'il enregistre des chaînes que vous ne souhaitez pas traduire.
C'est pourquoi nous vous recommandons d'utiliser Multilingual Tools pour enregistrer votre widget Elementor personnalisé pour la traduction. Cela vous donne un contrôle précis sur les champs qui sont traduisibles.
Comment cela fonctionne
Lorsque vous créez une page à l'aide du constructeur de pages Elementor, tout le contenu est enregistré dans le champ personnalisé _elementor_data.
Une fois que vous ajoutez les widgets personnalisés que vous souhaitez enregistrer pour la traduction à une page, WPML – Config Generator for Elementor accède à ce champ _elementor_data pour en lire le contenu. Après lecture, il convertit les données en code XML qui correspond aux widgets personnalisés que vous avez utilisés sur votre page.
Générer du code XML avec le WPML — Config Generator
Pour générer automatiquement du code XML pour vos widgets personnalisés :
- Créez une nouvelle page et cliquez sur Modifier avec Elementor.
- Ajoutez à la page les widgets personnalisés que vous souhaitez enregistrer pour la traduction.
Important : lors de l'ajout de votre widget pour le rendre traduisible, assurez-vous de remplir tous les champs et d'activer toutes les options disponibles.
En effet, WPML – Config Generator for Elementor ne génère pas de code XML pour un champ ou une option non configurés.
- Publiez la page et retournez à l'écran d'édition WordPress de cette page. Faites défiler jusqu'à la section intitulée WPML: Elementor Widgets. Vous verrez le code XML généré pour les champs et les réglages du widget qui ne sont pas encore enregistrés pour la traduction.
Tester le code XML généré automatiquement
Avant de mettre le code à la disposition des utilisateurs finaux, assurez-vous de l'examiner et de le tester de manière approfondie. WPML – Config Generator for Elementor n'est qu'un point de départ.
Pour tester le code XML généré automatiquement :
- Copiez le code XML de la section intitulée WPML: Elementor Widgets sur l'écran d'édition WordPress de votre page contenant les widgets personnalisés.
- Accédez à WPML → Paramètres et cliquez sur l'onglet Configuration XML personnalisée.
- Collez le code dans l'éditeur et appuyez sur le bouton Enregistrer. Vérifiez que vous ne voyez aucun avertissement ou erreur de validation. Assurez-vous de supprimer les champs qui ne doivent pas être traduits ou modifiés par les utilisateurs, tels que les champs de configuration et les champs avec des valeurs booléennes. Laisser ces champs disponibles pour la traduction peut causer des problèmes et des erreurs pour les utilisateurs finaux.
- Retournez à l'écran d'édition de la page contenant les widgets personnalisés. Apportez une petite modification à la page, comme modifier le titre de la page, et cliquez sur Mettre à jour.
- Dans la boîte Langue, cliquez sur l'icône plus pour traduire la page. L'Éditeur de traduction avancé s'ouvre et vous devriez voir les champs enregistrés du widget personnalisé disponibles pour la traduction. Révisez les traductions automatiques ou saisissez les vôtres, puis cliquez sur Terminé lorsque vous avez terminé.
- Jetez un œil à la page traduite sur l'interface publique pour vous assurer que les champs du widget personnalisé s'affichent correctement.
Utiliser des fonctionnalités d'inspection supplémentaires
En plus de générer automatiquement le code XML pour vos widgets Elementor personnalisés, WPML – Config Generator for Elementor fournit des informations de débogage supplémentaires.
Ces informations vous permettent d'inspecter et de comprendre les données sous-jacentes et la façon dont elles sont utilisées. Elles peuvent être utiles dans des cas spécifiques, par exemple lorsque le code XML ne fonctionne pas comme prévu.
WPML Config XML (generated for all widgets in the page)
Ce qu'il fait : fournit le code XML pour tous les widgets de la page, y compris ceux déjà enregistrés pour la traduction.
Pourquoi c'est utile : vous permet de réviser ou de modifier le code XML des réglages de widgets existants.
RAW value from _elementor_data (JSON)
Ce qu'il fait : affiche la valeur d'origine du champ _elementor_data de l'article.
Pourquoi c'est utile : vous permet de voir les données que WPML – Config Generator for Elementor Widgets utilise pour générer le code XML.
Array generated from _elementor_data
Ce qu'il fait : fournit la valeur du champ _elementor_data de l'article, convertie en tableau.
Pourquoi c'est utile : vous pouvez utiliser le tableau à des fins de débogage.
Extracted Widgets from _elementor_data
Ce qu'il fait : indique quels widgets personnalisés l'extension a pu extraire et utiliser à partir du champ _elementor_data.
Pourquoi c'est utile : si vous ne voyez pas de widget personnalisé, de champ de widget personnalisé ou d'option de widget personnalisé ici, il ne sera pas ajouté au XML. Cela est utile pour le débogage.