Welcome to the Cookbook

Il n'y a que quelques étapes à franchir pour passer d'une application uni-langue à une application multi-langue, dont la première est d'utiliser la fonction __() dans votre code. Ci-dessous, un exemple de code pour une application uni-langue :

<h2>Posts</h2>

1. <h2>Posts</h2>

Pour localiser votre code, tout ce que vous devez faire est d'inclure vos chaînes de caractères dans la fonction de traduction comme suit :

<h2><?php __('Posts') ?></h2>

1. <h2><?php __('Posts') ?></h2>

Si vous ne faites rien de plus, ces deux bouts de codes donneront un résultat identique - ils renverront le même contenu au navigateur. La fonction __() traduira la chaîne passée si une traduction est disponible, sinon elle la renverra non modifiée. Cela fonctionne exactement comme les autres implémentations Gettext (comme les autres fonctions de traductions, comme __d(),__n() etc)

Après avoir préparé votre code pour le multi-langue, l'étape suivante est de créer votre fichier pot, qui est le template pour toutes les chaînes traduisibles de votre application. Pour générer votre (vos) fichier(s) pot, tout ce que vous avez à faire est de lancer la tâche i18n de la console Cake, qui va chercher partout dans votre code où vous avez utilisé une fonction de traduction, et générer le(s) fichier(s) pot pour vous. Vous pouvez (et devez) relancer cette tâche console à chaque fois que vous changez les chaînes traduisibles dans votre code.

Le(s) fichier(s) pot ne sont pas utilisés par CakePHP, ils sont les templates utilisés pour créer ou mettre à jour vos fichiers po, qui contiennent les traductions. Cake cherchera après vos fichiers po dans les dossiers suivants :

/app/locale/<locale>/LC_MESSAGES/<domaine>.po

1. /app/locale/<locale>/LC_MESSAGES/<domaine>.po

Le domaine par défaut est 'default', donc votre dossier "locale" devrait ressembler à cela :

/app/locale/eng/LC_MESSAGES/default.po (Anglais)
/app/locale/fre/LC_MESSAGES/default.po (Français)
/app/locale/por/LC_MESSAGES/default.po (Portugais)

1. /app/locale/eng/LC_MESSAGES/default.po (Anglais)
2. /app/locale/fre/LC_MESSAGES/default.po (Français)
3. /app/locale/por/LC_MESSAGES/default.po (Portugais)

Pour créer ou éditer vos fichiers po, il est recommandé de ne pas utiliser votre éditeur de texte préféré. Pour créer un fichier po pour la première fois, il est possible de copier le fichier pot à l'endroit correcte et de changer l'extension. Cependant, à moins que vous ne soyez familiarisé avec leur format, il est très facile de créer un fichier po invalide, ou de le sauver dans un mauvais encodage de caractères (si vous éditez ces fichiers manuellement, utilisez l'UTF-8 pour éviter les problèmes). Il y a des outils gratuits tel que PoEdit qui rendent les tâches d'édition et de mise à jour de vos fichiers po vraiment simples, spécialement pour la mise à jour d'un fichier po existant avec un fichier pot nouvellement mis à jour.

Les codes des locales en trois caractères suivent la norme ISO 639-2 mais si vous créez des locales régionales (en_US, en_GB, etc.) Cake les utilisera dans les cas appropriés.

Il y a une limite de 1014 caractères pour chaque valeur msgstr.

Souvenez-vous que les fichiers po sont utiles pour des messages courts. Si vous pensez que vous aurez à traduire de longs paragraphes, ou des pages entières, vous devriez penser à l'implémentation d'une solution différente. Par ex :

// Code du fichier App Controller.
function beforeFilter() {
  $locale = Configure::read('Config.language');
  if ($locale && file_exists(VIEWS . $locale . DS . $this->viewPath)) {
    // utilise /app/views/fre/pages/tos.ctp au lieu de /app/views/pages/tos.ctp
    $this->viewPath = $locale . DS . $this->viewPath;
  }
}

1. // Code du fichier App Controller.
2. function beforeFilter() {
3. $locale = Configure::read('Config.language');
4. if ($locale && file_exists(VIEWS . $locale . DS . $this->viewPath)) {
5. // utilise /app/views/fre/pages/tos.ctp au lieu de /app/views/pages/tos.ctp
6. $this->viewPath = $locale . DS . $this->viewPath;
7. }
8. }

ou

// Code de vue
echo $this->element(Configure::read('Config.language') . '/tos')

1. // Code de vue
2. echo $this->element(Configure::read('Config.language') . '/tos')