Personnalisation des variables de langue de l'application

L'application se base sur des fichiers .json pour pouvoir utiliser différents langages de traduction.

Localisation : lang/

Il y a un fichier par langue avec un code en guise de nom, par exemple :

fr.json

La structure du fichier est comme ceci :

{
    "lang": { #objet racine (ne pas changer)
        "Identifiant utilisé dans le code": "Traduction du texte dans la langue cible",
                ...
    }
}

Exemple :

 {
    "lang": {
        "users": "Utilisateurs",
                ...
    }
}

Modifier une variable de langue

Pour un soucis de maintenance, les fichiers de langues de base ne doivent PAS être modifiés !

Si vous souhaitez créer/adapter vos variables de langues, vous devrez définir un nouveau fichier de langue. Ce fichier de langue surchargera le fichier de langue de l'application.

Créer un dossier custom_lang dans le dossier /lang

Configurer le fichier config/config.xml pour prendre en compte ce nouveau dossier de langues supplémentaires :

<customLangPathDirectory>lang/custom_lang/</customLangPathDirectory>

Dans le dossier /custom_lang : 1) Créér le fichier du même nom que la langue à personnaliser Exemple :

   fr.json

2) Recréer la structure de langue :

```json
{
    "lang": {

    }
}

3) Insérer la variable cible à modifier.

   Exemple : 
   ```json
   {
        "lang": {
            "administrations": "Admin personnalisée",
        }
    }

Vous pouvez également mettre de nouvelles variables ce qui est utile pour créer une nouvelle langue de traduction.

Créer une nouvelle langue de traduction

Créer un dossier custom_lang dans le dossier /lang

Configurer le fichier config/config.xml pour prendre en compte ce nouveau dossier de langues supplémentaires :

<customLangPathDirectory>lang/custom_lang/</customLangPathDirectory>

Dans le dossier /custom_lang: 1) Copier un fichier json de base existant (par exemple fr.json) 2) Changer le nom du fichier par la nouvelle langue

Exemple : es.json 3) Traduisez l'ensemble des variables du fichier dans la langue souhaitée. 4) Rajouter la variable "es" : "Español", afin que le texte s'affiche correctement dans la liste des langues disponibles depuis l'interface. Vous devrez également rajouter cette variable pour les autres fichiers de langue si vous changez de langue. (voir Modifier une variable de langue)
Remarque : il est préférable de rajouter cette variable en recréant des fichiers fr.json et en.json dans votre dossier custom_lang plutôt que de les rajouter directement dans le fichier de langue de base. Dans le cas contraire, lors de la mise à jour de l'application, ces variables risquent de ne pas être reprises.

Pour la nomenclature de vos fichiers de langues, nous vous conseillons d'utiliser les codes norme 639-1 : https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes