Comment traduire les communautés BuddyPress et BuddyBoss dans WordPress

Avant de commencer

Installez et activez ces extensions :

• BuddyBoss Platform ou BuddyPress. Si vous utilisez BuddyPress 12.0 ou une version ultérieure, activez également le module complémentaire BP Classic.
• WPML et WPML Traduction de chaînes.
• WPML Multilingual for BuddyPress and BuddyBoss (le module complémentaire de liaison couvert par cette page).

Créez d’abord votre communauté dans la langue source. Créez les pages générées par BuddyBoss : Groupes, Membres, Fil d’actualité (News Feed), et toute page personnalisée. Définissez vos types de profils et types de groupes dans l’interface d’administration de BuddyBoss. Enregistrez vos champs personnalisés de profil. Configurez vos forums et sujets d’activité. Vous pourrez les modifier ultérieurement et envoyer des mises à jour pour traduction à tout moment.

Tout traduire automatiquement s’en charge pour vous

Si l’option Tout traduire automatiquement est activée sur votre site, vous n’avez pas besoin d’envoyer manuellement chaque partie de la communauté pour traduction. WPML détecte le contenu nouveau et mis à jour de la communauté en même temps que le reste de votre site. Il traduit tout en arrière-plan.

Les étapes de configuration ci-dessous s’appliquent toujours : format d’URL, rendre les forums traduisibles, sélecteur de langue. L’étape de traduction est automatique. Le reste de cette page décrit le processus manuel pour les sites utilisant Traduire une partie : vous choisissez quoi traduire.

Définissez votre format d’URL sur « Langues différentes dans les répertoires »

WPML Multilingual for BuddyPress and BuddyBoss requiert le format d’URL Langues différentes dans les répertoires (par exemple, example.com/fr/). Accédez à WPML > Paramètres > URL et SEO et confirmez le réglage Format d’URL de langue.

Traduisez les pages par défaut de votre communauté

BuddyPress et BuddyBoss génèrent un ensemble de pages par défaut : Groupes, Membres, Fil d’actualité, et toutes les pages de communauté que vous avez ajoutées. Traduisez-les via le Tableau de bord de traduction :

1. Accédez à WPML > Traductions > Tableau de bord.
2. Développez la section Pages.
3. Cochez les pages de la communauté.
4. Choisissez une méthode de traduction. PTC (recommandé), votre traducteur, ou Traduire moi-même.
5. Cliquez sur Traduire.

Traduisez les forums

Les forums sont un type de publication personnalisé. Rendez-les d’abord traduisibles, puis traduisez-les :

1. Accédez à WPML > Paramètres > Traduction des types de publication.
2. Réglez Forums sur Traduisible et cliquez sur le bouton Enregistrer.
3. Retournez à WPML > Traductions > Tableau de bord et traduisez le contenu du forum depuis la section Forums.

Vous pouvez également créer des forums distincts par langue. Par exemple, un forum en anglais Best Breakfast Ideas à côté d’un forum en français Idées de petit-déjeuner. Cela donne aux membres de différents marchés leurs propres fils de discussion, afin que leur flux ne mélange pas les langues. Créez-les en tant que forums distincts et traduisez chacun d’eux via le même flux de travail.

Traduisez les types de profils et les types de groupes

Les types de profils sont les types de membres (Member Types) de BuddyPress, tels que Student, Instructor ou Mentor. Les types de groupes sont les types de groupes (Group Types) de BuddyBoss, tels que Cohort, Chapter ou Region. Tous deux se traduisent via la Gestion de traduction :

1. Accédez à WPML > Traductions > Tableau de bord.
2. Les types de profils apparaissent dans la section BuddyPress Profile Type. Les types de groupes apparaissent dans la section BuddyBoss Group Type.
3. Sélectionnez les éléments, choisissez une méthode de traduction et cliquez sur Traduire.

Traduisez les champs personnalisés de profil et les filtres de recherche de profil

Chaque champ personnalisé de profil que vous enregistrez via l’interface d’administration de BuddyBoss se traduit via WPML Traduction de chaînes. Il en va de même pour les filtres de recherche de profil que les membres utilisent pour se trouver.

1. Accédez à WPML > Traductions > Tableau de bord.
2. Faites défiler jusqu’à Autres textes (chaînes).
3. Recherchez les libellés de vos champs et les valeurs de vos options.
4. Sélectionnez-les et envoyez-les pour traduction.

Traduisez les groupes BuddyBoss

Les noms, descriptions et hiérarchies des groupes BuddyBoss se traduisent de deux manières.

Depuis le Tableau de bord de traduction :

1. Accédez à WPML > Traductions > Tableau de bord.
2. Faites défiler jusqu’à Autres textes (chaînes).
3. Recherchez les noms des groupes.
4. Sélectionnez-les et envoyez-les pour traduction.

Depuis le front-end :

Tout utilisateur disposant du rôle approprié peut passer à une langue secondaire et modifier un groupe. La modification s’applique uniquement à cette langue. La langue source reste intacte. Lorsque vous modifiez un groupe traduit, les options du groupe parent s’affichent dans la langue dans laquelle vous effectuez la modification. Les hiérarchies restent préservées par langue.

Traduisez les sujets d’activité, les albums et dossiers de médias

Les sujets d’activité sont les sujets définis par l’administrateur qui organisent le fil d’actualité. Les albums et dossiers de médias sont les téléversements des membres au sein des groupes. Tous trois se traduisent par le même biais :

1. Accédez à WPML > Traductions > Tableau de bord.
2. Faites défiler jusqu’à Autres textes (chaînes).
3. Recherchez le nom du sujet, de l’album ou du dossier.
4. Sélectionnez-le et envoyez-le pour traduction.

Maintenez votre BuddyBoss Platform sur la version publiée actuelle afin que ces fonctionnalités prennent en compte les chaînes traduites.

Traduisez les textes du thème

Les textes du thème BuddyBoss et BuddyPress couvrent le formulaire d’inscription, le formulaire de connexion, les paramètres du compte, la page des messages, les libellés de profil, les onglets de navigation et les libellés des boutons. Ils se traduisent via WPML Traduction de chaînes :

1. Accédez à WPML > Traductions > Tableau de bord.
2. Faites défiler jusqu’à Autres textes (chaînes).
3. Sélectionnez les chaînes du thème.
4. Envoyez-les pour traduction.

Si une chaîne du thème n’apparaît pas dans Autres textes (chaînes), visitez la page qui la contient sur le front-end. Changez de langue et naviguez sur la page. WPML découvre automatiquement la chaîne et l’ajoute à la liste lors de la prochaine actualisation de l’interface d’administration.

Ajoutez un sélecteur de langue

Les membres ont besoin d’un moyen évident de changer de langue. WPML en place un dans le pied de page par défaut. Pour en ajouter un dans vos menus :

1. Accédez à WPML > Paramètres > Sélecteurs de langue.
2. Faites défiler jusqu’à Sélecteur de langue du menu et cliquez sur Ajouter un nouveau sélecteur de langue à un menu.
3. Configurez l’apparence et enregistrez.

Application BuddyBoss – Deux voies de traduction distinctes

Si vous publiez une application native iOS ou Android créée avec l’application BuddyBoss, le flux de travail multilingue se divise en deux voies distinctes.

Chaînes de l’interface utilisateur de l’application – gérées dans l’interface d’administration de BuddyBoss (et non via WPML). Les boutons, libellés, invites et menus de l’application native sont gérés dans BuddyBoss App > Translations dans WordPress. Ajoutez des langues à partir des 29 packs de langue intégrés. Modifiez les traductions par défaut soit dans le tableau de bord, soit via l’exportation et l’importation de fichiers CSV. L’ajout d’une nouvelle langue nécessite une nouvelle compilation de l’application. Pour la procédure complète, consultez la documentation multilingue de l’application BuddyBoss.

Contenu de l’application – traduit via WPML côté WordPress. Les pages, articles, cours et événements que l’application extrait de WordPress se traduisent via WPML. Utilisez le même flux de travail que pour tout contenu basé sur des articles. Traduisez le contenu une fois dans WordPress. L’application affiche la version dans la bonne langue en fonction de la langue choisie par le membre. BuddyBoss le confirme dans sa propre FAQ sur l’application : « for post-based content (pages, posts, courses, events), you may use WPML Plugin that is integrated with BuddyBoss. »

Traduisez le reste de la pile de votre communauté

Une communauté BuddyBoss est généralement associée à un LMS, une extension d’événements, des forums et une extension de paiement. Chaque extension complémentaire compatible avec WPML possède sa propre voie de traduction :

• LearnDash LMS. Voir la compatibilité de LearnDash avec WPML.
• Tutor LMS Pro. Seule la version Pro est prise en charge. Voir la compatibilité de Tutor LMS Pro avec WPML.
• The Events Calendar. Voir la compatibilité de The Events Calendar avec WPML.
• Modern Events Calendar Lite ou Pro. Voir la compatibilité de Modern Events Calendar avec WPML.
• bbPress avec le module complémentaire de liaison bbPress Multilingual. Voir la compatibilité de bbPress avec WPML.
• WooCommerce avec WPML for WooCommerce pour les adhésions payantes et la validation de commande. Voir WPML for WooCommerce.

Chaque extension de cette liste figure dans le répertoire des extensions certifiées compatibles de WPML. Créer une communauté multilingue sur une pile vérifiée permet d’éviter les surprises.

Pièges courants

La plateforme BuddyBoss est vaste et puissante. Elle s’étend du site web aux applications natives iOS et Android, avec des centaines de fonctionnalités et des dizaines d’intégrations. Les équipes de WPML et de BuddyBoss travaillent en étroite collaboration pour maintenir l’intégration multilingue alignée avec chaque version publiée.

Lorsque quelque chose ne se traduit pas comme vous l’attendez, il s’agit généralement d’une lacune temporaire. L’une des deux équipes la suit généralement déjà et publiera un correctif.

Pour consulter la liste actuelle des anomalies connues avec BuddyBoss et WPML ainsi que leurs résolutions, consultez la page de compatibilité de BuddyBoss sur wpml.org. Chaque anomalie y est répertoriée avec son statut actuel, et celles qui sont résolues indiquent la version qui les corrige.