[PaaS uniquement]{class="badge informative" title="S’applique uniquement aux projets Adobe Commerce on Cloud (infrastructure PaaS gérée par Adobe) et aux projets On-premise."}

Localisation

Les traductions Commerce vous permettent de personnaliser et de localiser votre boutique pour plusieurs régions et marchés en générant :

Voir Présentation des traductions.

Génération d’un dictionnaire de traduction

Vous pouvez générer un dictionnaire de traduction pour personnaliser les chaînes existantes, traduire des mots et des expressions dans un module personnalisé, localiser un thème ou créer des packages de langue.

Pour commencer la traduction, utilisez une commande pour générer un fichier CSV de dictionnaire avec une liste de tous les mots et expressions existants.

Pour générer le dictionnaire et commencer la traduction :

Options de commande :

bin/magento i18n:collect-phrases [-o|--output="<csv file path and name>"] [-m|--magento] <path to directory to translate>

Le tableau suivant explique les paramètres et valeurs :

Instructions de traduction

Appliquez les règles suivantes lors de la traduction de mots et d’expressions :

Commerce utilise des espaces réservés pour insérer des valeurs contextuelles ; elles ne sont pas utilisées pour les traductions. Par exemple :

Product '%1' has been added to shopping cart.

Remplit avec une valeur :

Product 'Multimeter-2000' has been added to shopping cart.

L’expression obtenue doit contenir au moins un de chaque espace réservé. Supposons, par exemple, qu’il existe des espaces réservés de %1 à %3 dans l’expression d’origine. La traduction peut comporter autant d’espaces réservés que nécessaire dans n’importe quel ordre, mais il doit y avoir au moins une occurrence de %1, %2 et %3. La traduction ne peut pas contenir de valeurs d’espace réservé non présentes dans la valeur d’origine (par exemple, %4, %5, etc.).

Exemple de traduction d’une expression :

"Buy %1 for %2 (%3 incl. tax) each","Compre %1 por %2 (%3 incl. imposto) cada"

Créer un package de langue

Contrairement à un dictionnaire de traduction, vous pouvez traduire n’importe lequel ou l’ensemble des mots et des expressions de l’application Commerce à l’aide d’un package de langue. Vous pouvez traduire un composant particulier (un module ou un thème, par exemple) à l’aide d’un dictionnaire de traduction. En savoir plus sur les packages de langue.

Cette section explique comment créer un package de langue, qui écrit des fichiers CSV dans des modules et des thèmes. Pour créer un package de langue, vous devez effectuer les tâches décrites dans les sections suivantes :

Exécutez la commande du package de langue

Utilisation des commandes :

bin/magento i18n:pack [-m|--mode={merge|replace}] [-d|--allow-duplicates] <source> <locale>

Le tableau suivant explique les paramètres et valeurs de la commande du package de langue :

Créer des répertoires et des fichiers

Les packages de langue se trouvent dans un répertoire sous app/i18n/<VendorName> dans le système de fichiers Commerce avec le contenu suivant :

Pour créer ces fichiers :

Package de langue language.xml

Lors de la déclaration d’un package de langue dans le fichier de configuration language.xml, vous devez spécifier la séquence d’héritage de langue de ce package.

L’héritage de langue vous permet de créer une traduction appelée enfant basée sur une traduction existante appelée parent. Les traductions enfants remplacent les traductions parents. Cependant, si le chargement ou l’affichage de la traduction enfant échoue ou si une expression ou un mot est manquant, Commerce utilise le paramètre régional parent. Exemples d’héritage de package de langue.

Pour déclarer un package, spécifiez les informations suivantes :

<?xml version="1.0"?>
<language xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:App/Language/package.xsd">
    <code>en_GB</code>
    <vendor>magento</vendor>
    <package>en_gb</package>
    <sort_order>100</sort_order>
    <use vendor="oxford-university" package="en_us"/>
</language>

Où :

Si nécessaire, vous pouvez spécifier plusieurs packages parents. Les packages parents sont appliqués sur la base Première utilisation répertoriée.

Exemple d’héritage de langue

Supposons qu’un package de langue hérite de deux autres packages et que ces packages aient également des packages parents et « grands-parents ».

Si un package de langue hérite de deux packages, son language.xml peut se présenter comme suit :

<language xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:App/Language/package.xsd">
    <code>en_GB</code>
    <vendor>magento</vendor>
    <package>language_pack</package>
    <sort_order>100</sort_order>
    <use vendor="parent-package-one" package="language_package_one"/>
    <use vendor= "parent-package-two" package="language_package_two"/>
</language>

Dans l'exemple précédent:

Si l’application Commerce ne trouve pas de mot ou d’expression dans le package en_GB, elle recherche dans d’autres packages dans l’ordre suivant :

La spécification de tous les héritages entre les packages de langue peut entraîner la création de chaînes d’héritage circulaires. Utilisez le test Magento\Test\Integrity\App\Language\CircularDependencyTest pour localiser et corriger ces chaînes.

Configuration de plusieurs packages pour une langue

Pour rendre votre boutique plus flexible, vous pouvez charger plusieurs packages de langue pour la même langue dans votre boutique. Ainsi, vous pouvez utiliser différents packages personnalisés pour différentes parties de votre magasin, car le système compile un seul package à partir de tous les packages disponibles pour une langue.

Pour activer un package supplémentaire pour une langue existante, donnez au nouveau package tout nom à l’exception d’un nom de code de langue existant (pour éviter toute confusion). Spécifiez les configurations d’un package dans le fichier de méta-informations language.xml du package de langue, comme décrit dans la section suivante.

Exemples d’utilisation des commandes de traduction

Les sections suivantes fournissent des exemples complets d’utilisation des commandes décrites dans cette rubrique pour créer des dictionnaires et des packages de traduction :

Exemple : créez un dictionnaire de traduction pour un module ou un thème

Pour ajouter une traduction allemande à un module ou un thème que vous souhaitez distribuer à d'autres commerçants :

Exemple : créer un package de langue

Comme dans l’exemple précédent, générez un fichier CSV, mais au lieu de spécifier un répertoire de module ou de thème, spécifiez l’ensemble du répertoire racine de l’application Commerce. Le fichier CSV obtenu contient toutes les expressions que la commande peut trouver dans le code.