> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lighton.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Langues de l'interface de la plateforme 

> Cette page explique comment gérer les langues de l'interface de Paradigm, incluant le fait d'en ajouter soit même.

# 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 **Traductions** → **Chaî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 **Traductions** → **Chaî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 **Traductions** → **Langues**
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 **Traductions** → **Langues**
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 **Traductions** → **Langues**
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