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

<?php _etag ('i18n', array ('key'=>'monModule|monModule.maCle')); ?>

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