Aide · Contenu et conception · Langues et traduction

Langues et traduction

Votre boutique peut proposer ses produits en plusieurs langues. Ce guide vous explique comment activer une langue, où traduire quels textes, comment modifier les textes fixes de la boutique dans xoLanguage et ce que DeepL traduit pour vous. Vous découvrirez également dans quelle langue sont traitées les commandes, les e-mails et les justificatifs.

En bref

  • Langues : sous Paramètres → Langues / Devises → Langues. Dans les nouvelles boutiques, 19 langues sont prédéfinies, mais seule l’allemand est activée. Le « Statut Frontend » affiche une langue dans la boutique, tandis que le « Statut Admin » vous donne accès aux onglets de traduction.
  • Contenus : vous gérez les articles, les catégories, les pages CMS, les actualités et les modèles d’e-mails dans des onglets distincts pour chaque langue.
  • Textes fixes de la boutique : vous pouvez modifier les textes du panier et de la page de paiement, les boutons, les noms des modes de paiement et les lignes de total sous Outils → xoLanguage en saisissant une « valeur personnalisée ».
  • DeepL : grâce à une clé DeepL dédiée, un bouton situé au-dessus des champs de texte traduit le texte de la langue par défaut. La traduction automatique en arrière-plan est assurée par le module complémentaire « Traduction automatique avec DeepL » ; le support XONIC se charge de le configurer pour vous.
  • Commandes : les e-mails et les justificatifs sont envoyés dans la langue dans laquelle le client a passé sa commande.

Dans ce guide


Où se trouvent les textes à traduire

Les textes se trouvent à trois endroits : dans les enregistrements de données (avec un onglet par langue), dans les fichiers de langue et dans les masques des différents modules. Le tableau indique où trouver chaque élément.

TexteOù le traduire
Nom, descriptions et balises méta d’un articledans l’article sous Produits → Catégories / Produits: nom dans l’onglet « Général », descriptions dans l’onglet « Description/Onglets », balises méta dans l’onglet « SEO », pour chaque langue
CatégoriesProduits → Catégories / Produits, modifier la catégorie, pour chaque langue
Caractéristiques et leurs valeursProduits → Caractéristiques du produit, un champ par langue
Champs supplémentaires du produitProduits → Champs supplémentaires des produits: chaque champ appartient à une langue, voir « Ce qui se passe à la mise en service »
Pages CMS et modules tels que le pied de pageCMS → Gestionnaire CMS, voir « CMS et e-mails »
Articles d'actualitéCMS → Articles d'actualité, voir Articles d'actualité
Modèles d'e-mailsCMS → E-mails & marketing / Automatisations, voir CMS & e-mails
Nom et description d'un mode de livraisonParamètres → Paiement → Modes de livraison, modifier un mode de livraison, onglet par langue
Textes d'un mode de paiement lors de la sélection, dans le récapitulatif de la commande et dans la confirmation de commandedans le masque du mode de paiement sous Paramètres → Paiement → Modes de paiement, voir Modes de paiement
Nom d’un mode de paiement, par exemple « Paiement anticipé »Outils → xoLanguage, section relative au mode de paiement, par exemple « payment_moneyorder »
Lignes de total telles que « Frais d'emballage »Outils → xoLanguage, section « order_total »
Statut de la commandeCommandes → Statut de la commande, un champ par langue
Titres et noms SEO des pages fixes de la boutique telles que Panier, Caisse et ContactParamètres → SEO / SEA → Titres et balises méta, voir SEO et redirections
Boutons, textes dans le panier, la page de paiement et le compte client, messages d'erreurOutils → xoLanguage, voir xoLanguage

Activer une langue

Vous gérez les langues sous Paramètres → Langues / Devises → Langues. Dans les nouvelles boutiques, 19 langues sont prédéfinies, dont l'anglais, le français, l'italien, l'espagnol et le néerlandais. Seule la langue allemande est activée. Pour les langues prédéfinies, les textes fixes de la boutique sont en grande partie déjà traduits. Certains textes récents manquent dans certaines langues ; ils s'affichent alors dans la langue par défaut.

Chaque langue dispose de deux boutons dans la liste. Ils fonctionnent indépendamment l’un de l’autre :

BoutonEffet
« Statut front-end »La langue apparaît dans la boutique : dans la sélection de langue, avec ses propres adresses et comme destination de la redirection en fonction de la langue du navigateur.
« Statut Admin »La langue dispose de son propre onglet dans les interfaces de l'administration, apparaît dans xoLanguage et est proposée comme choix de langue lors de la connexion à l'administration.

Voici comment procéder

  1. Dans la liste, activez « Statut Admin » pour la langue souhaitée. La boutique crée alors une version dans la nouvelle langue pour les articles, les catégories, les pages, les modèles d’e-mails et d’autres sections, dans un premier temps sous forme de copie des textes de la langue par défaut.
  2. Traduisez les textes : manuellement dans les onglets de la nouvelle langue, à l’aide du bouton DeepL ou via la traduction automatique (voir DeepL).
  3. Activez «Statut front-end ». Ce n’est qu’à ce moment-là que vos clients verront la langue.
  4. Vérifiez les modèles d’e-mails, les mentions légales et passez une commande test, voir la liste de contrôle.
Liste des langues dans l'interface d'administration, avec les colonnes Nom, Intitulé, Codification (ISO-639-1), Tri, Statut front-end et Statut admin : « Deutsch » (par défaut) et « English » sont tous deux actifs, « Français » n'est actif que sous le statut « Admin », « Italiano », « Español » et « Nederlands » sont inactifs

Sous Paramètres → Langues / Devises → Langues, activez « Statut Frontend » et « Statut Admin » séparément pour chaque langue ; le français n’est ici activé que dans le backend. Cliquez pour agrandir.

N’activez « Statut front-end » qu’une fois les textes traduits. Sinon, les clients et les moteurs de recherche verront les textes de la langue par défaut sous les adresses de la nouvelle langue.

Langue par défaut

La langue par défaut est signalée dans la liste par la mention « (Par défaut) ». Elle ne peut être ni désactivée ni supprimée. C'est à partir de celle-ci que DeepL effectue la traduction, et ses adresses ne comportent pas de code de langue. L'option « Définir comme par défaut » vous permet de choisir une autre langue comme langue par défaut. Cela modifie toutes les adresses de votre boutique. Veuillez donc nous consulter au préalable avant d’effectuer un changement.

Uniquement en front-end

Une langue peut être visible dans la boutique sans disposer d’un onglet dans l’interface d’administration. La liste affiche alors « Actif uniquement en front-end – la gestion s’effectue automatiquement via DeepL, pas d’onglet d’édition dans l’interface d’administration. » Cela ne convient que si DeepL traduit automatiquement tous les textes. Vous ne pouvez modifier les textes de cette langue ni dans les masques ni dans xoLanguage. Pour les articles et les pages nouvellement créés, la boutique génère la version dans cette langue lorsque quelqu’un ouvre la page « Langues ». En règle générale, vous devez donc activer les deux boutons.

Créer une langue personnalisée

Si une langue manque, créez-la via l’onglet « Insérer » : « Nom » (c’est ainsi qu’elle apparaîtra dans la sélection des langues), « Codage » avec deux lettres selon la norme ISO 639-1, par exemple pt, « Ordre de tri », les deux statuts et « Dupliquer les valeurs linguistiques à partir de la langue suivante ». La boutique copie tous les textes et les fichiers de langue de la langue sélectionnée. Les textes fixes de la boutique restent ensuite disponibles dans cette langue. Vous pouvez supprimer les langues que vous avez créées vous-même, mais uniquement désactiver celles fournies par défaut.


Ce qui se passe lors de l’activation

Lorsqu’une langue est activée, que ce soit dans l’interface publique ou dans l’interface d’administration, la boutique en ligne complète toutes les versions manquantes dans cette langue. Pour ce faire, elle copie les textes de la langue par défaut. Ce qui a déjà été traduit reste inchangé.

Copie de la langue par défaut

Les articles, catégories, caractéristiques, pages CMS, articles d’actualité, modèles d’e-mails, modes de livraison, statuts de commande et autres sections reçoivent une copie des textes en allemand. La boutique ne copie pas les avis clients : ceux-ci n’apparaissent que dans la langue dans laquelle ils ont été rédigés.

Champs supplémentaires des produits

Un champ supplémentaire est toujours associé à une langue. Les champs que vous avez créés pour l’allemand n’apparaissent pas dans la nouvelle langue et ne sont pas copiés. Créez vos propres champs pour la nouvelle langue sous Produits → Champs supplémentaires des produits, puis remplissez-les dans la fiche produit. « Langue » = « Toutes » crée un champ par langue avec le « statut Admin ».

Adresses

Les pages d’une autre langue commencent par /lng/ suivi du code de la langue, par exemple /lng/en/. Le nom allemand copié apparaît ensuite. Ce n’est qu’une fois que vous aurez traduit le nom que l’adresse s’affichera dans la nouvelle langue ; voir Noms SEO.

Pages fixes de la boutique

Si une page fixe de la boutique, comme la page de paiement, ne dispose pas de nom dans la nouvelle langue, la boutique reprend le nom allemand suivi du code de langue, par exemple kasse-en. Ainsi, chaque adresse reste unique. Traduisez les noms dans Paramètres → SEO / SEA → Titres et balises méta.


Changement de langue dans la boutique

Dès que plusieurs langues ont le « statut Frontend », la boutique affiche un menu de sélection de langue dans l’en-tête. Le changement de langue redirige vers la même page dans l’autre langue.

En haut, l'en-tête de la boutique avec l'icône du globe entre la barre de recherche et le compte client ; en dessous, la même page de catégories avec la fenêtre « Langue » ouverte sur le côté droit et les options DE – Allemand (sélectionné) et EN – Anglais

Un clic sur l'icône en forme de globe dans l'en-tête ouvre le menu de sélection de la langue sur le côté droit. Cliquez pour agrandir.

Sélection de la langue

Afficher ou masquer via Paramètres → Design → En-tête → Afficher/masquer le menu de sélection de la langue dans l'en-tête, activé par défaut. L'ordre des langues est déterminé par le « critère de tri » des langues.

Adresses par langue

La langue par défaut utilise des adresses sans abréviation ; les autres langues commencent par /lng/en/, /lng/fr/, etc. La boutique redirige de manière permanente les anciens liens commençant par ?language=en vers la nouvelle forme.

En fonction de la langue du navigateur

Avec Paramètres → Général → Paramètres de base → Adapter la langue de la boutique à celle du navigateur (désactivé par défaut), la boutique redirige les visiteurs vers la version dans la langue de leur navigateur lors de leur première visite, à condition que cette langue soit activée dans la boutique. Ceux qui changent ensuite de langue eux-mêmes conservent leur choix. La boutique ne redirige pas les moteurs de recherche. 4.9.47

Panier

Après un changement de langue, le panier affiche les caractéristiques sélectionnées dans la nouvelle langue, et celles-ci apparaissent également ainsi dans la commande. Si le nom d’une caractéristique n’existe pas dans cette langue, la boutique utilise le nom de la languepar défaut. 4.9.33

Un changement de langue ne modifie pas la devise ; voir « Devise par pays ».


Traduire les contenus par langue

Les articles, catégories, pages CMS, actualités, modèles d’e-mails et bien d’autres enregistrements disposent, pour chaque langue, d’un onglet ou d’un champ distinct portant le code de la langue, accessible via le « Statut Admin ».

Un champ vide devient une copie

Si vous laissez un champ vide pour une autre langue, la boutique y copie le texte de la langue par défaut lors de l’enregistrement. Si vous modifiez ultérieurement le texte en allemand, la copie reste inchangée. Vous pouvez alors mettre à jour les deux langues ou laisser la traduction automatique faire son travail.

Traduction via DeepL

Si une clé DeepL est enregistrée, le bouton « Traduire avec DeepL » ou simplement « DeepL » apparaît à droite au-dessus de chaque champ de texte dans les onglets des autres langues. Il traduit le texte du champ de la langue par défaut, tel qu’il apparaît actuellement dans le masque. Enregistrez ensuite comme d’habitude.

Liens dans le texte

Créez des liens vers les pages de votre boutique via la boîte de dialogue « Liens » de l’éditeur, pour les pages CMS via la liste de sélection « Liens CMS », ou avec une adresse sans domaine, par exemple store-cms.php?cID=<ID>. La boutique génère alors l’adresse dans la langue du visiteur. Une adresse complète avec https:// est reprise telle quelle ; elle renvoie toujours vers la même version linguistique.

Fiche produit, onglets « Description », onglet « EN » avec une description du produit en anglais (brève) et une description du produit ; au-dessus de chaque champ, à droite, le bouton « Traduire avec DeepL »

Dans l’onglet EN, la fonction « Traduire avec DeepL » traduit le texte du champ en allemand vers le champ situé en dessous ; enregistrez ensuite comme d’habitude. Cliquez pour agrandir.

Bon à savoir

  • ContentEditor : terminez la page dans la langue par défaut avant de la traduire, voir ContentEditor.
  • Fabricants : la traduction automatique ne prend pas en charge les textes des fabricants. Utilisez pour cela le bouton DeepL dans le masque sous Produits → Fabricants.
  • Les avis clients restent dans la langue de l'auteur. Il n'y a pas de traduction.

Modifier les textes fixes de la boutique : xoLanguage

Les textes qui n’appartiennent ni à un article ni à une page se trouvent dans les fichiers de langue : boutons, textes du panier, de la page de paiement et du compte client, messages d’erreur ainsi que les noms des modes de paiement et des lignes de total. Vous pouvez les modifier sous Outils → xoLanguage.

  1. Sous « Framework », sélectionnez « Frontend ». C’est là que se trouvent les textes de la boutique ; « Backend » contient les textes de l’interface d’administration.
  2. Sous « Section », sélectionnez la page sur laquelle se trouve le texte (tableau ci-dessous). Utilisez les flèches à côté de la sélection ou les touches fléchées de votre clavier pour passer à la section précédente ou suivante. Les sections surlignées en rouge contiennent des textes qui manquent encore dans une langue.
  3. Recherchez le texte à l’aide de la fonction de recherche de votre navigateur (Ctrl+F, sur Mac :Cmd+F). Il n’existe pas de recherche globale sur toutes les sections.
  4. Dans la ligne, cliquez sur « Valeur personnalisée » et saisissez le nouveau texte pour chaque langue dans la ligne supplémentaire.
  5. Cliquezsur « Actualiser » et rechargez la page de la boutique.
xoLanguage avec le framework Frontend et la section order_total, dans laquelle figurent (les autres clés de la section ont été omises) la ligne MODULE_ORDER_TOTAL_PACKAGING_COSTS_TITLE avec « Frais d'emballage » et « Packaging costs », ainsi que la ligne surlignée en jaune contenant sa propre valeur avec « Frais d'emballage forfaitaires » et « Packaging fee »

Saisissez votre propre valeur pour chaque langue dans la ligne jaune située sous le texte fourni, ici « Frais d'emballage forfaitaires » au lieu de « Frais d'emballage » (extrait). Cliquez pour agrandir.

Enregistrez toujours votre modification en tant que « valeur personnalisée ». La boutique en ligne enregistre vos valeurs personnalisées dans un fichier dédié, qui n’est pas écrasé par les mises à jour. La ligne supérieure contenant le texte fourni remplace en revanche chaque mise à jour ; elle est de toute façon verrouillée pour les administrateurs normaux. Si une valeur personnalisée est déjà enregistrée, elle apparaît en jaune juste en dessous de la clé.

À quelle page correspond chaque section ?

Où se trouve le texteSection
sur toutes les pages : en-tête, pied de page, boutons, textes dans les e-mails, formule d’appeldefault
Panierstore-checkout-cart
Connexion et inscription, y compris lors du passage en caissecustomer-login
Paiement : livraison, paiement, vérification de la commande, finalisation de la commandecheckout-step2, checkout-step3, checkout-step4, checkout-step6
Compte client, par exemple carnet d'adresses et données personnellescustomer, customer-address, customer-edit et autres avec customer-
page produitstore-products
Lignes de total telles que les frais d’emballageorder_total
Compléments relatifs aux modes de livraison, tels que « Livraison vers »shipping
Nom et description d’un mode de paiementpayment_ et le nom du module, par exemple payment_moneyorder pour le paiement anticipé
Messages d'erreur dans les formulairesform-errors

Exemples

Renommer les frais d’emballage

Section « order_total », clé MODULE_ORDER_TOTAL_PACKAGING_COSTS_TITLE (par défaut « frais d'emballage »). Saisissez votre propre valeur pour chaque langue, par exemple « frais d'emballage forfaitaires » et « Packaging fee ».

Renommer un mode de paiement

Pour le paiement anticipé : section « payment_moneyorder », clé MODULE_PAYMENT_MONEYORDER_TEXT_TITLE. Les autres modes de paiement disposent chacun d’une section distincte commençant par payment_.

Connexion et inscription

Section « customer-login », par exemple TEXT_AUTH_LOGIN_HEADING (« Bienvenue »), TEXT_AUTH_REGISTER_HEADING (« Créer un compte ») et TEXT_AUTH_GUEST_NOW (« Commander en tant qu’invité »).

Remarque dans le panier

Section « store-checkout-cart », par exemple TEXT_INFO_SHIPPING_ESTIMATOR (« Les éventuelles réductions ou avoirs ne seront calculés qu’au moment du paiement ! ») ou la remarque concernant les articles en rupture de stock OUT_OF_STOCK_CAN_CHECKOUT. La même clé figure souvent également dans la section d’une étape du paiement ; modifiez-la également à cet endroit.

« Carnet d'adresses »

Le titre « Mon carnet d'adresses » se trouve dans la section « customer-address ». Ce mot apparaît également dans « customer-address-change », « checkout-step2 » et « checkout-step3 ». Un texte figure souvent dans plusieurs sections ; vérifiez chaque page après avoir effectué la modification.

Bon à savoir

  • Quelles langues : xoLanguage affiche une colonne par langue avec « Status Admin ».
  • Texte manquant : si un texte manque dans une langue, la boutique affiche le texte de la langue par défaut.
  • DeepL dans xoLanguage : si une clé DeepL est enregistrée, un bouton « DeepL » apparaît sous les champs vides. « Custom DeepL » traduit vos propres valeurs de la section depuis la valeur allemande vers les champs vides des autres langues. Cliquez ensuite sur « Actualiser ». La traduction automatique ne prend pas en compte les fichiers de langue.
  • Message d'erreur concernant « max_input_vars » : xoLanguage nécessite le paramètre PHP « max_input_vars » avec une valeur d'au moins 100 000. S'il manque, la page affiche ce message à la place des textes ; votre hébergeur doit augmenter cette valeur.

Modes de livraison, modes de paiement, statuts et e-mails

Vous gérez certains textes directement dans l'interface du module, dans un onglet ou un champ distinct pour chaque langue.

Modes de livraison

Sous Paramètres → Paiement → Modes de livraison, modifiez le mode de livraison. Les onglets par langue contiennent les champs « Nom » et « Description ». Si le champ « Nom » est vide, le nom de la langue par défaut est repris lors de l'enregistrement. Pour savoir comment créer des modes de livraison, consultez la section Expédition et livraison.

Modes de paiement

Les textes affichés lors de la sélection, dans l’aperçu de la commande et dans la confirmation de commande se trouvent dans l’interface du mode de paiement, sous les champs, avec un onglet par langue. Vous pouvez modifier le nom lui-même, par exemple « Paiement anticipé », dans xoLanguage. Pour plus de détails, consultez la rubrique « Modes de paiement ».

Statut de la commande

Sous « Commandes » → « Statut de la commande », chaque statut dispose d’un champ par langue. Dans son compte client, le client voit le statut dans la langue dans laquelle il utilise actuellement la boutique ; dans l’e-mail de statut, celui-ci s’affiche dans la langue de la commande.

Modèles d’e-mails

Sous CMS → E-mails & Marketing / Automatisations, chaque modèle dispose d’un onglet par langue, avec des boutons DeepL pour l’objet et le texte. Vérifiez chaque modèle dans la nouvelle langue ; voir CMS & E-mails.

Modifier le mode de livraison « Frais de livraison 1 » dans Paramètres → Paiement → Modes de livraison, onglet EN avec le nom « Standard shipping » et la description « Livraison sous 2 à 3 jours ouvrés »

Vous gérez le nom et la description du mode de livraison dans leur masque, dans un onglet distinct pour chaque langue. Cliquez pour agrandir.


Passer à la forme familière dans la boutique

Il n’existe pas de version « tu » toute prête pour les textes allemands. Les textes fournis utilisent la forme « vous ». Pour passer à la forme « tu », modifiez les textes aux endroits indiqués.

  1. Les textes fixes de la boutique sont définis dans xoLanguage sous forme de valeurs distinctes pour chaque section. Commencez par « default », « store-checkout-cart », « customer-login » et les sections de paiement « checkout-step2 » à « checkout-step6 », puis passez aux sections du compte client.
  2. Formule de politesse dans les e-mails : dans les modèles d’e-mails, remplacez l’espace réservé {SALUTATION} (« Chère Madame Exemple ») par {SALUTATION_INFORMAL} (« Bonjour Erika »). Les formules de politesse se trouvent dans xoLanguage, section « default », clés SALUTATION_FORMAL … et SALUTATION_INFORMAL ….
  3. Reformulezles modèles d’e-mails et les pages du CMS dans l’onglet correspondant, ainsi que les textes relatifs aux modes de paiement et aux modes de livraison.
  4. Parcourez la boutique en ligne : panier, connexion, paiement, compte client et passez une commande test avec tous les e-mails correspondants.

Configurer DeepL

DeepL traduit en arrière-plan les textes de la langue par défaut vers vos autres langues. Pour cela, vous devez disposer de votre propre compte DeepL avec accès à l’interface de programmation (API), gratuite ou payante.

  1. Copiez la clé API depuis votre compte DeepL.
  2. Sous Paramètres → Interfaces → Outils de traduction → DeepL, saisissez la clé dans le champ « DeepL Authkey ».
  3. Sélectionnezle « Mode API DeepL » correspondant à votre compte : free pour le compte gratuit, paid pour le compte payant. La boutique en ligne enverra alors ses requêtes à l’adresse DeepL appropriée.
  4. Enregistrer. Désormais, les boutons DeepL apparaissent dans les formulaires.
Paramètres → Interfaces → Outils de traduction → DeepL avec les champs « DeepL Authkey » (clé fictive composée de zéros), « Mode API DeepL » sur « paid » et la version de gestion des balises DeepL laissée vide

La clé et le mode API doivent correspondre au compte DeepL : « paid » pour le compte payant, « free » pour le compte gratuit. Cliquez pour agrandir.

Passer en mode Pro

Saisissez la clé du compte payant et réglez le « Mode API DeepL » sur « paid ». La clé et le mode doivent correspondre, sinon les traductions échoueront. Si la traduction automatique est active chez vous, prévenez-nous au préalable : votre tâche en arrière-plan dépend de la clé et doit être adaptée en conséquence.

Connexion à DeepL

La boutique envoie la clé dans l’en-tête de chaque requête adressée à DeepL, et non dans l’adresse. C’est ainsi que XONIC 4 fonctionne depuis le début. En raison des changements apportés aux procédures de connexion chez DeepL, vous n’avez rien à modifier.

Quota

DeepL facture au nombre de caractères. Lorsque le quota est épuisé, le bouton affiche le message « Quota DeepL épuisé… » et laisse le champ inchangé. La traduction automatique s’arrête et reprend lors de la prochaine exécution. Si la clé est incorrecte, le message « DeepL : échec de l’authentification… » s’affiche.

Version de gestion des balises

Laissez le champ « Version de gestion des balises DeepL » vide. Le paramètre de votre compte DeepL s’applique alors par défaut. Ne définissez une version que si votre compte la prend bien en charge.


Traduction automatique avec DeepL

Au lieu de traduire champ par champ, la boutique peut traduire régulièrement vos contenus en arrière-plan. Cette traduction automatique est assurée par le module complémentaire XONIC Premium : Traduction automatique avec DeepL. Une fois la souscription effectuée, le support XONIC se charge de la configuration pour vous. Nous déterminons alors avec vous les langues cibles et les sections à traduire. Vous pouvez utiliser le bouton DeepL situé au-dessus des champs de texte même sans module supplémentaire.

Ce qui est traduit

Catégories, articles (nom, descriptions, description de la page de paiement, balises méta, légendes d’images), onglets de produits, caractéristiques et valeurs, pages et encadrés CMS, modèles d’e-mails, articles d’actualité et catégories d’actualités, FAQ, sliders, modes de livraison et profils de livraison, points de retrait, bons de réduction, statuts de commande, badges de produits, blocs de texte ainsi que le titre et la description de la page d’accueil. La traduction s’effectue dans toutes les langues activées, sauf indication contraire de notre part.

Ce qui n’est pas traduit

Les fichiers de langue, y compris vos propres valeurs issues de xoLanguage, ainsi que les textes des fabricants, les champs supplémentaires des produits et les avis clients. Vous traduisez vous-même ces textes, dans xoLanguage et dans les formulaires, notamment à l’aide du bouton DeepL.

Quand la traduction a-t-elle lieu ?

Chaque cycle traduit ce que DeepL n’a encore jamais traduit, ainsi que tout ce dont le texte dans la langue par défaut a été modifié depuis lors. Le fait qu’un champ soit vide dans la langue cible n’a aucune importance : même un champ rempli, par exemple la copie du texte allemand ou votre propre traduction, sera écrasé par le cycle tant que DeepL n’aura pas encore traduit l’enregistrement.

Ordre et durée

À chaque cycle et pour chaque section, la boutique traduit jusqu’à 100 enregistrements. Les petites sections telles que les catégories, les pages CMS et les modèles d’e-mails sont traitées en premier, le catalogue d’articles en dernier. Un catalogue volumineux nécessite donc plusieurs cycles.

Avant le premier cycle : le premier cycle traduit tout ce que DeepL n’a encore jamais traduit et écrase ainsi les traductions existantes dans les langues cibles. Il consomme donc une part importante de votre quota. Indiquez au préalable au service d’assistance les sections que vous avez traduites vous-même ; celles-ci pourront être exclues.

Si vous modifiez le texte allemand

  • Si vous enregistrez une fiche avec un texte modifié dans la langue par défaut, le cycle suivant le traduira à nouveau dans toutes les langues cibles, et ce pour tous les champs de la fiche. Il écrasera ainsi vos propres corrections dans une langue cible. Veillez donc à n’apporter vos corrections qu’après le cycle.
  • Si vous enregistrez sans modifier le texte, par exemple après une modification de prix ou de stock, la boutique ne traduira rien à nouveau.
  • Si DeepL traduit à nouveau un nom, l’adresse dans la langue cible peut changer. La boutique redirige vers l’ancienne adresse ; voir « Noms SEO ».
  • Sans traduction automatique, cliquez à nouveau sur « Traduire avec DeepL » dans les onglets des autres langues, puis enregistrez.

Sous Outils → Informations sur le serveur et bilan de santé, la boutique signale, si DeepL est configuré, que des textes sont en attente de traduction et qu’aucune traduction n’a été effectuée depuis deux jours. Cela signifie que la tâche ne s’exécute plus en arrière-plan ; contactez-nous.ab 4.9.139


Réduire les coûts, protéger certaines sections, glossaire

Ce qui ne passe pas par DeepL n’est pas comptabilisé dans votre quota. Et une fois traduit, la boutique ne retraduit le texte que si le texte source change.

Protéger des sections

La boutique n’envoie pas à DeepL ce qui se trouve dans le texte source entre <!-- xo:notranslate --> et <!-- /xo:notranslate -->. Elle le remplace par un court espace réservé avant l’envoi, puis le réinsère tel quel par la suite. Placez ces deux balises dans la vue du texte source de l’éditeur autour du code, des tableaux de mesures ou des contenus intégrés.

Déjà protégé

Les scripts et les feuilles de style, les vidéos, fichiers audio et iFrames intégrés, les éléments contenant translate="no", les marqueurs de remplacement tels que {STORE_NAME} ou %s, ainsi que les blocs « Code », « Vidéo », « Formulaire », « Compte à rebours » et « Liste de produits » de l’éditeur de contenu ne sont pas transmis à DeepL sous forme de texte.

Pas de traductions en double

La boutique enregistre, pour chaque enregistrement et chaque langue, l’état de la traduction effectuée par DeepL. L’enregistrement sans modification du texte, les importations avec un texte inchangé et les synchronisations depuis le système de gestion des stocks ne déclenchent pas de nouvelle traduction. Seul le service d’assistance peut déclencher une réinitialisation complète de cet état ; après quoi, le processus de traduction effectue une nouvelle traduction complète.

Limiter les langues et les zones

Nous pouvons définir les langues cibles et exclure certains domaines ou champs. Pour les articles, cela peut se faire séparément pour les articles individuels, les articles principaux et les variantes, par exemple en ne traduisant que le nom des variantes.

Glossaire pour les termes fixes

Les termes que DeepL doit toujours traduire de la même manière, tels que les noms de produits ou les termes techniques, sont enregistrés dans un glossaire pour chaque paire de langues. Pour l’allemand vers l’anglais, il s’agit de DE_EN. Il n’y a qu’une seule traduction par terme.

  • Le glossaire s’applique à la traduction automatique dès la prochaine exécution. Le bouton « Traduire avec DeepL » dans les formulaires ne l’utilise pas.
  • Un glossaire définit uniquement la traduction des termes qui y sont enregistrés. Il ne prend pas en compte les périphrases. Vérifiez les pages importantes après l’exécution.
  • Les termes ayant plusieurs significations ne doivent pas figurer dans le glossaire, sinon DeepL les traduira de la même manière partout.

Langue de la commande et langue du client

Chaque commande et chaque compte client ont une langue. Les e-mails et les justificatifs s’adaptent en fonction de celle-ci.

Commande dans la boutique

La langue de la commande est la langue dans laquelle le client a passé sa commande. C’est dans cette langue que sont envoyés la confirmation de commande et les e-mails de suivi, et c’est dans cette langue que la boutique établit la facture et les autres justificatifs. Elle peut être modifiée dans l’éditeur de commande, dans le champ « Langue du client » ; les langues disponibles sont celles ayant le « Statut Admin », voir Commandes.

Compte client

Lors de l'inscription, le compte est configuré dans la langue dans laquelle le client effectue ses achats à ce moment-là. Il peut la modifier sous « Mon compte », « Mes données personnelles », dans le champ « Langue ». Vous pouvez la modifier dans le profil client, dans l'onglet « Données client », champ « Langue du client ». Les e-mails relatifs au compte, par exemple concernant le mot de passe, sont envoyés dans cette langue.

Commandes provenant de places de marché et d’interfaces

Si une commande est passée sans passer par la page de paiement de la boutique, par exemple depuis une place de marché, via Billbee ou l’interface xoPort, elle adopte la langue suivante :

  1. la langue fournie par le fournisseur lors de la commande, par exemple Billbee, Galaxus et les places de marché Mirakl ; pour xoPort, la langue transmise,
  2. sinon la langue du compte client,
  3. sinon la langue par défaut de la boutique.

Seules les langues activées dans la boutique sont prises en compte. Amazon, eBay, Kaufland et OTTO ne fournissent pas de langue ; les commandes provenant de ces sites s’affichent dans la langue du compte client ou dans la langue par défaut, même si elles proviennent d’une place de marché étrangère. 4.9.135


Moteurs de recherche : adresses, hreflang, plan du site

Chaque langue dispose de ses propres adresses. Pour que les moteurs de recherche attribuent correctement les versions linguistiques, la boutique s'occupe elle-même de la majeure partie du travail.

  • hreflang : chaque page indique ses versions dans les autres langues activées ainsi que la langue par défaut sous la forme x-default. Vous trouverez les paramètres pour une boutique multi-langue avec un domaine par marché sous SEO & Redirections : hreflang.
  • Noms SEO : traduisez les noms afin que les adresses s’affichent dans la langue correspondante, voir Noms SEO.
  • Plan du site : ajoutez la nouvelle langue sous Paramètres → SEO / SEA → Paramètres SEO → Langues des plans du site SEO, voir Plans du site.
  • Désactiver une langue : si vous désactivez une langue dans l'interface publique, la boutique redirigera de manière permanente les anciennes adresses des articles, catégories, pages CMS et actualités vers la version dans la langue par défaut.

Devise par pays

La langue et la devise sont indépendantes l’une de l’autre. Un changement de langue ne modifie pas la devise.

Avec Paramètres → Paiement → Général → Changement automatique de devise : pays de destination (activé par défaut), la devise change en fonction du pays de livraison, par exemple en CHF pour la Suisse et en EUR pour les pays de l’UE, à condition que vous ayez créé la devise sous Paramètres → Langues / Devises → Devises. Le guide « Prix et groupes de clients » décrit les taux de change et la conversion en fonction de l’adresse IP.


Liste de contrôle : mise en ligne d’une nouvelle langue

Passez en revue ces points dans l’ordre avant que vos clients ne voient la nouvelle langue.

  1. Activez le « Statut Admin », mais laissez le « Statut Frontend » désactivé pour l’instant.
  2. Traduire les contenus : manuellement, à l’aide du bouton DeepL ou avec le module complémentaire de traduction automatique.
  3. Dans xoLanguage, traduisez vos propres valeurs pour la nouvelle langue et vérifiez les sections surlignées en rouge : des textes manquent dans une langue à ces endroits.
  4. Créez et remplissez les champs supplémentaires des produits pour la nouvelle langue.
  5. Vérifiez les modèles d’e-mails, les mentions légales et les textes relatifs aux modes de paiement dans la nouvelle langue ; voir la section « Mentions légales ».
  6. Vérifiez les noms et les noms SEO, puis ajoutez la langue au plan du site.
  7. Activez le « Statut Frontend » et vérifiez la sélection de la langue dans la boutique.
  8. Passez une commande test dans la nouvelle langue et vérifiez la confirmation de commande, l’e-mail de suivi et la facture.


Foire aux questions

Comment activer une langue supplémentaire dans l'interface publique ?

Dans Paramètres → Langues / Devises → Langues, activez le « Statut Admin » pour la langue concernée, traduisez les textes, puis activez le « Statut Interface utilisateur ». Le menu de sélection de la langue apparaît en en-tête de la boutique dès que deux langues ont le « Statut Frontend » et que l'option « Afficher/masquer le menu de sélection de la langue dans l'en-tête » est activée. Toutes les étapes sont décrites dans la section « Activer une langue ».

Que deviennent les champs de produit et les URL SEO lorsque j’active une nouvelle langue ?

La boutique copie les textes de la langue par défaut dans la nouvelle langue, y compris les noms SEO. Les adresses se présentent donc dans un premier temps sous la forme /lng/en/ suivi du nom en allemand, jusqu’à ce que vous traduisiez les noms. Les champs supplémentaires des produits ne sont pas copiés, car chaque champ supplémentaire appartient à une langue spécifique. Créez-les pour la nouvelle langue. Plus de détails sous « Ce qui se passe lors de l’activation ».

Où puis-je traduire des intitulés tels que les frais d’emballage forfaitaires ?

Sous Outils → xoLanguage, framework « Frontend », section « order_total », clé MODULE_ORDER_TOTAL_PACKAGING_COSTS_TITLE. Cliquez sur « Valeur personnalisée », saisissez le texte pour chaque langue, puis cliquez sur « Mettre à jour ». Les autres lignes de total se trouvent dans la même section.

Comment traduire les noms des modes de livraison et des modes de paiement ?

Modes de livraison : sous Paramètres → Paiement → Modes de livraison, modifiez le mode de livraison et saisissez le « Nom » et la « Description » dans l’onglet correspondant à la langue. Modes de paiement : saisissez le nom dans xoLanguage dans la section du mode de paiement, par exemple « payment_moneyorder » pour le paiement anticipé ; saisissez les textes relatifs au mode de paiement dans son masque pour chaque langue.

Comment trouver un texte dans xoLanguage, par exemple « Carnet d’adresses » ?

Sélectionnez la section de la page sur laquelle se trouve le texte. La section porte le même nom que la page ; pour le carnet d’adresses, il s’agit de « customer-address ». Effectuez une recherche sur la page à l’aide deCtrl+F. Les textes qui apparaissent sur toutes les pages se trouvent dans « default ». Vous trouverez le tableau des sections dans xoLanguage.

Où puis-je modifier le texte d’information dans le panier ?

Dans xoLanguage, section « store-checkout-cart ». Vous y trouverez tous les textes de la page du panier, par exemple « TEXT_INFO_SHIPPING_ESTIMATOR » (« Les éventuelles réductions ou avoirs ne seront pris en compte qu’au moment du paiement ! ») et la mention relative aux articles en rupture de stock (OUT_OF_STOCK_CAN_CHECKOUT). Saisissez votre texte en tant que « valeur personnalisée ».

Comment renommer les textes relatifs à la connexion et à l’inscription lors du paiement ?

Dans xoLanguage, section « customer-login ». La page de connexion et d’inscription est la même, que le client vienne ou non de la page de paiement. Exemples : TEXT_AUTH_LOGIN_HEADING, TEXT_AUTH_REGISTER_HEADING, TEXT_AUTH_GUEST_NOW.

Les textes de la boutique en allemand sont-ils rédigés à la « tu » ?

Non. Les textes fournis utilisent la forme de politesse « Sie ». Pour passer à la forme familière « Du », modifiez les textes dans xoLanguage en leur attribuant vos propres valeurs, utilisez {SALUTATION_INFORMAL} au lieu de {SALUTATION} dans les modèles d’e-mails et reformulez les pages du CMS ainsi que les textes relatifs aux modes de paiement et d’expédition. La procédure à suivre est indiquée sous « Du » au lieu de « Sie ».

Pourquoi un lien dans une page CMS d’une autre langue ouvre-t-il la mauvaise version linguistique ?

La plupart du temps, le texte contient une adresse complète avec https://. La boutique en ligne la reprend telle quelle, ce qui fait qu’elle renvoie toujours vers la même langue. Définissez le lien via la boîte de dialogue « Liens CMS » de l’éditeur ou sous la forme d’une adresse sans domaine, comme store-cms.php?cID=<ID>. La boutique en ligne construira alors l’adresse dans la langue du visiteur.

Pourquoi une caractéristique apparaît-elle dans la mauvaise langue dans le panier après un changement de langue ?

Lors d’un changement de langue, le panier adapte les caractéristiques à la nouvelle langue. Si une caractéristique s’affiche malgré tout dans la langue par défaut, c’est que son nom manque dans la langue sélectionnée. Saisissez-le sous Produits → Caractéristiques des produits.ab 4.9.33

Comment activer la traduction automatique via DeepL ?

Achetez le module complémentaire XONIC Premium : Traduction automatique avec DeepL et saisissez votre clé DeepL sous Paramètres → Interfaces → Outils de traduction → DeepL. L’assistance XONIC configure la traduction en arrière-plan et définit avec vous les langues et les domaines concernés. Lisez au préalable la section « Traduction automatique ».

La traduction automatique entraîne-t-elle un coût supplémentaire ?

Oui. La traduction automatique en arrière-plan correspond au module complémentaire XONIC Premium : Traduction automatique avec DeepL. Vous pouvez utiliser le bouton DeepL situé au-dessus des champs de texte sans module complémentaire. Dans les deux cas, DeepL vous facture directement les caractères traduits.

Comment enregistrer mes identifiants DeepL et passer au forfait Pro ?

Dans Paramètres → Interfaces → Outils de traduction → DeepL, saisissez la clé dans « DeepL Authkey » et sélectionnez le « Mode API DeepL » : free pour le compte gratuit, paid pour DeepL Pro. Lorsque vous passez à la formule Pro, saisissez la nouvelle clé et réglez le mode sur paid.

Dois-je effectuer des modifications en raison du changement de connexion à l’API DeepL ?

Non. La boutique envoie depuis toujours la clé dans l’en-tête de la requête adressée à DeepL. Vérifiez simplement que la clé et le « mode API DeepL » correspondent bien à votre compte DeepL.

Comment mettre à jour les traductions si je modifie le texte en allemand ?

Avec la traduction automatique : enregistrez le texte allemand modifié. Lors du prochain cycle, l'ensemble des données sera retraduit dans toutes les langues cibles, ce qui écrasera vos propres corrections. Sans traduction automatique : dans les onglets des autres langues, cliquez à nouveau sur « Traduire via DeepL » et enregistrez. Les copies provenant de champs vides ne sont pas automatiquement mises à jour.

Comment éviter que DeepL ne traduise plusieurs fois des articles déjà traduits ?

La boutique s’en charge elle-même : elle ne retraduit un article que si le texte dans la langue par défaut a été modifié. L’enregistrement sans modification du texte, les synchronisations de stock et les importations avec le même texte sont gratuits. De plus, tout est retraduit lorsque l’état enregistré est réinitialisé ; seule l’assistance technique peut déclencher cette opération.

Comment éviter que le code HTML n'augmente les coûts liés à DeepL ?

Dans le code source, placez le code, les tableaux avec des dimensions ou les contenus intégrés entre <!-- xo:notranslate --> et <!-- /xo:notranslate -->. La boutique n’envoie pas ces sections à DeepL. Elle protège de toute façon les scripts, les vidéos intégrées et les modules « Code », « Vidéo », « Formulaire », « Compte à rebours » et « Listes de produits » de l’éditeur de contenu.

Pourquoi DeepL a-t-il écrasé ma propre traduction ?

Le cycle traduit chaque enregistrement que DeepL n’a encore jamais traduit, même si la langue cible est déjà remplie. Et il effectue une nouvelle traduction dès que le texte allemand change. Veuillez donc ne corriger qu’après le cycle et nous indiquer les zones que nous devons exclure.

Pourquoi mes propres textes issus de xoLanguage restent-ils en allemand dans la nouvelle langue ?

La traduction automatique ne prend pas en compte les fichiers de langue. Saisissez votre propre valeur pour chaque langue. Avec une clé DeepL, la fonction « Custom DeepL » de xoLanguage traduit les valeurs d’une section à partir de la valeur allemande vers les champs vides des autres langues.

Dans quelle langue le client reçoit-il la confirmation de commande et la facture ?

Dans la langue de la commande, c'est-à-dire la langue dans laquelle il a passé commande. Vous pouvez la modifier dans l'éditeur de commande, dans le champ « Langue du client ». Les e-mails relatifs au compte client sont envoyés dans la langue du compte.

Pourquoi les commandes provenant de la place de marché française s’affichent-elles en allemand ?

Amazon, eBay, Kaufland et OTTO ne fournissent pas de langue associée à la commande. La commande adopte alors la langue du compte client, ou à défaut la langue par défaut de la boutique. Si le français a le « statut Admin », vous pouvez modifier la langue dans l’éditeur de commande.

Guides complémentaires

Nous configurons vos langues avec vous

Nous vous aidons à configurer la traduction automatique, à sélectionner les rubriques et à établir le glossaire, et si un texte ne se trouve pas là où vous le cherchez.

Contacter l'assistance dès maintenant