Comment ajouter une nouvelle langue

Vue d'ensemble

Larapen supporte un nombre illimité de langues. L'anglais et le français sont inclus avec chaque installation, mais vous pouvez ajouter n'importe quelle langue: y compris les langues de droite à gauche (RTL) comme l'arabe et l'hébreu: directement depuis le panneau d'administration.

Lorsque vous ajoutez une nouvelle langue, Larapen crée automatiquement tous les fichiers de traduction nécessaires en copiant les fichiers anglais comme point de départ. Vous pouvez ensuite traduire ces fichiers à votre rythme.

Ajouter une nouvelle langue

Étape 1 : Ouvrir la page des Langues

1. Connectez-vous à votre panneau d'administration sur https://votresite.com/admin.
2. Allez dans Paramètres → Langues.
3. Cliquez sur le bouton « Ajouter une langue ».

Étape 2 : Remplir les détails de la langue

Étape 3 : Enregistrer

Cliquez sur « Enregistrer ». Larapen va :

1. Créer l'enregistrement de la langue dans la base de données.
2. Créer automatiquement tous les fichiers de traduction en copiant les fichiers anglais (en) comme point de départ :
   • Fichiers de traduction du cœur : lang/{code}/ (fichiers PHP) et lang/{code}.json
   • Fichiers de traduction des add-ons : extensions/addons/*/resources/lang/{code}/ (pour chaque add-on installé)

Après l'ajout d'une langue

Traduire les fichiers

Les fichiers de traduction nouvellement créés contiennent le texte anglais comme espace réservé. Vous devez remplacer chaque chaîne anglaise par la traduction correspondante. Consultez l'article « Comment traduire les fichiers de langue » pour des instructions détaillées.

Utiliser la traduction automatique par IA (optionnel)

Au lieu de traduire les fichiers manuellement, vous pouvez utiliser la fonctionnalité de traduction automatique par IA pour traduire tous les fichiers de langue en une seule opération :

1. Allez dans Paramètres → Langues dans le panneau d'administration.
2. Cliquez sur le bouton « Traduction IA » à côté de la langue que vous souhaitez traduire.
3. Le système utilisera le fournisseur d'IA configuré pour traduire tous les fichiers de traduction du cœur et des add-ons dans la langue sélectionnée.

Activer quand c'est prêt

Si vous avez créé la langue comme inactive (pour travailler d'abord sur les traductions), activez-la quand vous êtes prêt :

1. Allez dans Paramètres → Langues.
2. Cliquez sur « Modifier » sur la langue.
3. Cochez la case « Active ».
4. Cliquez sur « Mettre à jour ».

Une fois active, la langue apparaîtra dans le sélecteur de langue côté public et les visiteurs pourront parcourir votre site dans cette langue.

Tester la langue

Après avoir activé la nouvelle langue :

• Visitez votre site web et utilisez le sélecteur de langue pour basculer vers la nouvelle langue.
• Vérifiez que l'URL inclut le préfixe de langue (ex. https://votresite.com/de/).
• Vérifiez que les chaînes traduites apparaissent correctement sur tout le site.
• Vérifiez que le contenu traduisible (pages, éléments de portfolio, etc.) affiche la bonne traduction lorsqu'elle est disponible.

Modifier une langue

Pour modifier les paramètres d'une langue après sa création :

1. Allez dans Paramètres → Langues.
2. Cliquez sur « Modifier » sur la langue que vous souhaitez modifier.
3. Vous pouvez modifier : le nom, le nom natif, la direction, l'icône de drapeau, la locale système, les formats de date/heure, la position et le statut actif.
4. Le code de la langue ne peut pas être modifié après la création.

Champs supplémentaires disponibles lors de la modification

Supprimer une langue

1. Allez dans Paramètres → Langues.
2. Cliquez sur le bouton supprimer (icône poubelle) à côté de la langue.
3. Confirmez la suppression.