Système de traduction

Retour index
Documentation développeur

Principe développement pour l'internationalisation (i18n)

Dans le code, les traductions se font par appel de méthodes sur l'objet $langs avec en paramètre la clé de la chaine à traduire. l'objet $langs contient la définition de la langue de l'utilisateur. Il est défini dans toutes les pages.

On trouve 2 méthodes:

 $langs->trans('TRAD_STRING');

• Cette méthode renvoie la traduction de l'entrée TRAD_STRING, tout en codant le résultat en entities HTML pour permettre un affichage correct des caractères spéciaux dans une page HTML.

 $langs->transnoentitiesnoconv('TRAD_STRING');

• Cette méthode renvoie la traduction de l'entrée TRAD_STRING, mais ne code pas le résultat.

Ces 2 méthodes peuvent accepter des arguments complémentaires qui sont substitués aux valeurs %s dans la chaine résultante de la traduction.

Note: Si, en argument, on met une chaîne elle même résultat de traduction, il convient que ce résultat soit renvoyé par la fonction $langs->transnoentitiesnoconv, sinon il sera codé en HTML puis le sera une deuxième fois par l'appel $langs->trans initiale. Exemple:

 print $langs->trans("STRING_TO_TRANSLATE",$langs->transnoentitiesnoconv("STRING_PARAM1"))

Traduire Dolibarr dans une autre langue

Voir la page Documentation traducteur