Maintenir la compatibilité de WPBakery Page Builder avec WPML

La compatibilité de WPBakery Page Builder avec WPML est assurée par le fichier de configuration de langue. Découvrez comment utiliser ce fichier pour maintenir la compatibilité.

Cette page est destinée à l'équipe de développement de WPBakery, aux développeurs qui proposent une version personnalisée du constructeur de pages, aux auteurs qui développent des modules complémentaires pour WPBakery et aux développeurs web utilisant WPBakery Page Builder.

Si vous êtes un client cherchant à traduire un site construit avec WPBakery, veuillez consulter notre documentation détaillée pour en savoir plus sur la création de sites multilingues avec WPBakery Page Builder et WPML.

Comment fonctionne l'intégration de WPBakery Page Builder avec WPML

Pour comprendre comment WPBakery Page Builder fonctionne avec WPML, nous allons commencer par créer une page simple à l'aide de WPBakery Page Builder. Nous inclurons quelques modules, tels qu'un Bloc de texte, une Boîte de message, et une Boîte de survol.

Pour traduire la page que nous avons créée, cliquez sur l'icône plus située dans la boîte méta Langue dans la barre latérale droite.

Cela vous amènera à l'écran de l'Éditeur de traduction avancé, où vous pourrez traduire votre page. Remplissez les traductions pour chaque phrase et confirmez-les en cliquant sur la coche verte. Une fois que vous êtes satisfait de toutes vos traductions, cliquez sur Terminé.

Mettre à jour le fichier de configuration de langue

Vous pourriez avoir besoin de mettre à jour les shortcodes du constructeur de pages dans le fichier de configuration de langue pour différentes raisons :

1. Ajout d'un nouveau shortcode au constructeur de pages
2. Ajout d'un nouvel attribut à un shortcode existant
3. Suppression d'un shortcode obsolète

Vous pouvez télécharger le fichier de configuration de langue depuis notre dépôt. Ajoutez les shortcodes ou les attributs aux shortcodes existants dans le fichier de configuration de langue.

Pour les auteurs qui intègrent une version personnalisée de WPBakery Page Builder dans leur thème, veuillez prendre en considération que vous devrez mettre à jour le fichier de configuration de langue de la version personnalisée de l'extension.

Structure des shortcodes du constructeur de pages dans le fichier de configuration de langue

Pour extraire les chaînes de texte des pages construites avec WPBakery Page Builder et les charger sur l'écran de l'Éditeur de traduction, nous devons configurer WPML pour identifier les shortcodes et les attributs contenant les chaînes de texte qui nécessitent une traduction. Cela se fait en ajoutant un fichier, appelé wpml-config.xml, qui est généralement placé dans le dossier racine de votre thème. Pour WPBakery Page Builder, nous hébergeons le fichier de configuration de langue sur nos serveurs. Il est défini pour remplacer le fichier de configuration local placé dans le dossier racine de WPBakery Page Builder, garantissant ainsi que le fichier de configuration est toujours à jour.

Le fichier wpml-config.xml est également utilisé pour configurer les éléments suivants :

1. Champs personnalisés
2. Taxonomies personnalisées
3. Textes d'administration / wp_options
4. Configuration du sélecteur de langue
5. Shortcodes du constructeur de pages

Consultez notre documentation détaillée pour en savoir plus sur la structure et la syntaxe du fichier de configuration de langue.

À titre d'exemple, voyons comment nous avons ajouté le shortcode des onglets (Tabs) au fichier wpml-config.xml.

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

La structure de l'exemple ci-dessus peut être décomposée comme suit :

• Tous les shortcodes sont enveloppés par la balise principale shortcodes (au pluriel).
• La balise shortcode enveloppe toutes les balises appartenant à un seul et unique shortcode.
• La balise tag définit le nom du shortcode, qui dans ce cas, est vc_tta_tabs.
• Les shortcodes peuvent avoir un ou plusieurs attributs ; par conséquent, nous les enveloppons dans la balise attributes (au pluriel) et utilisons la balise attribute (au singulier) pour définir le titre de chaque attribut. Dans ce cas, nous avons l'attribut title.

Pour les shortcodes qui incluent des attributs de lien, vous pouvez faire en sorte que les liens internes pointent automatiquement vers la version traduite de cet article en utilisant l'option de type pour l'attribut. Voici un exemple :

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

Tester le fichier de configuration de langue

Pour tester le fichier de configuration de langue mis à jour, suivez ces étapes :

1. Configurez une installation avec WPBakery Page Builder et WPML activés. Téléchargez et activez les modules complémentaires Traduction de chaînes et Traduction des médias.
2. Vous devrez remplacer le fichier de configuration de langue distant par le fichier mis à jour. Pour ce faire, accédez à la page WPML → Paramètres et cliquez sur l'onglet Configuration XML personnalisée. Copiez le contenu de votre fichier de configuration de langue mis à jour dans l'éditeur, puis cliquez sur Enregistrer.

3. Créez une nouvelle page et ajoutez-y le ou les nouveaux modules. Si vous avez mis à jour certains attributs pour des modules existants, ajoutez-les également à la page. Dans cet exemple, nous supposerons que le module Call To Action a été récemment ajouté à WPBakery Page Builder. Ajoutez-le à la page et cliquez sur Publier.

4. Cliquez sur l'icône plus pour traduire la page. Cela vous amènera à l'écran de l'Éditeur de traduction avancé.
5. Assurez-vous que les éléments textuels du module sont affichés dans l'Éditeur de traduction avancé.
6. Remplissez vos traductions et confirmez-les avec la coche verte. Une fois que vous avez terminé, cliquez sur le bouton Terminé.

7. Vérifiez la page traduite sur l'interface publique.

La page traduite affiche toutes les chaînes de texte traduites, ce qui implique que le fichier de configuration de langue mis à jour fonctionne correctement.

Veuillez noter que les styles CSS pour les éléments de la page de la langue d'origine sont copiés vers la langue de traduction. Cela garantit que tout s'affichera correctement d'une langue à l'autre. Si vous souhaitez désactiver cette fonctionnalité, veuillez consulter cet article pour obtenir des instructions.

Si vous rencontrez des problèmes, veuillez contacter notre équipe de développement de la compatibilité. Ils se feront un plaisir de vérifier les problèmes liés au fichier de configuration de langue.

Une fois les tests terminés, veuillez soumettre une demande de fusion (merge request) sur notre dépôt. Nos développeurs de la compatibilité recevront votre demande et l'examineront.

Veuillez noter que le fichier de configuration de langue hébergé sur notre dépôt correspond à la version par défaut de WPBakery Page Builder. Si vous mettez à jour le fichier de configuration de langue d'une version personnalisée de WPBakery Page Builder, appliquez les modifications au fichier de configuration situé dans le dossier racine de votre extension.