WPML

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.

Vous avez besoin de WPML, de WPML Multilingual & Multicurrency for WooCommerce et, pour les importations avec traductions, de Exportation et importation WPML.

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 :

  1. Activez d'abord le mode multidevise. Accédez à WPMLParamètresMultidevise, 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.
  2. 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é.
  3. 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é.
  4. 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.

DuplicataTraduction indépendante
Ce que c'estUne copie que WPML maintientUne traduction avec son propre texte
Texte après la prochaine sauvegarde de l'originalRemplacé par le texte de l'originalConservé uniquement si Tout traduire est désactivé ou si Produits est défini sur Aucun
Prix et stockSuivent l'originalSuivent l'original

Configurez la boutique avant l’arrivée du premier produit

  1. 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.
  2. 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 ProduitsAttributsModifier.
  3. Traduisez les termes d’attribut avant les produits. Accédez à WPMLTraductions, 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

Processus A : WPML traduitProcessus B : vous importez chaque langue
Ce que contient votre systèmeLa langue par défaut de la boutique uniquementToutes les langues
Ce que vous importezLes produits d’origineLes originaux et leurs traductions, liés par SKU
Qui traduitTout traduire, avec Private Translation Cloud (PTC) (s'ouvre dans un nouvel onglet)Vos traducteurs, avant l’importation
Lorsqu’un texte d’origine changeTout traduire traduit la modificationWPML marque la traduction comme nécessitant une mise à jour ; votre prochain fichier apporte le nouveau texte
Prix et stockSuivent l’originalSuivent 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 :

  1. Accédez à WPMLTraductions et cliquez sur Configurer Tout traduire.
  2. Choisissez le contenu. Sous « Contenu à traduire », conservez Tous les produits et cliquez sur Continuer.
  3. Choisissez comment les traductions sont publiées. Sous « Méthode de publication », conservez Publier sans révision.
  4. Cliquez sur Activer Tout traduire automatiquement.

Importez vos produits dans la langue par défaut de la boutique uniquement. Utilisez ProduitsImporter (l’outil d’importation CSV de WooCommerce) ou All ImportNew 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 WPMLTraductions.

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 WPMLParamètresTraduction 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 WPMLTraductions (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 :

  1. Accédez à WPMLTraductions. Si Tout traduire est désactivé, laissez-le désactivé et passez au fichier.
  2. 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.
  3. 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 :

ColonneCe qu’elle contientExemple
Meta: _wpml_import_translation_groupLa valeur qui lie les langues. Utilisez le SKU.HP-JK-SHELL
Meta: _wpml_import_language_codeLa langue de la lignede
Meta: _wpml_import_source_language_codeLa 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_statusLe statut une fois que WPML a lié les produitspublish

Une ligne en allemand d’un produit variable de notre fichier d’exemple :

Type,SKU,Name,Published,...,Categories,...,Parent,Attribute 1 name,Attribute 1 value(s),...,Meta: _wpml_import_translation_group,Meta: _wpml_import_language_code,Meta: _wpml_import_source_language_code,Meta: _wpml_import_after_process_post_status
variable,HP-JK-SHELL,Verstaubare Regenjacke,-1,...,Kleidung > Jacken,...,,Color,"Blau, Grün",...,HP-JK-SHELL,de,en,publish
variation,HP-JK-SHELL-BLU-S,,1,...,,...,HP-JK-SHELL,Color,Blau,...,HP-JK-SHELL-BLU-S,de,en,publish

Importez-le :

  1. Accédez à ProduitsImporter et choisissez le fichier sous « Choose a CSV file from your computer: ». Laissez Mettre à jour les produits existants décoché. Cliquez sur Continuer.
  2. Vérifiez le mappage. Les quatre colonnes Meta: correspondent à Importer en tant que métadonnées. Cliquez sur Lancer l’importateur.
  3. Accédez à WPMLExportation et importation WPML. L’écran affiche « Good job. We see 33 posts that are imported and need language information. » Cliquez sur Run WPML Import.
  4. Attendez que le message « Multilingual Import Completes’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 :

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 :

  1. Laissez Tout traduire activé.
  2. Ajoutez la colonne Meta: _wpml_import_tea au fichier, avec la valeur 1 sur chaque produit à traduire.
  3. Conservez Meta: _wpml_import_translation_group dans le même fichier.
  4. Importez le fichier, puis accédez à WPMLExportation 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.

  1. 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 à ProduitsAttributs, 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 WPMLTraductionsTaxonomie.
  2. 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.
  3. Importez les catégories. All ImportNew ImportUpload a file, choisissez TaxonomiesCaté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 OptionsParent Term.
  4. Importez les termes d’attribut de la même manière, par exemple TaxonomiesProduct Color, avec les trois mêmes lignes de Métadonnée de terme.
  5. Connectez les termes. Accédez à WPMLExportation et importation WPML et cliquez sur Run WPML Import. Vérifiez sous WPMLTraductionsTaxonomie (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é.
  6. 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_*.
  7. Cliquez à nouveau sur Run WPML Import, et attendez Multilingual Import Complete.

Notre fichier de termes d’exemple :

name,_wpml_import_language_code,_wpml_import_source_language_code,_wpml_import_translation_group
Navy,en,,color-navy
Marineblau,de,en,color-navy

Deux paramètres pour un fichier de produits qui contient toutes les langues :

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 :

  1. N’envoyez que les colonnes que vous modifiez. Une colonne avec une cellule vide écrit une valeur vide. Notre fichier d’exemple :
    SKU,Stock,Regular price,Meta: _wpml_import_language_code
    HP-JK-FIELD,11,95,en
    HP-JK-SHELL-BLU-S,5,72,en
  2. 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.
  3. 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.
  4. Accédez à ProduitsImporter, 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 :

  1. All ImportNew ImportDownload a fileFrom URL, avec l’URL du flux de votre fournisseur. Choisissez WooCommerce Products.
  2. Mappez les champs SKU, Regular Price et Stock Qty dans la section WooCommerce Add-On.
  3. 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.
  4. 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.
  5. Planifiez-la. Sous All ImportManage ImportsScheduling 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 :

  1. Accédez à WPMLLangues, cliquez sur Gérer et masquer les langues du site, utilisez Rechercher et ajouter une langue… et choisissez la langue.
  2. 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 :

  1. 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.
  2. Accédez à ProduitsImporter. Laissez Mettre à jour les produits existants décoché. Exécutez l’outil d’importation.
  3. Accédez à WPMLExportation 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

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 langueImportation complèteDont Exécuter l’importation WPML
500environ une demi-heurequelques minutes
1 000environ une heureenviron 10 minutes
2 000environ deux heuresenviron 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 :

Voici le flux qui fonctionne avec WPML :

  1. Le connecteur écrit uniquement dans la langue par défaut de la boutique.
  2. WPML copie le stock et les prix dans toutes les langues lors de la même requête.
  3. Tout traduire traduit les nouveaux produits dans toutes les langues (Processus A).
  4. Un produit que le connecteur définit comme brouillon passe en brouillon dans toutes les langues.
  5. Un produit que le connecteur supprime suit WPMLParamètresSuppression 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 :

  1. É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.
  2. 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.
  3. 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.

  1. Traduisez la catégorie (et tous les termes d’attributs) : POST /wp-json/wc/v3/products/categories
    JSON
    {
      "name": "Wohnen und Geschenke",
      "slug": "wohnen-und-geschenke",
      "lang": "de",
      "translation_of": 32
    }

    Pour les termes d’attributs, utilisez POST /wc/v3/products/attributes/<id>/terms/batch avec les mêmes deux champs sur chaque terme.

  2. Créez l’original : POST /wp-json/wc/v3/products
    JSON
    {
      "name": "Stoneware Coffee Mug",
      "type": "simple",
      "status": "publish",
      "sku": "HP-HG-MUG",
      "regular_price": "16.00",
      "manage_stock": true,
      "stock_quantity": 60,
      "categories": [ { "id": 32 } ],
      "lang": "en"
    }
  3. 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.
    JSON
    {
      "name": "Steingut-Kaffeebecher",
      "slug": "steingut-kaffeebecher",
      "status": "publish",
      "categories": [ { "id": 38 } ],
      "lang": "de",
      "translation_of": 120
    }
  4. 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.

Référence complète des champs : API REST de WooCommerce Multilingual.

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.

Supprimer via l’API : DELETE /wc/v3/products/<id> suit WPMLParamètresSuppression 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.

PHP
$id      = wc_get_product_id_by_sku( 'HP-HG-MUG' ); // returns the original
$product = wc_get_product( $id );
$product->set_regular_price( '19.00' );
$product->set_stock_quantity( 33 );
$product->save();

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 :

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 :

Comment le corriger maintenant :

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 :

  1. Rendez-les indépendantes. Accédez à ProduitsTous les produits, passez à la langue de la traduction, cochez les produits et choisissez Actions groupéesTraduire indépendamment.
  2. Si Tout traduire est activé, réglez Produits sur Aucun. Dans WPMLTraductions, 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.
  3. 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 :

  1. Accédez à WPMLTraductions et ouvrez l’onglet Taxonomie.
  2. Sous « Sélectionner la taxonomie à traduire », choisissez l’attribut, par exemple Couleur du produit.
  3. 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 WPMLTraductionsTaxonomie, 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 :

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 :

  1. Accédez à WPMLSupportCorriger les traductions WCML. Corriger les traductions WCML fait partie de WPML Troubleshooting, une extension distincte.
  2. 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 :

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 :

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 :

Comment l’éviter : activez Tout traduire avant l’importation (Processus A), et importez les produits en tant que produits publiés.

Rédigé parAmir