Exploitation

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 1 fichier par langue avec un code en guise de nom :

ex : fr.json

vous trouverez dans ce fichier :

{
    "lang": { #objet racine (ne pas changer)
        "variable utilisés dans le code": "valeur de traduction",
                ...
    }
}

ex :

{
   "lang": {
       "administrations": "Administrations",
               ...
   }
}

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 ex :

   mylang.json

2) Recréer la structure de langue :

   {
        "lang": {

        }
    }

3) Insérer la variable cible à modifier.

ex :

   {
        "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

ex : es.json 3) Editer l'ensemble des variables du fichier avec les valeurs adéquates. 4) Rajouter la variable es afin qu'il 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. En cas de mise à jour, 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