Comment Ajouter de Nouvelles Langues à la Plateforme
Prérequis
Pour ajouter de nouvelles langues, vous devez posséder l’un des rôles suivants :- Administrateur Système (SYS_ADMIN)
- Gestionnaire de Compte (ACCOUNT_MANAGER)
- Super Administrateur (SUPERADMIN)
Guide Étape par Étape
1. Accéder à Django Admin
- Rendez-vous sur le panneau d’administration de la plateforme
- Connectez-vous avec vos identifiants administrateurs
2. Accéder aux Langues
- Dans la barre latérale gauche, trouvez la section “Traductions”
- Cliquez sur “Langues”
3. Ajouter une Nouvelle Langue
- Cliquez sur le bouton “Ajouter une Langue” en haut à droite
-
Remplissez les champs requis :
Code de Langue (obligatoire)
- Entrez le code ISO 639-1 de la langue (2-3 lettres) ou sélectionnez-le dans le menu déroulant
-
Exemples :
es(Espagnol),pt(Portugais),it(Italien),zh(Chinois) - ⚠️ Doit être unique — vous ne pouvez pas ajouter le même code deux fois
- Entrez le nom affiché de la langue
-
Exemples :
Espagnol,Portugais,Italien,Chinois - C’est ce que les utilisateurs verront dans le sélecteur de langue
-
Sélectionnez la direction du texte :
- ltr (de gauche à droite) — Pour la plupart des langues comme l’anglais, l’espagnol, le français
- rtl (de droite à gauche) — Pour l’arabe, l’hébreu, le persan, l’ourdou
- ✅ Coché (par défaut) : La langue apparaît dans la plateforme
- ☐ Décoché : La langue est cachée des utilisateurs (utile pour les tests)
- Cliquez sur “Enregistrer” ou “Enregistrer et ajouter un autre”
4. Vérifier que la Langue Apparaît
- Rendez-vous sur votre page de profil
- Allez dans le menu déroulant Langue dans les paramètres de profil
- Confirmez que la nouvelle langue apparaît dans la liste
Ce qui Se Produit Automatiquement
Une fois que vous avez enregistré une nouvelle langue, les éléments suivants se produisent automatiquement sans aucun déploiement de code : ✅ Frontend :- La langue apparaît dans le menu déroulant de la page de profil
- La direction du texte est appliquée automatiquement lorsqu’elle est sélectionnée
- La langue peut être gérée (modifiée/supprimée) par les utilisateurs autorisés
- Tous les changements sont immédiatement reflétés
Ajouter des Chaînes de Traduction
Après avoir ajouté une langue, vous devez fournir les traductions des chaînes d’interface utilisateur :Méthode 1 : Django Admin
- Allez dans Traductions → Chaînes de Traduction
- Cliquez sur “Ajouter une Chaîne de Traduction”
-
Remplissez :
- Langue : Sélectionnez votre nouveau code de langue
-
Clé : La clé de traduction (ex. :
common.save,profile.language) - Valeur : Le texte traduit
- Cliquez sur “Enregistrer”
Méthode 2 : Import/Export (Téléchargement en Bloc)
- Allez dans Traductions → Chaînes de Traduction
- Cliquez sur le bouton “Exporter” pour télécharger les traductions existantes comme modèle
- Ajoutez des lignes pour votre nouveau code de langue
- Cliquez sur “Importer” pour télécharger le fichier
-
Format : CSV avec les colonnes
language,key,value
Gérer les Langues Existantes
Modifier une Langue
- Allez dans Traductions → Langues
- Cliquez sur la langue que vous souhaitez modifier
- Apportez vos modifications
- Cliquez sur “Enregistrer”
Désactiver une Langue
Pour cacher temporairement une langue sans la supprimer :- Allez dans Traductions → Langues
- Cliquez sur la langue
- Décochez la case “Actif”
- Cliquez sur “Enregistrer”
Supprimer une Langue
- Allez dans Traductions → Langues
- Sélectionnez la langue(s) à supprimer
- Choisissez “Supprimer les langues sélectionnées” dans le menu Actions
- Cliquez sur “Aller”
- Confirmez la suppression