magento i18n

La traduction dans Magento

Dans Magento, la traduction entre différentes langues est assez simple. Pour un développeur expérimenté ayant déjà travaillé sur des frameworks PHP, cela se passe de commentaires. Par contre, pour un débutant qui souhaite lancer son premier site Magento, quelques explications peuvent être utiles.

Tous les textes de la page nécessitant une traduction sont dans un fichier CSV du répertoire /app/locale/[language]. La partie [language] du chemin étant à construire à partir du code langue, exemple: 'fr_FR' ou 'en_US'.

En regardant le contenu des fichiers, vous constaterez que la structure de chaque fichier est identique, une ligne contient deux textes: une pour la langue par défaut, et une pour la langue cible. Ces fichiers - aussi appelé "dictionaries" - doivent être déclarés dans le fichier de configuration des modules (config.xml). Vous devez mettre ce code directement dans le noeud du fichier de configuration de votre frontend ou admin.

<translate>
        <modules>
                <companyname_modulename>
                        <files>
                        <default>CompanyName_ModuleName.csv</default>
                        </files>
                </companyname_modulename>
        </modules>
</translate>

C'est tout. Maintenant, lorsque vous voulez utiliser une phrase qui doit être traduite, utilisez :

echo $this->__('text to translate');

Magento cherchera 'text to translate' dans votre fichier dictionnaire et retournera le texte correspondant dans la langue appropriée.

Traduction par Guillaume Morice