Gestion des traductions

Télécharger la page en PDF Télécharger la page

Fonctionnalités

Ce module permet de gérer des libellés traduits dans vos modèles de pages et vos rangées de contenus.

Vous pouvez ainsi employer une même rangée ou un même modèle de page dans des sites conçus dans des langues différentes sans avoir de libellés spécifiques à une langue données. Tous vos libellés étant centralisés dans le module et pouvant être traduits dans chaque langue nécessaire.

Les administrateurs d'Automne ont aussi accès à l'ensemble des libellés employés par l'administration d'Automne. Ceci permettant de traduire l'administration d'Automne dans d'autres langues que le français et l'anglais.

De plus, vous avez la possibilité d'importer et d'exporter des ensemble de libellés dans les formats Excel, PO, XML, SQL pour en simplifier la gestion et la traduction dans des outils tiers.

Installation

Pré requis :

Ce module ne nécessite aucun pré-requis supplémentaires par rapport aux pré-requis de base d'Automne.

Installation et mise en route du module :

Le module se présente sous la forme d'un patch Automne. Son installation est donc simple, il vous suffit d'uploader le fichier disponible en téléchargement sur ce site directement dans l'interface d'administration d'Automne pour déclencher son installation automatique.

Pour cela, allez dans l'interface d'administration d'Automne avec un compte administrateur puis, dans le panneau latéral, allez dans "Administration" > "Paramètres Serveur" > "Mises à jour". Fournissez le fichier du module dans le champ "Fichier de mise à jour" puis cliquez sur valider.

Mise à jour du module :

Pour mettre à jour le module, il vous suffit, comme pour son installation d'uploader le fichier de la dernière version du module dans l'interface d'administration d'Automne. Cela déclenchera sa mise à jour automatique.

Fonctionnement

Ce module repose exclusivement sur la création de variables spécifiques au module et utilisables dans les modèles de pages ou de rangées :

Les variables relatives aux traductions à insérer dans les modèles XML sont de la forme {i18n:langue:clé} ou {i18n:clé}.

Elles sont définies dans le module Traductions dans l'onglet "Libellés des modèles".

  • langue : Nom de code de la langue à utiliser (exemple : fr, en, etc.). Si la langue est omise, alors la langue en cours de la page ou de la rangée sera employée.
  • clé : Clé du message à afficher.

Il est possible de rajouter des paramètres permettant de remplacer les valeurs "%s" inclues dans les messages traduits. Dans ce cas, le format à employer est le suivant :

{i18n:langue:clé|parametre1::parametre2::parametre3::...} ou {i18n:clé|parametre1::parametre2::parametre3::...}

Vous pouvez ajouter autant de paramètre que nécessaire. Chaque valeur de paramètre remplacera les valeurs "%s" dans le texte traduit, dans l'ordre d'apparition.

 

Après installation de ce module, vous trouverez une explication détaillée et à jour de ces variables directement dans l'aide des modèles de pages et des rangées de votre instance d'Automne.

 

Page précédente

2 contribution(s)

Par efusien le 14/02/2012 09:29:27 :

Pour une page unique traduite en plusieurs langue, j'utilise un bloc de rangée de type varchar, pour définir une clé i18n.

Voici le code du modèle de rangée qui permet ainsi de définir à l'édition d'une page la clé de traduction à utiliser.
Avec une traduction en HTML c'est bien pratique :
<row>
<block module="standard" type="varchar" id="translate">
<?php
$data = '{{data}}';
echo CMS_i18n::getTranslation($data, $cms_language->getCode());
?>
</block>
</row>


A tester. Si vous avez des retours là dessus postez-le ici.
Ce serait bien qu'une rangée de ce type voit le jour nativement avec le module Traductions.

Par efusien le 14/02/2012 10:11:23 :

Cette syntaxe existe déjà, sauf que la langue est automatiquement récupérée.
{i18n:langue:clé}

Mon souhait était plutôt de définir la clé dynamiquement via l'édition de la page. Je vais poster une suggestion à ce propos.

Ajouter une contribution :

Les contributions servent à compléter la documentation en détaillant des points précis ou pour donner des exemples. Elles sont modérées et peuvent être supprimées sans préavis.
Pour poser des questions, merci d'employer le forum et pour rapporter un bug, le BugTracker est à votre disposition.








Vous pouvez employer les balises bbcode suivantes :
  • [code-xml] votre code ... [/code-xml] : Pour mettre en forme du code XML / XHTML
  • [code-php] votre code ... [/code-php] : Pour mettre en forme du code PHP
  • [code-js] votre code ... [/code-js] : Pour mettre en forme du code Javascript

Date de votre contribution : 29/05/2017   02:07:22

Haut