Passer au contenu principal
Voici la version française du texte :

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

  1. Rendez-vous sur le panneau d’administration de la plateforme
  2. Connectez-vous avec vos identifiants administrateurs

2. Accéder aux Langues

  1. Dans la barre latérale gauche, trouvez la section “Traductions”
  2. Cliquez sur “Langues”

3. Ajouter une Nouvelle Langue

  1. Cliquez sur le bouton “Ajouter une Langue” en haut à droite
  2. 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
    Nom (obligatoire)
    • 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
    Direction (obligatoire)
    • 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
    Actif (case à cocher)
    • Coché (par défaut) : La langue apparaît dans la plateforme
    • Décoché : La langue est cachée des utilisateurs (utile pour les tests)
  3. Cliquez sur “Enregistrer” ou “Enregistrer et ajouter un autre”

4. Vérifier que la Langue Apparaît

  1. Rendez-vous sur votre page de profil
  2. Allez dans le menu déroulant Langue dans les paramètres de profil
  3. 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
Admin :
  • 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

  1. Allez dans TraductionsChaînes de Traduction
  2. Cliquez sur “Ajouter une Chaîne de Traduction”
  3. Remplissez :
    • Langue : Sélectionnez votre nouveau code de langue
    • Clé : La clé de traduction (ex. : common.save, profile.language)
    • Valeur : Le texte traduit
  4. Cliquez sur “Enregistrer”

Méthode 2 : Import/Export (Téléchargement en Bloc)

  1. Allez dans TraductionsChaînes de Traduction
  2. Cliquez sur le bouton “Exporter” pour télécharger les traductions existantes comme modèle
  3. Ajoutez des lignes pour votre nouveau code de langue
  4. Cliquez sur “Importer” pour télécharger le fichier
  5. Format : CSV avec les colonnes language, key, value

Gérer les Langues Existantes

Modifier une Langue

  1. Allez dans TraductionsLangues
  2. Cliquez sur la langue que vous souhaitez modifier
  3. Apportez vos modifications
  4. Cliquez sur “Enregistrer”
Les modifications prennent effet immédiatement.

Désactiver une Langue

Pour cacher temporairement une langue sans la supprimer :
  1. Allez dans TraductionsLangues
  2. Cliquez sur la langue
  3. Décochez la case “Actif”
  4. Cliquez sur “Enregistrer”
La langue sera cachée des utilisateurs mais les chaînes de traduction resteront dans la base de données.

Supprimer une Langue

  1. Allez dans TraductionsLangues
  2. Sélectionnez la langue(s) à supprimer
  3. Choisissez “Supprimer les langues sélectionnées” dans le menu Actions
  4. Cliquez sur “Aller”
  5. Confirmez la suppression