Présentation
Le tag i18n permet d'afficher une chaîne localisée en fonction de la langue courante du navigateur. Pour plus d'informations, consultez la documentation sur CopixI18N.
Exemple PHP
Exemple Smarty
{i18n key="monModule|monModule.maCle" lang="fr"}
Paramètres
key
Le paramètre key (obligatoire) permet de spécifier la clé correspondante à la chaîne localisée requise.
{i18n key="monModule|monModule.maCle"}
lang
Le paramètre lang permet de préciser la langue (ou langue / pays) dans laquelle doit être récupérée la chaîne.
{i18n key="monModule|monModule.maCle" lang="fr"}
{* il est aussi possible de spécifier le pays dans ce paramètre *}
{i18n key="monModule|monModule.maCle" lang="en_US"}
assign
Le paramètre assign permet d'indiquer le nom de la variable à laquelle sera assignée la chaîne. Attention, en précisant ce paramètre, la chaîne ne sera pas affichée mais seulement assignée à une variable. Ce paramètre n'est disponible que dans la version Smarty.
{i18n key="monModule|monModule.maCle" assign="maVariable"}
{* et si l'on souhaite ensuite l'utiliser *}
{$maVariable}
noEscape
Le paramètre noEscape permet d'éviter la transformation html_entities effectuée par défaut sur la chaîne récupérée.
Par exemple, avec la clef suivante :
monModule.maCle = 18 < 20 ? oui !
{i18n key="monModule|monModule.maCle" lang="fr"}
{* génère 18 < 20 ? oui ! *}
{i18n key="monModule|monModule.maCle" lang="fr" noEscape=1}
{* génère 18 < 20 ? oui ! *}
Cas d'une chaîne paramétrée
Vous pouvez préciser d'autres paramètres afin de personnaliser à la volée une chaîne paramétrée.
Par exemple, avec le fichier monModule.properties suivant :
monModule.maCle = Il est %s heure %s
On utilisera
{i18n key="monModule|monModule.maCle" lang="fr" param1="9" param2="30"}
Pour afficher :
Il est 9 heure 30