Traduisez les produits WooCommerce importés : CSV, API, ERP
Maintenez à jour un catalogue WooCommerce multilingue lorsque les produits arrivent par importation CSV, WP All Import, l'API REST ou une synchronisation ERP.
Mis à jour : 16 novembre 2026
Ce guide est destiné aux boutiques dont le catalogue se trouve en dehors de WordPress : dans une feuille de calcul, un PIM, un ERP ou un flux de fournisseur. Les produits arrivent dans WooCommerce via un importateur, l'API REST ou une tâche planifiée, et vous ouvrez rarement l'éditeur de produit.
Partie 1. Comment fonctionne une boutique multilingue gérée de l'extérieur
Un produit par langue, lié par un groupe de traduction
Chaque langue possède son propre produit WooCommerce, avec son propre ID. WPML lie les langues dans un groupe de traduction. L'original est le produit dans la langue par défaut de votre boutique ; les autres langues sont ses traductions.
Dans notre boutique d'exemple, le sweat à capuche zippé (Zip-Up Hoodie) est le produit 14 en anglais, 121 en allemand et 122 en français. Chaque réponse de l'API REST pour l'un d'entre eux contient le même mappage : "translations": {"de":"121","en":"14","fr":"122"}.
Le SKU est le même dans toutes les langues. Les variations d'un produit variable conservent également les mêmes SKU de variation.
Le SKU est la clé pour votre système externe. La propre recherche de WooCommerce, wc_get_product_id_by_sku(), renvoie le produit original, et non une traduction.
Les listes renvoient une langue à la fois.GET /wc/v3/products?sku=HP-HD-ZIP renvoie uniquement la langue par défaut. Ajoutez &lang=de pour une langue, ou &lang=all pour toutes les langues.
Ce que WPML copie dans chaque langue et ce qu'il traduit
Lorsque le produit original change, via l'éditeur de produit, une importation CSV ou l'API REST, WPML copie ces valeurs dans chaque traduction :
Prix régulier et prix de vente
Quantité en stock et état du stock
SKU, poids et dimensions
Image du produit et galerie (chaque langue obtient sa propre copie de l'image)
Catégories et étiquettes (sous forme de catégorie ou d'étiquette traduite)
Montées en gamme et ventes croisées (pointant vers le produit dans la même langue)
Statut de publication
Pour les produits variables : le prix et le stock de chaque variation, la plage de prix, un nouveau terme d'attribut global (comme sa traduction, par exemple Schwarz et Noir pour Black) et une nouvelle variation
Ceux-ci restent différents dans chaque langue, car ils sont traduits :
Nom, description et description courte
Slug (l'adresse du produit, par exemple /de/produkt/kapuzenjacke-mit-reissverschluss/)
Termes d'attribut, tels que Blue, Blau et Bleu
Valeurs des attributs spécifiques au produit, comme un « Material » défini uniquement sur ce produit
Le stock est partagé par toutes les langues.
Écrivez les prix et les attributs sur l'original. Si votre système écrit un prix ou des attributs sur une traduction, la traduction conserve les valeurs de l'original. Le stock écrit dans n'importe quelle langue devient le stock de toutes les langues, car il est partagé.
Les prix dans une deuxième devise suivent également l'original (voir le mode multidevise pour WooCommerce). Définissez-les sur l'original, avec custom_prices dans l'API REST ("custom_prices": {"USD": {"regular_price": "55.00", "sale_price": "49.00"}}) ou avec les colonnes CSV Meta: _wcml_custom_prices_status, Meta: _regular_price_USD, Meta: _sale_price_USD et Meta: _price_USD. Chaque langue affiche ensuite ces prix dans cette devise.
custom_prices est enregistré lorsque le mode multidevise est activé et que la devise fait partie des devises de votre boutique. Envoyez-le de la manière suivante :
Activez d'abord le mode multidevise. Accédez à WPML → Paramètres → Multidevise, cochez Activer le mode multidevise et cliquez sur Enregistrer les modifications. Sous Afficher les devises selon, choisissez une option (par exemple Langue du site) et cliquez sur Enregistrer les modifications. Ajoutez ensuite chaque devise avec Ajouter une devise. Si le mode multidevise est désactivé, WPML n'enregistre rien de custom_prices.
Utilisez les codes de devise de votre boutique. WPML enregistre uniquement les prix des devises de la boutique. Un prix dans tout autre code n'est pas enregistré.
Pour un produit variable, envoyez custom_prices sur chaque variation, et non sur le parent. WPML l'enregistre sur la variation originale, et chaque langue l'affiche. S'il est envoyé sur le parent, il n'est pas enregistré.
Lisez les prix enregistrés à partir de meta_data (_regular_price_USD, _sale_price_USD, _price_USD). Les réponses aux appels REST n'incluent pas de champ custom_prices.
Duplicatas ou traductions indépendantes
WPML propose deux types de produits traduits. Celui que vous avez détermine ce qu'il advient du texte que vous importez.
Duplicata
Traduction indépendante
Ce que c'est
Une copie que WPML maintient
Une traduction avec son propre texte
Texte après la prochaine sauvegarde de l'original
Remplacé par le texte de l'original
Conservé uniquement si Tout traduire est désactivé ou si Produits est défini sur Aucun
Prix et stock
Suivent l'original
Suivent l'original
Où vous le voyez : la boîte Langue d’un duplicata indique « This document is a duplicate of ... and it is maintained by WPML. » (Ce document est un duplicata de ... et il est géré par WPML.) avec le bouton Traduire indépendamment.
Transformer des duplicatas en traductions indépendantes : cliquez sur Traduire indépendamment dans la boîte Langue du duplicata, ou, pour plusieurs produits, accédez à Produits → Tous les produits, passez à la langue de traduction, cochez les produits et choisissez Actions groupées → Traduire indépendamment.
Ce que créent les processus de la partie 2 : le processus A crée des traductions avec Tout traduire. Le processus B importe des traductions indépendantes. Aucun des deux ne nécessite de duplicatas.
Configurez la boutique avant l’arrivée du premier produit
Exécutez le Setup Wizard de WooCommerce Multilingual. Il s’ouvre lorsque vous activez WPML Multilingual & Multicurrency for WooCommerce. Ses écrans sont Pages de la boutique, Attributs globaux et Plusieurs devises. Le premier crée Boutique, Panier, Validation de commande et Mon compte dans chaque langue.
Rendez vos attributs globaux traduisibles. Sur l’écran de l’assistant « Quels attributs de produit doivent être traduisibles ? », cochez chaque attribut, par exemple Couleur et Taille. Plus tard, ce même paramètre correspond à la case Traduisible ? sous Produits → Attributs → Modifier.
Traduisez les termes d’attribut avant les produits. Accédez à WPML → Traductions, ouvrez l’onglet Taxonomie, choisissez l’attribut sous « Sélectionnez la taxonomie à traduire » et traduisez chaque terme. Si Tout traduire est activé (Processus A), WPML traduit les nouveaux termes pour vous.
Partie 2. Construisez-la sans code
Choisissez votre processus : une seule langue ou toutes les langues
WPML marque la traduction comme nécessitant une mise à jour ; votre prochain fichier apporte le nouveau texte
Prix et stock
Suivent l’original
Suivent l’original
Le processus A convient à une boutique qui conserve une seule langue et souhaite toutes les autres langues sans fichiers de traduction. Le processus B convient à une boutique dont le PIM ou les traducteurs disposent déjà des textes dans toutes les langues.
Processus A avec l’outil d’importation CSV de WooCommerce ou WP All Import
Activez Tout traduire une seule fois :
Accédez àWPML → Traductions et cliquez sur Configurer Tout traduire.
Choisissez le contenu. Sous « Contenu à traduire », conservez Tous les produits et cliquez sur Continuer.
Choisissez comment les traductions sont publiées. Sous « Méthode de publication », conservez Publier sans révision.
Cliquez sur Activer Tout traduire automatiquement.
Importez vos produits dans la langue par défaut de la boutique uniquement. Utilisez Produits → Importer (l’outil d’importation CSV de WooCommerce) ou All Import → New Import (WP All Import avec son module complémentaire WooCommerce). Votre fichier ne nécessite aucune colonne WPML.
L’importation elle-même met les traductions en file d’attente. WPML traduit ensuite chaque produit, variation, catégorie et nouveau terme d’attribut dans chaque langue et les publie. Vous ne démarrez rien manuellement, et aucune page de l’interface d’administration de WPML n’a besoin d’être ouverte. Vous pouvez suivre la progression sous WPML → Traductions.
Lorsque vous modifiez un original, Tout traduire traduit uniquement ce qui a changé. Le reste de la traduction reste mot pour mot.
Tout traduire traduit les produits publiés, y compris les produits externes. Il ne traduit pas les produits privés. Les brouillons patientent également : Traduire automatiquement les brouillons (sous WPML → Paramètres → Traduction IA, dans la boîte Éditeur de traduction avancé) est désactivé par défaut, et lorsque vous l’activez, WPML traduit un brouillon uniquement lorsque vous l’enregistrez à nouveau. Pour traduire des brouillons et des produits privés, envoyez-les depuis WPML → Traductions (voir Dépannage).
Si vous souhaitez modifier une traduction, ouvrez-la depuis la boîte Langue du produit (Modifier la traduction ...), modifiez-la dans l’Éditeur de traduction avancé et cliquez sur Enregistrer et terminer. Lorsque l’original change par la suite, votre modification des phrases inchangées est conservée.
Processus B avec l’outil d’importation CSV de WooCommerce
Dans le processus B, votre fichier contient toutes les langues.
Configurez Tout traduire pour les traductions importées avant la première importation :
Accédez àWPML → Traductions. Si Tout traduire est désactivé, laissez-le désactivé et passez au fichier.
Si vous souhaitez que WPML traduise automatiquement vos pages, articles et chaînes de texte, cliquez sur Configurer Tout traduire. Sous « Contenu à traduire », définissez Produits sur Aucun. Cliquez sur Continuer, conservez Publier sans révision et cliquez sur Activer Tout traduire automatiquement.
Si Tout traduire est déjà activé, cliquez sur le menu à trois points dans la boîte « Tout traduire automatiquement est activé », choisissez Ajuster les limites de contenu, définissez Produits sur Aucun et cliquez sur Enregistrer les modifications. Les traductions déjà en cours se terminent tout de même.
Avec Produits défini sur Aucun, WPML conserve vos traductions de produits importées mot pour mot. Lorsqu’un original change, WPML marque ses traductions comme nécessitant une mise à jour, et votre prochain fichier apporte le nouveau texte.
Préparez un fichier avec toutes les langues. Utilisez les colonnes normales de WooCommerce et ajoutez quatre colonnes WPML :
Colonne
Ce qu’elle contient
Exemple
Meta: _wpml_import_translation_group
La valeur qui lie les langues. Utilisez le SKU.
HP-JK-SHELL
Meta: _wpml_import_language_code
La langue de la ligne
de
Meta: _wpml_import_source_language_code
La langue de l’original, qui est la langue par défaut de la boutique. Vide sur les lignes originales.
en
Meta: _wpml_import_after_process_post_status
Le statut une fois que WPML a lié les produits
publish
Triez les lignes par langue, les originaux en premier. Dans chaque langue, les produits précèdent leurs variations.
Importez les produits comme brouillons :Published = -1 sur les produits, 1 sur les variations.
Donnez à chaque langue ses propres textes : noms, descriptions, catégories (Kleidung > Jacken) et valeurs d’attribut (Blau, Grün).
Conservez les noms d’attribut de la boutique (Color, Size) dans chaque langue. Traduisez les étiquettes d’attribut sous WPML → Traductions → Taxonomie.
Indiquez les produits liés et les parents par SKU, le même SKU dans chaque langue.
Une ligne en allemand d’un produit variable de notre fichier d’exemple :
Accédez àProduits → Importer et choisissez le fichier sous « Choose a CSV file from your computer: ». Laissez Mettre à jour les produits existants décoché. Cliquez sur Continuer.
Vérifiez le mappage. Les quatre colonnes Meta: correspondent à Importer en tant que métadonnées. Cliquez sur Lancer l’importateur.
Accédez àWPML → Exportation et importation WPML. L’écran affiche « Good job. We see 33 posts that are imported and need language information. » Cliquez sur Run WPML Import.
Attendez que le message « Multilingual Import Complete → s’affiche.
Jusqu’à l’étape 3, chaque produit est un brouillon en anglais et chaque variation est une variation en anglais, aucun d’entre eux n’étant lié à son original. Après cela :
Chaque produit et chaque variation sont liés dans toutes leurs langues.
Tout est publié.
Les traductions sont des traductions indépendantes.
Les catégories et les termes d’attribut sont liés entre les langues, et les variations de chaque langue utilisent leurs propres termes.
Les montées en gamme pointent vers le produit dans la même langue, et chaque langue possède sa propre copie des images.
Les catégories et les termes d’attribut sont inclus dans les lignes de produits, cet importateur ne nécessite donc pas d’importation de taxonomie séparée. Si des termes d’attribut traduits existent déjà dans la boutique, l’importateur les utilise, et Run WPML Import les connecte à leurs originaux.
Pour que WPML traduise automatiquement les produits choisis alors que l’option Produits est définie sur Aucun :
Laissez Tout traduire activé.
Ajoutez la colonne Meta: _wpml_import_tea au fichier, avec la valeur 1 sur chaque produit à traduire.
Conservez Meta: _wpml_import_translation_group dans le même fichier.
Importez le fichier, puis accédez à WPML → Exportation et importation WPML et cliquez sur Run WPML Import. La liste de progression affiche « Sending Posts for Automatic Translation », et WPML traduit et publie ces produits.
Processus B avec WP All Import
Vous avez besoin de WP All Import Pro et de son module complémentaire WooCommerce. L’édition gratuite n’importe pas les champs personnalisés, et les colonnes WPML sont des champs personnalisés.
L’ordre de travail est le suivant : les termes d’attribut d’abord, avec leurs traductions connectées, puis les produits. Les pages de produits traduites proposent alors chaque valeur d’attribut dans leur propre langue, par exemple Bleu marine et non Navy.
Connectez les termes traduits que la boutique possède déjà. Pour chaque terme d’attribut traduit qui existe déjà dans la boutique, accédez à Produits → Attributs, cliquez sur Configurer les termes pour l’attribut, basculez la barre d’administration vers la langue du terme et cliquez sur le nom du terme. Dans la boîte Langue, choisissez son original sous Est une traduction de et cliquez sur Mettre à jour. Chaque terme connecté affiche alors un crayon sous sa langue dans WPML → Traductions → Taxonomie.
Définissez la langue de l’interface d’administration sur la langue par défaut de la boutique dans le sélecteur de langue de la barre d’administration avant de lancer les importations.
Importez les catégories.All Import → New Import → Upload a file, choisissez Taxonomies → Catégories de produits. Sous Métadonnée de terme, ajoutez trois lignes : _wpml_import_language_code, _wpml_import_source_language_code et _wpml_import_translation_group, chacune mappée à la colonne du fichier du même nom. Définissez le parent sous Other Category Options → Parent Term.
Importez les termes d’attribut de la même manière, par exemple Taxonomies → Product Color, avec les trois mêmes lignes de Métadonnée de terme.
Connectez les termes. Accédez à WPML → Exportation et importation WPML et cliquez sur Run WPML Import. Vérifiez sous WPML → Traductions → Taxonomie (choisissez la taxonomie dans « Sélectionnez la taxonomie à traduire ») que chaque terme possède une ligne avec un crayon sous le drapeau de chaque langue. Survolez un crayon pour voir le nom traduit. Un « + » signifie que cette langue n’a pas de traduction. Un terme traduit listé dans sa propre ligne n’est pas connecté.
Importez les produits. Choisissez Produits WooCommerce. Dans la section WooCommerce Add-On, mappez le SKU, les prix, le stock et les attributs. Sous Champs personnalisés, ajoutez les trois lignes _wpml_import_*.
Cliquez à nouveau sur Run WPML Import, et attendez Multilingual Import Complete.
Deux paramètres pour un fichier de produits qui contient toutes les langues :
Les lignes de variation portent le type variable, le même que leur parent, dans la colonne que vous mappez sur Set Product Type With XPath.
Liez les variations à leur parent avec une clé par langue. Sous Variations, choisissez All my variable products have SKUs or some other unique identifier... et mappez SKU element for parent et Parent SKU element for variation sur une clé telle que HP-OW-RAIN-de. Mappez le vrai SKU, le même dans chaque langue, sur General → SKU et au groupe de traduction. L’autre méthode consiste à effectuer une importation par fichier de langue.
Cet ordre fonctionne que vous lanciez les importations WP All Import depuis wp-admin, depuis WP-CLI ou selon une planification.
Mettre à jour le stock et les prix selon une planification
Mettez à jour les produits originaux. WPML copie immédiatement le stock et les prix dans toutes les langues.
Avec l’importateur CSV de WooCommerce :
N’envoyez que les colonnes que vous modifiez. Une colonne avec une cellule vide écrit une valeur vide. Notre fichier d’exemple :
Ajoutez Meta: _wpml_import_language_code avec la langue de l’original sur chaque ligne. Ainsi, chaque ligne met à jour le produit dans cette langue, l’original. Sans cette colonne, une ligne met à jour le produit dans la langue actuelle de l’interface d’administration, le résultat dépend donc du sélecteur de langue de l’interface d’administration.
Définissez la langue de l’interface d’administration sur la langue par défaut de la boutique dans le sélecteur de langue de la barre d’administration.
Accédez àProduits → Importer, choisissez le fichier, cochez Mettre à jour les produits existants, cliquez sur Continuer et Lancer l’importateur.
Juste après l’importation, chaque langue affiche le nouveau stock, les nouveaux prix et la nouvelle fourchette de prix.
Avec WP All Import, selon une planification :
All Import → New Import → Download a file → From URL, avec l’URL du flux de votre fournisseur. Choisissez WooCommerce Products.
Mappez les champs SKU, Regular Price et Stock Qty dans la section WooCommerce Add-On.
Dans Import Settings, cochez Attempt to match to existing WooCommerce products before creating new ones et faites correspondre par Custom field (champ personnalisé) _sku. Désactivez Create new WooCommerce products from records newly present in this import file. Activez Update existing WooCommerce products with the data in this import file.
Sous Choose which data to update, désactivez tout sauf Custom Fields, et choisissez Update only these Custom Fields, leave the rest alone : _regular_price, _price, _stock, _manage_stock.
Planifiez-la. Sous All Import → Manage Imports → Scheduling Options, l’option Manual Scheduling affiche une Trigger URL (URL de déclenchement) et une Processing URL (URL de traitement) pour la tâche cron de votre serveur.
Chaque exécution fait correspondre les lignes aux produits d’origine, et chaque langue obtient les nouveaux prix et le nouveau stock de chaque produit et variation.
Si un fichier complet du Processus B est à nouveau importé en tant que mise à jour, définissez Published sur 1 sur chaque ligne. Sinon, les produits en ligne passent à l’état Brouillon jusqu’à l’exécution de Exécuter l’importation WPML. Cochez Mettre à jour les produits existants, puis cliquez sur Exécuter l’importation WPML. Les produits restent publiés, et les textes du fichier remplacent immédiatement les traductions.
Ajoutez une langue à un catalogue que vous possédez déjà
Processus A :
Accédez àWPML → Langues, cliquez sur Gérer et masquer les langues du site, utilisez Rechercher et ajouter une langue… et choisissez la langue.
Cliquez sur Calculer les coûts. La boîte de dialogue « Coût pour traduire votre contenu en... » liste les éléments et les mots. Cliquez sur Enregistrer.
Tout traduire démarre la nouvelle langue de manière autonome, la prochaine fois qu’une page d’administration de WPML se charge. WPML traduit et publie chaque produit et variation dans la nouvelle langue. Vos langues existantes ne sont pas modifiées.
Processus B :
Préparez un fichier contenant uniquement les lignes de la nouvelle langue. Utilisez le SKU comme groupe de traduction, la langue d’origine comme langue source, Published = -1 et publish comme statut final.
Accédez àProduits → Importer. Laissez Mettre à jour les produits existants décoché. Exécutez l’outil d’importation.
Accédez àWPML → Exportation et importation WPML et cliquez sur Exécuter l’importation WPML.
Chaque nouveau produit et chaque nouvelle variation rejoint le groupe de traduction de son original, mis en correspondance par le SKU. Cela fonctionne sur n’importe quel catalogue, même un catalogue qui n’a jamais été importé. La nouvelle langue obtient ses propres catégories et termes d’attributs à partir du fichier.
Mettre à jour les produits existants n’ajoute pas de langue : l’outil d’importation ignore ces lignes. Il liste chaque produit dans la nouvelle langue avec « Aucun produit correspondant n’existe pour la mise à jour. » et chaque variation dans la nouvelle langue avec « Une nouvelle variation ne peut pas être créée sans produit parent. »
Importez de grands catalogues
Importez un fichier par langue, les originaux en premier.
Exécutez l’importation WPML une fois, après le dernier fichier.
Pour les exécutions longues, utilisez WP-CLI :wp wpml import process exécute la même étape que le bouton et affiche le décompte de chaque étape.
Combien de temps cela prend, d’après notre laboratoire, avec l’outil d’importation de WooCommerce et une exécution de Exécuter l’importation WPML pour un catalogue en trois langues :
Produits par langue
Importation complète
Dont Exécuter l’importation WPML
500
environ une demi-heure
quelques minutes
1 000
environ une heure
environ 10 minutes
2 000
environ deux heures
environ une demi-heure
Chaque taille s’est terminée en une seule session, avec chaque produit et variation présents et connectés dans chaque langue. Chaque chiffre correspond à une exécution sur un serveur de laboratoire partagé. La majeure partie du temps est imputable à l’outil d’importation de WooCommerce, et cela dépend de votre serveur. Considérez ces nombres comme un ordre de grandeur.
Exportez des produits avec leurs langues (WP All Export)
WP All Export ajoute par défaut les colonnes WPML _wpml_import_language_code, _wpml_import_source_language_code et _wpml_import_translation_group à une exportation de produits WooCommerce. Sa section WPML exporte toutes les langues ou une seule. Les exportations exécutées manuellement et celles planifiées remplissent toutes deux les colonnes. Pour en savoir plus, consultez Exporter des sites web multilingues à l’aide de WP All Export.
Synchronisez à partir d’un ERP ou d’un PIM
Un ERP (système de planification des ressources de l’entreprise) est le logiciel dans lequel une entreprise gère les stocks, les prix et les commandes. Un PIM (système de gestion des informations produit) est l’endroit où elle conserve les textes et les données des produits.
En général, un connecteur entre un tel système et WooCommerce :
Conserve le catalogue indexé par SKU, dans une seule langue
Trouve chaque produit par SKU (GET /wc/v3/products?sku=...)
Met à jour le stock et les prix des produits existants, et crée de nouveaux produits, via l’API REST de WooCommerce
S’exécute de manière planifiée
Voici le flux qui fonctionne avec WPML :
Le connecteur écrit uniquement dans la langue par défaut de la boutique.
WPML copie le stock et les prix dans toutes les langues lors de la même requête.
Tout traduire traduit les nouveaux produits dans toutes les langues (Processus A).
Un produit que le connecteur définit comme brouillon passe en brouillon dans toutes les langues.
Un produit que le connecteur supprime suit WPML → Paramètres → Suppression de contenu, ligne Produits. Aucune confirmation n’est demandée lors d’une synchronisation, définissez donc Lors de la suppression d’un original sur le comportement de votre choix : Supprimer toutes les langues supprime également les traductions ; Seulement celui-là les garde publiées.
Posez trois questions au fournisseur de votre connecteur :
Écrit-il via WooCommerce ou directement dans la base de données ? Les modifications écrites directement dans la base de données n’affectent que l’original. Les traductions conservent l’ancien stock et les anciens prix.
Dans quelle langue écrit-il ? Il doit écrire dans l’original. Un prix écrit dans une traduction n’est pas enregistré : la traduction conserve le prix de l’original.
Crée-t-il un produit par langue ? WooCommerce refuse un deuxième produit avec le même SKU. Sans le SKU, les copies sont des produits distincts qui ne reçoivent aucune mise à jour de stock ou de prix. Laissez le connecteur créer uniquement l’original, et laissez WPML le traduire.
Partie 3. Créer des flux personnalisés (développeurs)
Créer un produit et ses traductions avec l’API REST de WooCommerce
Créez d’abord les termes, puis l’original, et enfin chaque traduction avec lang et translation_of.
Traduisez la catégorie (et tous les termes d’attributs) : POST /wp-json/wc/v3/products/categories
Créez chaque traduction :POST /wp-json/wc/v3/products, avec les textes traduits, la catégorie traduite, lang et translation_of (l’ID de l’original). N’envoyez ni SKU, ni prix, ni stock : WPML les copie à partir de l’original.
Lisez le résultat avec un GET. La réponse à l’appel de création affiche le SKU, le prix et le stock vides, car WPML les copie après la création de la réponse. GET /wc/v3/products/121 juste après les affiche.
Pour un produit variable, créez les variations de l’original sur l’original uniquement (POST /wc/v3/products/<id>/variations/batch). Créez ensuite chaque parent traduit avec lang et translation_of. WPML crée lui-même les variations traduites, lie chacune à sa variation d’origine, et copie le SKU, le prix, le stock et les termes d’attributs dans cette langue. Ne publiez pas de variations sur une traduction.
Lisez les variations d’une traduction avec ?lang= :GET /wc/v3/products/137/variations?lang=fr. Chaque variation comporte lang, son mappage translations et les noms d’options dans cette langue.
Une traduction de produit par langue. Une deuxième traduction de produit dans une langue qui en possède déjà une est refusée avec l’erreur HTTP 400 wcml_translation_exists, et rien n’est créé. Le message indique l’ID de la traduction existante. Mettez plutôt à jour la traduction existante.
Mettre à jour des produits avec l’API REST de WooCommerce
Mettez à jour l’original. WPML copie la modification dans toutes les langues lors de la même requête.
PUT /wc/v3/products/123/variations/124 avec {"regular_price": "59.00", "stock_quantity": 3} modifie le prix et le stock de cette variation dans toutes les langues, et la fourchette de prix suit.
PUT /wc/v3/products/120 avec un nouveau prix régulier, prix promotionnel ou stock les modifie dans toutes les langues.
Les nouveaux termes d’attributs sont créés sur l’attribut de l’original et traduits avec lang et translation_of, comme à l’étape 1 ci-dessus.
Une nouvelle variation ajoutée à l’original (POST /wc/v3/products/123/variations ou .../variations/batch) atteint toutes les langues lors de la même requête, liée, avec son prix et son stock. La réponse à l’appel répertorie uniquement la langue de l’original ; GET /wc/v3/products/130/variations?lang=de juste après répertorie la nouvelle variation traduite.
Un prix ou des attributs envoyés à une traduction ne sont pas enregistrés : la traduction conserve les valeurs de l’original. Une valeur de stock envoyée à n’importe quelle langue devient le stock de toutes les langues.
Supprimer via l’API :DELETE /wc/v3/products/<id> suit WPML → Paramètres → Suppression de contenu, ligne Produits. L’API ne demande jamais de confirmation : sous Me demander, elle supprime uniquement l’original. Définissez Lors de la suppression d’un original sur le comportement souhaité pour votre boutique. Avec Supprimer toutes les langues, une suppression déplace toutes les langues vers la corbeille, et ?force=true supprime toutes les langues.
Écrire votre propre importateur ou connecteur
Utilisez les fonctions de produit de WooCommerce. WPML voit la modification et la copie dans toutes les langues.
Après save(), les traductions affichent le nouveau prix et le nouveau stock.
N’écrivez jamais les données de produit directement dans la base de données (update_post_meta() ou SQL). L’original est modifié, et les traductions conservent les anciennes valeurs.
Exécutez l’étape d’importation WPML à partir du code après une importation avec les colonnes WPML : wp wpml import process. Elle exécute les mêmes étapes que le bouton Run WPML Import et affiche chacune d’elles avec son décompte.
Tâches planifiées
Une tâche planifiée (WP-Cron) qui modifie l’original avec les fonctions de produit de WooCommerce reporte ces modifications dans chaque langue lors de la propre requête de la tâche :
Prix régulier, prix promotionnel et stock, avec l’état du stock qui en découle
Une catégorie ajoutée au produit (en tant que catégorie traduite)
Un nouveau terme d’attribut sur un produit variable (en tant que sa traduction)
La fourchette de prix du produit variable
Partie 4. Dépannage
Les traductions importées s’affichent comme des produits distincts et non liés
Ce que vous voyez : les lignes traduites sont manquantes, ou elles se présentent comme des produits en anglais (langue par défaut), souvent en Privé, sans aucun lien avec l’original.
Pourquoi cela se produit :
Le fichier ne contient aucune colonne WPML. WooCommerce ignore alors chaque ligne dont le SKU existe déjà : « A product with this SKU already exists. » (Un produit avec ce SKU existe déjà).
Le fichier contient les colonnes WPML, mais Run WPML Import n’a pas été exécuté. Jusque-là, chaque ligne est un produit dans la langue par défaut sans lien avec son original, avec le statut que la colonne Published du fichier lui donne (Privé pour 0, Brouillon pour -1). WPML → Exportation et importation affiche « Good job. We see 12 posts that are imported and need language information. » (Bon travail. Nous voyons 12 articles qui sont importés et qui nécessitent des informations de langue).
Comment le corriger maintenant :
L’étape d’importation WPML n’a pas été exécutée : accédez à WPML → Exportation et importation et cliquez sur Run WPML Import.
Aucune colonne WPML : ajoutez les quatre colonnes WPML aux lignes de traduction et importez-les à nouveau en tant que nouvelle importation, en décochant Mettre à jour les produits existants. Cliquez ensuite sur Run WPML Import. Chaque traduction rejoint son original par SKU.
Comment l’éviter : incluez toujours les colonnes WPML et exécutez Run WPML Import après chaque importation.
Les traductions importées sont remplacées par le texte de l’original
Ce que vous voyez : vous avez importé des noms et des descriptions traduits, et après le prochain enregistrement de l’original, ils sont de retour dans la langue d’origine.
Pourquoi cela se produit : les traductions étaient des duplicatas. WPML réécrit un duplicata à chaque enregistrement de son original.
Comment le corriger maintenant :
Rendez-les indépendantes. Accédez à Produits → Tous les produits, passez à la langue de la traduction, cochez les produits et choisissez Actions groupées → Traduire indépendamment.
Si Tout traduire est activé, réglez Produits sur Aucun. Dans WPML → Traductions, cliquez sur le menu à trois points dans la case « Tout traduire automatiquement est activé », choisissez Ajuster les limites de contenu, réglez Produits sur Aucun et cliquez sur Enregistrer les modifications.
Importez à nouveau vos traductions.
Ensuite, l’enregistrement de l’original conserve le texte importé.
Comment l’éviter : avant d’importer du texte dans des traductions existantes, réglez-les sur Traduire indépendamment. Ou importez les traductions en tant que nouveaux produits avec les colonnes WPML (Processus B).
Les produits traduits affichent les valeurs d’attribut dans la langue d’origine
Ce que vous voyez : la page du produit traduit propose « Blue », « Green » au lieu des termes traduits.
Pourquoi cela se produit : les produits ont été traduits avant la traduction de leurs termes d’attribut.
Comment y remédier maintenant :
Accédez àWPML → Traductions et ouvrez l’onglet Taxonomie.
Sous « Sélectionner la taxonomie à traduire », choisissez l’attribut, par exemple Couleur du produit.
Traduisez chaque terme dans chaque langue et cliquez sur Enregistrer. Traduisez le libellé de l’attribut sur le même écran.
Les produits traduits existants reprennent chaque terme au fur et à mesure que vous l’enregistrez. Aucun produit n’a besoin d’être enregistré à nouveau. Si un terme a d’abord été créé en tant que copie avec le nom de l’original, son slug conserve le texte de l’original ; modifiez-le dans la même boîte de dialogue.
Comment l’éviter : traduisez les termes d’attribut avant de traduire ou d’importer des produits.
Les catégories ou termes traduits conservent les noms de l’original après une importation
Ce que vous voyez : un produit traduit se trouve dans une catégorie appelée « Sunglasses » ou propose l’option « Blue » dans la boutique traduite.
Pourquoi cela se produit : les lignes de traduction ont été copiées à partir de l’exportation de l’original et ont conservé ses noms de catégorie, d’étiquette et de terme d’attribut. WPML crée des termes traduits avec ces noms et les relie correctement, mais il ne les renomme pas. Les ventes incitatives, les ventes croisées, les images, les galeries et les parents de variations donnés par les ID de l’original sont réaffectés à la bonne langue.
Comment y remédier maintenant : renommez les termes sous WPML → Traductions → Taxonomie, comme dans la section ci-dessus. Les fils d’Ariane, les liens de termes, les en-têtes d’archives et les options d’attributs affichent immédiatement les nouveaux noms, et aucun produit n’a besoin d’être enregistré à nouveau. Les slugs conservent le texte de l’original, à moins que vous ne les modifiiez dans la même boîte de dialogue.
Comment l’éviter : dans les lignes de traduction, écrivez les noms traduits des catégories, des étiquettes et des termes d’attributs, dans le même ordre que l’original. Indiquez les produits associés et les parents par SKU.
Le stock ou les prix dans les autres langues sont en retard par rapport à l’original
Ce que vous voyez : l’original affiche le nouveau stock ou le nouveau prix, et les traductions affichent l’ancien.
Pourquoi cela se produit : la modification a contourné WooCommerce ou WPML :
Un connecteur a écrit directement dans la base de données.
Une importation a été exécutée alors que WPML était désactivé.
Comment le savoir : ouvrez l’original dans l’éditeur de produit. Sous l’éditeur de description, il est indiqué « Dernière modification le » avec une date et une heure. Si cette heure est antérieure au nouveau prix ou stock dans la boîte Données produit, ou si la modification a été effectuée alors que WPML était inactif, la mise à jour a contourné la synchronisation.
Comment y remédier maintenant :
Pour les produits variables :
Accédez àWPML → Support → Corriger les traductions WCML. Corriger les traductions WCML fait partie de WPML Troubleshooting, une extension distincte.
Cochez Synchroniser les variations de produits et cliquez sur Exécuter les outils sélectionnés.
Chaque langue affiche alors les prix et le stock des variations de l’original, ainsi que la fourchette de prix du produit.
Pour les produits simples, utilisez l’une de ces méthodes. Chacune d’elles reporte le prix et le stock de l’original dans toutes les langues :
Un produit à la fois : ouvrez chaque original modifié et cliquez sur Mettre à jour.
Plusieurs produits par importation : la langue de l’interface d’administration étant définie sur la langue par défaut, importez à nouveau les produits avec Produits → Importer et l’option Mettre à jour les produits existants cochée. Le fichier peut contenir les valeurs que les originaux possèdent déjà. Cela réaligne également les produits variables.
Plusieurs produits par REST : envoyez PUT /wc/v3/products/<id> avec le prix pour chaque produit, par exemple {"regular_price": "19.50"}.
Plusieurs produits avec un seul prix : dans Produits → Tous les produits, cochez les produits, choisissez Actions groupées → Modifier et cliquez sur Appliquer. Sous Prix, choisissez Changer pour :, saisissez le prix et cliquez sur Mettre à jour. Chaque produit coché obtient ce prix unique.
L’exécution de wp wc product update avec la valeur que l’original possède déjà ne la reporte pas sur les traductions.
Comment l’éviter : laissez le connecteur écrire via WooCommerce (l’API REST ou les fonctions de produit), et gardez WPML actif pendant les importations.
Les produits créés via l’API REST se retrouvent dans la mauvaise langue ou le mauvais groupe
Ce que vous voyez : une traduction apparaît dans la mauvaise langue, ou comme un produit distinct sans SKU et sans lien vers l’original.
Pourquoi cela se produit :
Un code de langue inconnu est refusé avec l’erreur HTTP 422 Invalid language parameter: "ge", et rien n’est créé.
Un code valide mais incorrect, tel que du texte allemand envoyé avec "lang": "fr", crée une traduction dans cette langue.
Un translation_of manquant crée un produit dans son propre groupe, sans SKU et sans prix ni stock copiés.
Comment y remédier maintenant : envoyez à nouveau le produit avec la bonne langue et le lien, avec PUT /wc/v3/products/<id> :
JSON
{
"lang": "de",
"translation_of": 38
}
Le produit est déplacé dans le groupe de l’original et obtient son SKU, son prix et son stock. Pour un produit variable, WPML remplace les variations créées sans lien par de nouvelles variations liées. Relisez les nouveaux ID de variation.
Comment l’éviter : envoyez lang et translation_of sur chaque traduction, créez d’abord les termes, et laissez WPML créer les variations des traductions.
Les nouveaux produits importés ne sont pas traduits automatiquement
Ce que vous voyez : les produits importés restent uniquement dans la langue d’origine.
Pourquoi cela se produit : Tout traduire était désactivé pendant l’importation, ou les produits sont privés, ce que Tout traduire ne traduit jamais, ou ce sont des brouillons, qu’il ne traduit que lorsque l’option Traduire les brouillons automatiquement est activée et que le brouillon est enregistré à nouveau.
Comment y remédier maintenant :
Envoyez les produits : accédez à WPML → Traductions, ouvrez la section Produits, cochez les produits, choisissez Traduire automatiquement pour chaque langue, choisissez Publier sans révision sous « Que souhaitez-vous faire une fois que WPML aura terminé de traduire votre contenu automatiquement ? » et cliquez sur Traduire le contenu. Cela fonctionne également pour les brouillons et les produits privés ; leurs traductions obtiennent le statut de l’original.
Ou activez Tout traduire. Il traduit chaque produit publié qui n’a pas encore été traduit. WPML les envoie pendant le chargement des pages de l’interface d’administration de WPML.
Accédez àWPML → Traductions → Configurer Tout traduire → Continuer → Activer Tout traduire automatiquement.
Restez surWPML → Traductions jusqu’à ce qu’il soit indiqué « Traduction de votre contenu terminée ».
Comment l’éviter : activez Tout traduire avant l’importation (Processus A), et importez les produits en tant que produits publiés.
Rédigé parAmir·
Recherchez dans la documentation, le blog, les hooks et plus encore.