Halten Sie einen mehrsprachigen WooCommerce-Katalog synchron, wenn Produkte per CSV-Import, WP All Import, über die REST-API oder eine ERP-Synchronisierung eintreffen.
Aktualisiert: 16. November 2026
Dieser Leitfaden richtet sich an Shops, deren Katalog außerhalb von WordPress verwaltet wird: in einer Tabellenkalkulation, einem PIM, einem ERP oder einem Lieferanten-Feed. Produkte gelangen über einen Importer, die REST-API oder einen geplanten Job zu WooCommerce, und Sie öffnen den Produkt-Editor nur selten.
Teil 1. Wie ein von außen verwalteter mehrsprachiger Shop funktioniert
Ein Produkt pro Sprache, verknüpft durch eine Übersetzungsgruppe
Jede Sprache hat ihr eigenes WooCommerce-Produkt mit einer eigenen ID. WPML verknüpft die Sprachen in einer Übersetzungsgruppe. Das Original ist das Produkt in der Standardsprache Ihres Shops; die anderen Sprachen sind seine Übersetzungen.
In unserem Beispiel-Shop ist der Zip-Up Hoodie das Produkt 14 auf Englisch, 121 auf Deutsch und 122 auf Französisch. Jede REST-API-Antwort für eines dieser Produkte enthält dieselbe Zuordnung: "translations": {"de":"121","en":"14","fr":"122"}.
Die SKU ist in jeder Sprache gleich. Die Variationen eines variablen Produkts behalten ebenfalls dieselben Variations-SKUs.
Die SKU ist der Schlüssel für Ihr externes System. Die WooCommerce-eigene Suche, wc_get_product_id_by_sku(), gibt das Originalprodukt zurück, nicht eine Übersetzung.
Listen geben jeweils eine Sprache zurück.GET /wc/v3/products?sku=HP-HD-ZIP gibt nur die Standardsprache zurück. Fügen Sie &lang=de für eine Sprache oder &lang=all für alle Sprachen hinzu.
Was WPML in jede Sprache kopiert und was es übersetzt
Wenn sich das Originalprodukt ändert, sei es durch den Produkt-Editor, einen CSV-Import oder die REST-API, kopiert WPML diese Werte in jede Übersetzung:
Regulärer Preis und Angebotspreis
Lagerbestand und Lagerstatus
SKU, Gewicht und Abmessungen
Produktbild und Galerie (jede Sprache erhält eine eigene Kopie des Bildes)
Kategorien und Schlagwörter (als übersetzte Kategorie oder übersetztes Schlagwort)
Zusatzverkäufe (Upsells) und Querverkäufe (Cross-Sells) (die auf das Produkt in derselben Sprache verweisen)
Veröffentlichungsstatus
Für variable Produkte: Preis und Lagerbestand jeder Variation, die Preisspanne, ein neuer globaler Attributbegriff (als dessen Übersetzung, zum Beispiel Schwarz und Noir für Black) und eine neue Variation
Diese bleiben in jeder Sprache unterschiedlich, da sie übersetzt werden:
Name, Beschreibung und Kurzbeschreibung
Slug (die Adresse des Produkts, zum Beispiel /de/produkt/kapuzenjacke-mit-reissverschluss/)
Attributbegriffe, wie Blue, Blau und Bleu
Werte von produktspezifischen Attributen, wie ein „Material“, das nur für dieses Produkt festgelegt wurde
Der Lagerbestand wird von allen Sprachen geteilt.
Schreiben Sie Preise und Attribute in das Original. Wenn Ihr System einen Preis oder Attribute in eine Übersetzung schreibt, behält die Übersetzung die Werte des Originals. Ein Lagerbestand, der in eine beliebige Sprache geschrieben wird, wird zum Lagerbestand aller Sprachen, da er geteilt wird.
Preise in einer zweiten Währung folgen ebenfalls dem Original (siehe Multicurrency für WooCommerce). Legen Sie diese im Original fest, mit custom_prices in der REST-API ("custom_prices": {"USD": {"regular_price": "55.00", "sale_price": "49.00"}}) oder mit den CSV-Spalten Meta: _wcml_custom_prices_status, Meta: _regular_price_USD, Meta: _sale_price_USD und Meta: _price_USD. Jede Sprache zeigt dann diese Preise in dieser Währung an.
custom_prices wird gespeichert, wenn Multicurrency aktiviert ist und die Währung eine der Währungen Ihres Shops ist. Senden Sie es wie folgt:
Aktivieren Sie zuerst Multicurrency. Gehen Sie zu WPML → Einstellungen → Multicurrency, markieren Sie Multicurrency-Modus aktivieren und klicken Sie auf Änderungen speichern. Wählen Sie unter Währungen anzeigen basierend auf eine Option (zum Beispiel Websitesprache) und klicken Sie auf Änderungen speichern. Fügen Sie dann jede Währung mit Währung hinzufügen hinzu. Wenn Multicurrency deaktiviert ist, speichert WPML nichts aus custom_prices.
Verwenden Sie die Währungscodes Ihres Shops. WPML speichert nur die Preise der Währungen des Shops. Ein Preis in einem anderen Code wird nicht gespeichert.
Senden Sie bei einem variablen Produkt custom_prices für jede Variation, nicht für das übergeordnete Produkt. WPML speichert es in der Originalvariation, und jede Sprache zeigt es an. Wenn es für das übergeordnete Produkt gesendet wird, wird es nicht gespeichert.
Lesen Sie die gespeicherten Preise aus meta_data (_regular_price_USD, _sale_price_USD, _price_USD). Die Antworten auf REST-Aufrufe enthalten kein custom_prices-Feld.
Duplikate oder unabhängige Übersetzungen
WPML verfügt über zwei Arten von übersetzten Produkten. Welche Sie haben, entscheidet darüber, was mit dem Text passiert, den Sie importieren.
Duplikat
Unabhängige Übersetzung
Was es ist
Eine Kopie, die WPML pflegt
Eine Übersetzung mit eigenem Text
Text nach dem nächsten Speichern des Originals
Wird durch den Text des Originals ersetzt
Wird nur beibehalten, wenn „Alles übersetzen“ deaktiviert ist oder Produkte auf Keine gesetzt ist
Preis und Lagerbestand
Folgen dem Original
Folgen dem Original
Wo Sie es sehen: In der Sprachen-Box eines Duplikats steht „Dieses Dokument ist ein Duplikat von ... und wird von WPML verwaltet.“ mit der Schaltfläche Unabhängig übersetzen.
Duplikate in unabhängige Übersetzungen umwandeln: Klicken Sie in der Sprachen-Box des Duplikats auf Unabhängig übersetzen, oder gehen Sie für viele Produkte zu Produkte → Alle Produkte, wechseln Sie zur Sprache der Übersetzung, markieren Sie die Produkte und wählen Sie Mehrfachaktionen → Unabhängig übersetzen.
Was die Prozesse in Teil 2 erstellen: Prozess A erstellt Übersetzungen mit Alles übersetzen. Prozess B importiert unabhängige Übersetzungen. Keiner von beiden benötigt Duplikate.
Richten Sie den Shop ein, bevor das erste Produkt eintrifft
Führen Sie den Setup Wizard von WooCommerce Multilingual aus. Er öffnet sich, wenn Sie WPML Multilingual & Multicurrency for WooCommerce aktivieren. Seine Bildschirme sind Shop-Seiten, Globale Eigenschaften und Mehrere Währungen. Der erste erstellt Shop, Warenkorb, Kasse und Mein Konto in jeder Sprache.
Machen Sie Ihre globalen Eigenschaften übersetzbar. Markieren Sie auf dem Bildschirm „Welche Produkteigenschaften sollen übersetzbar sein?“ des Setup Wizards jede Eigenschaft, zum Beispiel Farbe und Größe. Später finden Sie dieselbe Einstellung als Kontrollkästchen Übersetzbar? unter Produkte → Eigenschaften → Bearbeiten.
Übersetzen Sie die Eigenschaftsbegriffe vor den Produkten. Gehen Sie zu WPML → Übersetzungen, öffnen Sie den Tab Taxonomie, wählen Sie die Eigenschaft unter „Wählen Sie die zu übersetzende Taxonomie aus“ und übersetzen Sie jeden Begriff. Wenn Alles übersetzen aktiviert ist (Prozess A), übersetzt WPML neue Begriffe für Sie.
Teil 2. Ohne Code aufbauen
Wählen Sie Ihren Prozess: Eine Sprache oder alle Sprachen
Prozess A: WPML übersetzt
Prozess B: Sie importieren jede Sprache
Was Ihr System enthält
Nur die Standardsprache des Shops
Jede Sprache
Was Sie importieren
Originalprodukte
Originale und deren Übersetzungen, verknüpft durch die Artikelnummer
WPML markiert die Übersetzung so, dass sie ein Update benötigt; Ihre nächste Datei bringt den neuen Text
Preise und Lagerbestand
Folgen dem Original
Folgen dem Original
Prozess A eignet sich für einen Shop, der eine Sprache pflegt und jede andere Sprache ohne Übersetzungsdateien haben möchte. Prozess B eignet sich für einen Shop, dessen PIM oder Übersetzer die Texte bereits in jeder Sprache vorliegen haben.
Prozess A mit dem WooCommerce-CSV-Importer oder WP All Import
Schalten Sie Alles übersetzen einmal ein:
Gehen Sie zuWPML → Übersetzungen und klicken Sie auf Alles übersetzen einrichten.
Wählen Sie den Inhalt. Behalten Sie unter „Zu übersetzender Inhalt“ Alle Produkte bei und klicken Sie auf Weiter.
Wählen Sie, wie Übersetzungen veröffentlicht werden. Behalten Sie unter „Veröffentlichungsmethode“ Ohne Überprüfung veröffentlichen bei.
Klicken Sie auf Alles automatisch übersetzen aktivieren.
Importieren Sie Ihre Produkte nur in der Standardsprache des Shops. Verwenden Sie Produkte → Importieren (den CSV-Importer von WooCommerce) oder All Import → Neuer Import (WP All Import mit seinem WooCommerce-Add-on). Ihre Datei benötigt keine WPML-Spalten.
Der Import selbst reiht die Übersetzungen in die Warteschlange ein. WPML übersetzt dann jedes Produkt, jede Variante, jede Kategorie und jeden neuen Eigenschaftsbegriff in jede Sprache und veröffentlicht sie. Sie müssen nichts manuell starten und es muss keine WPML-Admin-Seite geöffnet sein. Sie können den Fortschritt unter WPML → Übersetzungen verfolgen.
Wenn Sie ein Original bearbeiten, übersetzt Alles übersetzen nur das, was sich geändert hat. Der Rest der Übersetzung bleibt Wort für Wort erhalten.
Alles übersetzen übersetzt veröffentlichte Produkte, einschließlich externer Produkte. Es übersetzt keine privaten Produkte. Entwürfe warten ebenfalls: Entwürfe automatisch übersetzen (unter WPML → Einstellungen → KI-Übersetzung, in der Box Erweiterter Übersetzungs-Editor) ist standardmäßig deaktiviert, und wenn Sie es aktivieren, übersetzt WPML einen Entwurf erst, wenn Sie ihn erneut speichern. Um Entwürfe und private Produkte zu übersetzen, senden Sie diese aus WPML → Übersetzungen (siehe Fehlerbehebung).
Wenn Sie eine Übersetzung ändern möchten, öffnen Sie sie über die Sprachen-Box des Produkts (Die ... Übersetzung bearbeiten), bearbeiten Sie sie im Erweiterten Übersetzungs-Editor und klicken Sie auf Speichern und abschließen. Wenn sich das Original später ändert, bleibt Ihre Bearbeitung der unveränderten Sätze erhalten.
Prozess B mit dem WooCommerce-CSV-Importer
In Prozess B enthält Ihre Datei jede Sprache.
Stellen Sie Alles übersetzen für importierte Übersetzungen vor dem ersten Import ein:
Gehen Sie zuWPML → Übersetzungen. Wenn Alles übersetzen deaktiviert ist, lassen Sie es deaktiviert und fahren Sie mit der Datei fort.
Wenn WPML Ihre Seiten, Beiträge und Strings automatisch übersetzen soll, klicken Sie auf Alles übersetzen einrichten. Setzen Sie unter „Zu übersetzender Inhalt“ Produkte auf Keine. Klicken Sie auf Weiter, behalten Sie Ohne Überprüfung veröffentlichen bei und klicken Sie auf Alles automatisch übersetzen aktivieren.
Wenn Alles übersetzen bereits aktiviert ist, klicken Sie auf das Drei-Punkte-Menü in der Box „Alles automatisch übersetzen ist aktiviert“, wählen Sie Inhaltslimits anpassen, setzen Sie Produkte auf Keine und klicken Sie auf Änderungen speichern. Bereits laufende Übersetzungen werden noch abgeschlossen.
Wenn Produkte auf Keine gesetzt sind, behält WPML Ihre importierten Produktübersetzungen Wort für Wort bei. Wenn sich ein Original ändert, markiert WPML dessen Übersetzungen so, dass sie ein Update benötigen, und Ihre nächste Datei bringt den neuen Text.
Bereiten Sie eine Datei mit allen Sprachen vor. Verwenden Sie die normalen Spalten von WooCommerce und fügen Sie vier WPML-Spalten hinzu:
Spalte
Was sie enthält
Beispiel
Meta: _wpml_import_translation_group
Der Wert, der die Sprachen verknüpft. Verwenden Sie die Artikelnummer.
HP-JK-SHELL
Meta: _wpml_import_language_code
Die Sprache der Zeile
de
Meta: _wpml_import_source_language_code
Die Sprache des Originals, welche die Standardsprache des Shops ist. In Originalzeilen leer.
en
Meta: _wpml_import_after_process_post_status
Der Status, nachdem WPML die Produkte verknüpft hat
publish
Ordnen Sie die Zeilen nach Sprache, Originale zuerst. In jeder Sprache kommen Produkte vor ihren Varianten.
Importieren Sie Produkte als Entwürfe:Published = -1 bei Produkten, 1 bei Varianten.
Geben Sie jeder Sprache ihre eigenen Texte: Namen, Beschreibungen, Kategorien (Kleidung > Jacken) und Eigenschaftswerte (Blau, Grün).
Behalten Sie die Eigenschaftsnamen des Shops (Color, Size) in jeder Sprache bei. Übersetzen Sie die Eigenschaftsbeschriftungen unter WPML → Übersetzungen → Taxonomie.
Geben Sie ähnliche Produkte und übergeordnete Produkte über die Artikelnummer an, dieselbe Artikelnummer in jeder Sprache.
Eine deutsche Zeile eines variablen Produkts aus unserer Beispieldatei:
Gehen Sie zuProdukte → Importieren und wählen Sie die Datei unter „Wählen Sie eine CSV-Datei von Ihrem Computer:“ aus. Lassen Sie Bestehende Produkte aktualisieren deaktiviert. Klicken Sie auf Weiter.
Überprüfen Sie die Zuordnung. Die vier Meta:-Spalten werden Als Metadaten importieren zugeordnet. Klicken Sie auf Importer ausführen.
Gehen Sie zuWPML → WPML-Export und -Import. Auf dem Bildschirm steht: „Gute Arbeit. Wir sehen 33 Beiträge, die importiert wurden und Sprachinformationen benötigen.“ Klicken Sie auf WPML-Import ausführen.
Warten Sie auf „Mehrsprachiger Import abgeschlossen“.
Bis zu Schritt 3 ist jedes Produkt ein englischer Entwurf und jede Variante eine englische Variante, und keines davon ist mit seinem Original verknüpft. Danach:
Jedes Produkt und jede Variante ist über die zugehörigen Sprachen hinweg verknüpft.
Alles ist veröffentlicht.
Die Übersetzungen sind unabhängige Übersetzungen.
Kategorien und Attribut-Begriffe sind sprachenübergreifend verknüpft, und die Varianten jeder Sprache verwenden ihre eigenen Begriffe.
Zusatzverkäufe (Upsells) verweisen auf das Produkt in derselben Sprache, und jede Sprache verfügt über eine eigene Kopie der Bilder.
Kategorien und Attribut-Begriffe werden innerhalb der Produktzeilen übertragen, sodass dieser Importer keinen separaten Taxonomie-Import benötigt. Wenn bereits übersetzte Attribut-Begriffe im Shop vorhanden sind, verwendet der Importer diese, und WPML-Import ausführen verknüpft sie mit ihren Originalen.
Damit WPML ausgewählte Produkte automatisch übersetzt, während Produkte auf Keine eingestellt ist:
Lassen Sie Alles übersetzen aktiviert.
Fügen Sie der Datei die Spalte Meta: _wpml_import_tea hinzu, mit dem Wert 1 für jedes zu übersetzende Produkt.
Behalten Sie Meta: _wpml_import_translation_group in derselben Datei bei.
Importieren Sie die Datei, gehen Sie dann zu WPML → WPML-Export und -Import und klicken Sie auf WPML-Import ausführen. Die Fortschrittsliste zeigt „Beiträge zur automatischen Übersetzung senden“ an, und WPML übersetzt und veröffentlicht diese Produkte.
Prozess B mit WP All Import
Sie benötigen WP All Import Pro und dessen WooCommerce-Add-on. Die kostenlose Version importiert keine benutzerdefinierten Felder, und die WPML-Spalten sind benutzerdefinierte Felder.
Die Arbeitsreihenfolge ist: Zuerst die Attribut-Begriffe, mit ihren verknüpften Übersetzungen, dann die Produkte. Übersetzte Produktseiten bieten dann jeden Attributwert in ihrer eigenen Sprache an, zum Beispiel Bleu marine und nicht Navy.
Verknüpfen Sie die übersetzten Begriffe, die der Shop bereits hat. Gehen Sie für jeden übersetzten Attribut-Begriff, der bereits im Shop existiert, zu Produkte → Eigenschaften, klicken Sie für das Attribut auf Begriffe konfigurieren, wechseln Sie in der Admin-Leiste zur Sprache des Begriffs und klicken Sie auf den Namen des Begriffs. Wählen Sie in der Sprachen-Box das Original unter Dies ist eine Übersetzung von aus und klicken Sie auf Aktualisieren. Jeder verknüpfte Begriff zeigt dann unter WPML → Übersetzungen → Taxonomie einen Bleistift unter seiner Sprache an.
Stellen Sie die Admin-Sprache auf die Standardsprache des Shops ein, und zwar im Sprachumschalter der Admin-Leiste, bevor Sie die Importe ausführen.
Importieren Sie die Kategorien. Gehen Sie zu All Import → Neuer Import → Datei hochladen und wählen Sie Taxonomien → Produktkategorien. Fügen Sie unter Begriff-Metadaten drei Zeilen hinzu: _wpml_import_language_code, _wpml_import_source_language_code und _wpml_import_translation_group, die jeweils der gleichnamigen Spalte der Datei zugeordnet sind. Legen Sie das übergeordnete Element unter Weitere Kategorie-Optionen → Übergeordneter Begriff fest.
Importieren Sie die Attribut-Begriffe auf die gleiche Weise, zum Beispiel Taxonomien → Produktfarbe, mit denselben drei Zeilen für Begriff-Metadaten.
Verknüpfen Sie die Begriffe. Gehen Sie zu WPML → WPML-Export und -Import und klicken Sie auf WPML-Import ausführen. Überprüfen Sie unter WPML → Übersetzungen → Taxonomie (wählen Sie die Taxonomie unter „Wählen Sie die zu übersetzende Taxonomie“), dass jeder Begriff eine Zeile mit einem Bleistift unter der Flagge der jeweiligen Sprache hat. Fahren Sie mit der Maus über einen Bleistift, um den übersetzten Namen zu sehen. Ein „+“ bedeutet, dass diese Sprache keine Übersetzung hat. Ein übersetzter Begriff, der in einer eigenen Zeile aufgeführt wird, ist nicht verknüpft.
Importieren Sie die Produkte. Wählen Sie WooCommerce-Produkte. Ordnen Sie im Bereich WooCommerce-Add-on die Artikelnummer (SKU), Preise, Lagerbestand und Eigenschaften zu. Fügen Sie unter Benutzerdefinierte Felder die drei _wpml_import_*-Zeilen hinzu.
Führen Sie WPML-Import ausführen erneut aus und warten Sie auf Mehrsprachiger Import abgeschlossen.
Zwei Einstellungen für eine Produktdatei, die jede Sprache enthält:
Varianten-Zeilen tragen den Typ variable, genau wie ihr übergeordnetes Element, in der Spalte, die Sie Produkttyp mit XPath festlegen zuordnen.
Verknüpfen Sie Varianten mit ihrem übergeordneten Element über einen pro Sprache eindeutigen Schlüssel. Wählen Sie unter Varianten die Option Alle meine variablen Produkte haben Artikelnummern (SKUs) oder eine andere eindeutige Kennung... aus und ordnen Sie SKU-Element für übergeordnetes Element und Übergeordnetes SKU-Element für Variante einem Schlüssel wie HP-OW-RAIN-de zu. Ordnen Sie die echte Artikelnummer (SKU), die in jeder Sprache gleich ist, Allgemein → Artikelnummer und der Übersetzungsgruppe zu. Der andere Weg ist ein Import pro Sprachdatei.
Diese Reihenfolge funktioniert unabhängig davon, ob Sie die WP All Import-Importe über wp-admin, über WP-CLI oder nach einem Zeitplan starten.
Lagerbestand und Preise nach Zeitplan aktualisieren
Aktualisieren Sie die Originalprodukte. WPML kopiert Lagerbestand und Preise sofort in jede Sprache.
Mit dem WooCommerce-CSV-Importer:
Senden Sie nur die Spalten, die Sie ändern. Eine Spalte mit einer leeren Zelle schreibt einen leeren Wert. Unsere Beispieldatei:
Fügen Sie Meta: _wpml_import_language_code mit der Sprache des Originals in jeder Zeile hinzu. Dann aktualisiert jede Zeile das Produkt in dieser Sprache, dem Original. Ohne diese Spalte aktualisiert eine Zeile das Produkt in der aktuellen Admin-Sprache, sodass das Ergebnis vom Sprachumschalter im Admin-Bereich abhängt.
Stellen Sie die Admin-Sprache auf die Standardsprache des Shops ein, und zwar im Sprachumschalter der Admin-Leiste.
Gehen Sie zuProdukte → Importieren, wählen Sie die Datei aus, aktivieren Sie Bestehende Produkte aktualisieren, klicken Sie auf Weiter und auf Importer ausführen.
Direkt nach dem Import zeigt jede Sprache den neuen Bestand, die Preise und die Preisspanne an.
Mit WP All Import, nach Zeitplan:
All Import → New Import → Download a file → From URL, mit der Feed-URL Ihres Lieferanten. Wählen Sie WooCommerce Products.
Ordnen Sie SKU, regulären Preis und Lagerbestand zu im Abschnitt des WooCommerce-Add-ons.
In den Import-Einstellungen markieren Sie Attempt to match to existing WooCommerce products before creating new ones und gleichen Sie nach dem Custom field_sku ab. Deaktivieren Sie Create new WooCommerce products from records newly present in this import file. Aktivieren Sie Update existing WooCommerce products with the data in this import file.
Unter Choose which data to update deaktivieren Sie alles außer Custom Fields und wählen Sie Update only these Custom Fields, leave the rest alone: _regular_price, _price, _stock, _manage_stock.
Planen Sie es. Unter All Import → Manage Imports → Scheduling Options zeigt Manual Scheduling eine Trigger-URL und eine Processing-URL für den Cronjob Ihres Servers an.
Jeder Durchlauf ordnet die Zeilen den Originalprodukten zu, und jede Sprache erhält die neuen Preise und den Bestand jedes Produkts und jeder Variante.
Wenn eine vollständige Datei für Prozess B erneut als Update importiert wird, setzen Sie Published in jeder Zeile auf 1. Andernfalls wechseln die Live-Produkte in den Status Entwurf, bis Sie den WPML-Import ausführen. Markieren Sie Vorhandene Produkte aktualisieren und klicken Sie dann auf WPML-Import ausführen. Die Produkte bleiben veröffentlicht, und die Texte in der Datei ersetzen die Übersetzungen sofort.
Eine Sprache zu einem bereits vorhandenen Katalog hinzufügen
Prozess A:
Gehen Sie zuWPML → Sprachen, klicken Sie auf Websitesprachen verwalten und verbergen, verwenden Sie Sprache suchen und hinzufügen … und wählen Sie die Sprache aus.
Klicken Sie auf Kosten berechnen. Der Dialog „Kosten für die Übersetzung Ihrer Inhalte ins ...“ listet die Elemente und Wörter auf. Klicken Sie auf Speichern.
Alles übersetzen startet die neue Sprache von selbst, wenn das nächste Mal eine WPML-Admin-Seite geladen wird. WPML übersetzt und veröffentlicht jedes Produkt und jede Variante in der neuen Sprache. Ihre bestehenden Sprachen bleiben unberührt.
Prozess B:
Bereiten Sie eine Datei vor, die nur die Zeilen der neuen Sprache enthält. Verwenden Sie die SKU als Übersetzungsgruppe, die Sprache des Originals als Ausgangssprache, Published = -1 und publish als finalen Status.
Gehen Sie zuProdukte → Importieren. Lassen Sie Vorhandene Produkte aktualisieren unmarkiert. Führen Sie den Importer aus.
Gehen Sie zuWPML → Export und Import und klicken Sie auf WPML-Import ausführen.
Jedes neue Produkt und jede Variante schließt sich der Übersetzungsgruppe des Originals an, abgeglichen anhand der SKU. Dies funktioniert bei jedem Katalog, auch bei einem, der noch nie importiert wurde. Die neue Sprache erhält ihre eigenen Kategorien und Attributbegriffe aus der Datei.
Vorhandene Produkte aktualisieren fügt keine Sprache hinzu: Der Importer überspringt diese Zeilen. Er listet jedes Produkt in der neuen Sprache mit „Es existiert kein passendes Produkt, das aktualisiert werden könnte.“ und jede Variante in der neuen Sprache mit „Eine neue Variante kann nicht ohne ein übergeordnetes Produkt erstellt werden.“ auf.
Große Kataloge importieren
Importieren Sie eine Datei pro Sprache, die Originale zuerst.
Führen Sie den WPML-Import einmal aus, nach der letzten Datei.
Verwenden Sie für lange Durchläufe WP-CLI:wp wpml import process führt denselben Schritt wie die Schaltfläche aus und zeigt die Anzahl für jeden Schritt an.
Wie lange es in unserem Labor mit dem WooCommerce-Importer und einem WPML-Import ausführen für einen Katalog in drei Sprachen dauert:
Produkte pro Sprache
Gesamter Import
Davon WPML-Import ausführen
500
etwa eine halbe Stunde
wenige Minuten
1.000
etwa eine Stunde
etwa 10 Minuten
2.000
etwa zwei Stunden
etwa eine halbe Stunde
Jede Größe wurde in einem Durchgang abgeschlossen, wobei jedes Produkt und jede Variante in jeder Sprache vorhanden und verbunden war. Jeder Wert entspricht einem Durchlauf auf einem geteilten Labor-Server. Die meiste Zeit beansprucht der WooCommerce-Importer, und dies hängt von Ihrem Server ab. Betrachten Sie diese Zahlen als Größenordnung.
Produkte mit ihren Sprachen exportieren (WP All Export)
WP All Export fügt einem Export von WooCommerce-Produkten standardmäßig die WPML-Spalten _wpml_import_language_code, _wpml_import_source_language_code und _wpml_import_translation_group hinzu. Der Abschnitt WPML exportiert alle Sprachen oder nur eine. Sowohl manuell ausgeführte als auch geplante Exporte füllen die Spalten. Lesen Sie mehr unter Mehrsprachige Websites mit WP All Export exportieren.
Synchronisierung aus einem ERP oder PIM
Ein ERP (Enterprise-Resource-Planning-System) ist die Software, in der ein Unternehmen Bestand, Preise und Bestellungen verwaltet. Ein PIM (Product-Information-Management-System) ist der Ort, an dem es Produkttexte und -daten speichert.
Ein Konnektor zwischen einem solchen System und WooCommerce führt typischerweise Folgendes aus:
Verwaltet den Katalog mit der SKU als Schlüssel in einer Sprache
Findet jedes Produkt anhand der SKU (GET /wc/v3/products?sku=...)
Aktualisiert den Lagerbestand und die Preise bestehender Produkte und erstellt neue Produkte über die WooCommerce REST API
Wird nach einem Zeitplan ausgeführt
Dies ist der Ablauf, der mit WPML funktioniert:
Der Konnektor schreibt nur in die Standardsprache des Shops.
WPML kopiert den Lagerbestand und die Preise in jede Sprache, und zwar in derselben Anfrage.
Alles übersetzen übersetzt neue Produkte in jede Sprache (Prozess A).
Ein Produkt, das der Konnektor auf Entwurf setzt, wird in jeder Sprache auf Entwurf gesetzt.
Ein Produkt, das der Konnektor löscht, folgt WPML → Einstellungen → Inhalte löschen, Zeile Produkte. Während einer Synchronisierung wird niemand gefragt, legen Sie also Löschen eines Originals auf das gewünschte Verhalten fest: Alle Sprachen löschen entfernt die Übersetzungen mit; Nur diese eine behält sie veröffentlicht.
Stellen Sie dem Anbieter Ihres Konnektors drei Fragen:
Schreibt er über WooCommerce oder direkt in die Datenbank? Änderungen, die direkt in die Datenbank geschrieben werden, erreichen nur das Original. Die Übersetzungen behalten den alten Lagerbestand und die alten Preise.
In welche Sprache schreibt er? Er muss in das Original schreiben. Ein Preis, der in eine Übersetzung geschrieben wird, wird nicht gespeichert: Die Übersetzung behält den Preis des Originals.
Erstellt er ein Produkt pro Sprache? WooCommerce lehnt ein zweites Produkt mit derselben SKU ab. Ohne die SKU sind die Kopien separate Produkte, die keine Aktualisierungen für Lagerbestand oder Preis erhalten. Lassen Sie den Konnektor nur das Original erstellen und lassen Sie WPML es übersetzen.
Teil 3. Benutzerdefinierte Abläufe erstellen (Entwickler)
Ein Produkt und seine Übersetzungen mit der WooCommerce REST API erstellen
Erstellen Sie zuerst die Begriffe, dann das Original und anschließend jede Übersetzung mit lang und translation_of.
Übersetzen Sie die Kategorie (und alle Attributbegriffe): POST /wp-json/wc/v3/products/categories
Erstellen Sie jede Übersetzung:POST /wp-json/wc/v3/products, mit den übersetzten Texten, der übersetzten Kategorie, lang und translation_of (der ID des Originals). Senden Sie keine SKU, keinen Preis oder Lagerbestand: WPML kopiert diese vom Original.
Lesen Sie das Ergebnis mit einem GET. Die Antwort auf den Erstellungsaufruf zeigt SKU, Preis und Lagerbestand als leer an, da WPML sie erst kopiert, nachdem die Antwort erstellt wurde. GET /wc/v3/products/121 direkt danach zeigt sie an.
Für ein variables Produkt erstellen Sie die Variationen des Originals nur auf dem Original (POST /wc/v3/products/<id>/variations/batch). Erstellen Sie dann jedes übersetzte übergeordnete Element mit lang und translation_of. WPML erstellt die übersetzten Variationen selbst, verknüpft jede mit ihrer Originalvariation und kopiert SKU, Preis, Lagerbestand und die Attributbegriffe in dieser Sprache. Posten Sie keine Variationen auf einer Übersetzung.
Lesen Sie die Variationen einer Übersetzung mit ?lang=:GET /wc/v3/products/137/variations?lang=fr. Jede Variation enthält lang, ihre translations-Zuordnung und die Optionsnamen in dieser Sprache.
Eine Produktübersetzung pro Sprache. Eine zweite Produktübersetzung in einer Sprache, die bereits eine hat, wird mit HTTP 400 wcml_translation_exists abgelehnt und es wird nichts erstellt. Die Nachricht nennt die ID der bestehenden Übersetzung. Aktualisieren Sie stattdessen die bestehende Übersetzung.
Produkte mit der WooCommerce REST API aktualisieren
Aktualisieren Sie das Original. WPML kopiert die Änderung in derselben Anfrage in jede Sprache.
PUT /wc/v3/products/123/variations/124 mit {"regular_price": "59.00", "stock_quantity": 3} ändert den Preis und Lagerbestand dieser Variation in jeder Sprache, und die Preisspanne folgt entsprechend.
PUT /wc/v3/products/120 mit einem neuen regulären Preis, Angebotspreis oder Lagerbestand ändert diese in jeder Sprache.
Neue Attributbegriffe werden im Attribut des Originals erstellt und mit lang und translation_of übersetzt, wie in Schritt 1 oben.
Eine neue Variation, die dem Original hinzugefügt wird (POST /wc/v3/products/123/variations oder .../variations/batch), erreicht jede Sprache in derselben Anfrage, verknüpft, mit ihrem Preis und Lagerbestand. Die Antwort auf den Aufruf listet nur die Sprache des Originals auf; GET /wc/v3/products/130/variations?lang=de direkt danach listet die neue übersetzte Variation auf.
Ein Preis oder Attribute, die an eine Übersetzung gesendet werden, werden nicht gespeichert: Die Übersetzung behält die Werte des Originals. Ein Lagerbestandswert, der an eine beliebige Sprache gesendet wird, wird zum Lagerbestand jeder Sprache.
Über die API löschen:DELETE /wc/v3/products/<id> folgt WPML → Einstellungen → Inhalte löschen, Zeile Produkte. Die API fragt niemals nach: Unter Mich fragen löscht sie nur das Original. Legen Sie Löschen eines Originals auf das Verhalten fest, das Ihr Shop wünscht. Mit Alle Sprachen löschen verschiebt ein Löschvorgang jede Sprache in den Papierkorb, und ?force=true löscht jede Sprache.
Einen eigenen Importer oder Konnektor schreiben
Verwenden Sie die Produktfunktionen von WooCommerce. WPML erkennt die Änderung und kopiert sie in jede Sprache.
Nach save() zeigen die Übersetzungen den neuen Preis und Lagerbestand an.
Schreiben Sie Produktdaten niemals direkt in die Datenbank (update_post_meta() oder SQL). Das Original ändert sich, und die Übersetzungen behalten die alten Werte.
Führen Sie den WPML-Importschritt aus dem Code aus, nachdem ein Import mit den WPML-Spalten erfolgt ist: wp wpml import process. Er führt dieselben Schritte aus wie die Schaltfläche WPML-Import ausführen und gibt jeden einzelnen mit seiner Anzahl aus.
Geplante Jobs
Ein geplanter Job (WP-Cron), der das Original mit den Produktfunktionen von WooCommerce ändert, überträgt diese Änderungen in der eigenen Anfrage des Jobs auf jede Sprache:
Regulärer Preis, Angebotspreis und Lagerbestand, mit dem daraus resultierenden Lagerbestandsstatus
Eine dem Produkt hinzugefügte Kategorie (als übersetzte Kategorie)
Ein neuer Attribut-Begriff bei einem variablen Produkt (als dessen Übersetzung)
Die Preisspanne des variablen Produkts
Teil 4. Fehlerbehebung
Importierte Übersetzungen werden als separate, nicht verknüpfte Produkte angezeigt
Was Sie sehen: Die übersetzten Zeilen fehlen oder sie sind als englische Produkte (Standardsprache) vorhanden, oft auf Privat gesetzt, ohne Verknüpfung zum Original.
Warum es passiert:
Die Datei hat keine WPML-Spalten. WooCommerce überspringt dann jede Zeile, deren Artikelnummer (SKU) bereits existiert: „Ein Produkt mit dieser Artikelnummer existiert bereits.“
Die Datei enthält die WPML-Spalten, aber WPML-Import ausführen wurde nicht ausgeführt. Bis dahin ist jede Zeile ein Produkt in der Standardsprache ohne Verknüpfung zu ihrem Original, mit dem Status, den die Spalte Published der Datei vorgibt (Privat für 0, Entwurf für -1). Unter WPML → WPML-Export und -Import wird angezeigt: „Gute Arbeit. Wir sehen 12 Beiträge, die importiert wurden und Sprachinformationen benötigen.“
Wie Sie es jetzt beheben:
Kein WPML-Importschritt ausgeführt: Gehen Sie zu WPML → WPML-Export und -Import und klicken Sie auf WPML-Import ausführen.
Keine WPML-Spalten: Fügen Sie den Übersetzungszeilen die vier WPML-Spalten hinzu und importieren Sie sie erneut als neuen Import, wobei das Häkchen bei Bestehende Produkte aktualisieren entfernt ist. Klicken Sie dann auf WPML-Import ausführen. Jede Übersetzung wird anhand der Artikelnummer (SKU) mit ihrem Original verknüpft.
Wie Sie es vermeiden: Fügen Sie immer die WPML-Spalten ein und führen Sie nach jedem Import WPML-Import ausführen aus.
Importierte Übersetzungen werden durch den Text des Originals ersetzt
Was Sie sehen: Sie haben übersetzte Namen und Beschreibungen importiert, und nach dem nächsten Speichern des Originals sind sie wieder in der Originalsprache.
Warum es passiert: Die Übersetzungen waren Duplikate. WPML überschreibt ein Duplikat bei jedem Speichern seines Originals.
Wie Sie es jetzt beheben:
Machen Sie sie unabhängig. Gehen Sie zu Produkte → Alle Produkte, wechseln Sie zur Sprache der Übersetzung, markieren Sie die Produkte und wählen Sie Mehrfachaktionen → Unabhängig übersetzen.
Wenn Alles übersetzen aktiviert ist, setzen Sie Produkte auf Keine. Klicken Sie unter WPML → Übersetzungen auf das Drei-Punkte-Menü im Feld „Alles automatisch übersetzen ist aktiviert“, wählen Sie Inhaltslimits anpassen, setzen Sie Produkte auf Keine und klicken Sie auf Änderungen speichern.
Importieren Sie Ihre Übersetzungen erneut.
Danach bleibt der importierte Text beim Speichern des Originals erhalten.
Wie Sie es vermeiden: Bevor Sie Text in bestehende Übersetzungen importieren, setzen Sie diese auf Unabhängig übersetzen. Oder importieren Sie Übersetzungen als neue Produkte mit den WPML-Spalten (Prozess B).
Übersetzte Produkte zeigen Attributwerte in der Originalsprache
Was Sie sehen: Die übersetzte Produktseite bietet „Blue“, „Green“ anstelle der übersetzten Begriffe.
Warum dies passiert: Die Produkte wurden übersetzt, bevor ihre Attribut-Begriffe übersetzt wurden.
So beheben Sie es jetzt:
Gehen Sie zuWPML → Übersetzungen und öffnen Sie den Tab Taxonomie.
Wählen Sie unter „Wählen Sie die zu übersetzende Taxonomie aus“ das Attribut, zum Beispiel Product Color.
Übersetzen Sie jeden Begriff in jede Sprache und klicken Sie auf Speichern. Übersetzen Sie die Beschriftung des Attributs auf demselben Bildschirm.
Bestehende übersetzte Produkte übernehmen jeden Begriff, sobald Sie ihn speichern. Kein Produkt muss erneut gespeichert werden. Wenn ein Begriff zuerst als Kopie mit dem Namen des Originals erstellt wurde, behält sein Slug den Text des Originals; ändern Sie ihn im selben Dialog.
So vermeiden Sie es: Übersetzen Sie Attribut-Begriffe, bevor Sie Produkte übersetzen oder importieren.
Übersetzte Kategorien oder Begriffe tragen nach einem Import die Namen des Originals
Was Sie sehen: Ein übersetztes Produkt befindet sich in einer Kategorie namens „Sunglasses“ oder bietet „Blue“ im übersetzten Shop an.
Warum dies passiert: Die Übersetzungszeilen wurden aus dem Export des Originals kopiert und haben dessen Kategorie-, Schlagwort- und Attribut-Begriffsnamen beibehalten. WPML erstellt übersetzte Begriffe mit diesen Namen und verlinkt sie korrekt, benennt sie aber nicht um. Upsells, Cross-Sells, Bilder, Galerien und übergeordnete Varianten, die durch die IDs des Originals angegeben sind, werden der richtigen Sprache neu zugeordnet.
So beheben Sie es jetzt: Benennen Sie die Begriffe unter WPML → Übersetzungen → Taxonomie um, wie im obigen Abschnitt beschrieben. Breadcrumbs, Begriffslinks, Archiv-Überschriften und Attributoptionen zeigen sofort die neuen Namen an, und kein Produkt muss erneut gespeichert werden. Die Slugs behalten den Text des Originals, es sei denn, Sie ändern sie im selben Dialog.
So vermeiden Sie es: Schreiben Sie in den Übersetzungszeilen übersetzte Kategorie-, Schlagwort- und Attribut-Begriffsnamen in derselben Reihenfolge wie im Original. Geben Sie verwandte und übergeordnete Produkte über die SKU an.
Lagerbestand oder Preise in anderen Sprachen hinken dem Original hinterher
Was Sie sehen: Das Original zeigt den neuen Lagerbestand oder Preis, und die Übersetzungen zeigen den alten.
Warum dies passiert: Die Änderung hat WooCommerce oder WPML umgangen:
Ein Connector hat direkt in die Datenbank geschrieben.
Ein Import lief, während WPML deaktiviert war.
Woran Sie es erkennen: Öffnen Sie das Original im Produkt-Editor. Unter dem Beschreibungs-Editor steht „Zuletzt bearbeitet am“ mit Datum und Uhrzeit. Wenn diese Zeit älter ist als der neue Preis oder Lagerbestand in der Box „Produktdaten“ oder die Änderung vorgenommen wurde, während WPML inaktiv war, hat das Update die Synchronisierung umgangen.
So beheben Sie es jetzt:
Für variable Produkte:
Gehen Sie zuWPML → Support → WCML-Übersetzungen korrigieren. Die Funktion „WCML-Übersetzungen korrigieren“ ist Teil von WPML Troubleshooting, einem separaten Plugin.
Setzen Sie ein Häkchen bei „Produkt-Variationen synchronisieren“ und klicken Sie auf Ausgewählte Tools ausführen.
Jede Sprache zeigt dann die Variationspreise und den Lagerbestand des Originals sowie die Preisspanne des Produkts an.
Für einfache Produkte verwenden Sie einen dieser Wege. Jeder davon überträgt den Preis und Lagerbestand des Originals auf jede Sprache:
Ein Produkt nach dem anderen: Öffnen Sie jedes geänderte Original und klicken Sie auf Aktualisieren.
Viele Produkte per Import: Importieren Sie die Produkte bei auf die Standardsprache eingestellter Admin-Sprache erneut über Produkte → Importieren und setzen Sie ein Häkchen bei Bestehende Produkte aktualisieren. Die Datei kann die Werte enthalten, die die Originale bereits haben. Dies richtet auch variable Produkte neu aus.
Viele Produkte per REST: Senden Sie PUT /wc/v3/products/<id> mit dem Preis für jedes Produkt, zum Beispiel {"regular_price": "19.50"}.
Viele Produkte mit einem Preis: Setzen Sie unter Produkte → Alle Produkte ein Häkchen bei den Produkten, wählen Sie Mehrfachaktionen → Bearbeiten und klicken Sie auf Übernehmen. Wählen Sie unter Preis die Option Ändern in:, geben Sie den Preis ein und klicken Sie auf Aktualisieren. Jedes markierte Produkt erhält diesen einen Preis.
Das Ausführen von wp wc product update mit dem Wert, den das Original bereits hat, überträgt diesen nicht auf die Übersetzungen.
So vermeiden Sie es: Lassen Sie den Connector über WooCommerce schreiben (die REST-API oder die Produktfunktionen) und halten Sie WPML während der Importe aktiv.
Über die REST-API erstellte Produkte landen in der falschen Sprache oder Gruppe
Was Sie sehen: Eine Übersetzung erscheint in der falschen Sprache oder als separates Produkt ohne SKU und ohne Link zum Original.
Warum dies passiert:
Ein unbekannter Sprachcode wird mit HTTP 422 Invalid language parameter: "ge" abgelehnt und es wird nichts erstellt.
Ein gültiger, aber falscher Code, wie zum Beispiel deutscher Text, der mit "lang": "fr" gesendet wird, erstellt eine Übersetzung in dieser Sprache.
Ein fehlendes translation_of erstellt ein Produkt in einer eigenen Gruppe, ohne SKU und ohne kopierten Preis oder Lagerbestand.
So beheben Sie es jetzt: Senden Sie das Produkt erneut mit der richtigen Sprache und dem Link, mit PUT /wc/v3/products/<id>:
JSON
{
"lang": "de",
"translation_of": 38
}
Das Produkt wird in die Gruppe des Originals verschoben und erhält dessen SKU, Preis und Lagerbestand. Bei einem variablen Produkt ersetzt WPML die ohne Link erstellten Variationen durch neue, verlinkte. Lesen Sie die neuen Variations-IDs wieder aus.
So vermeiden Sie es: Senden Sie lang und translation_of bei jeder Übersetzung, erstellen Sie zuerst die Begriffe und lassen Sie WPML die Variationen der Übersetzungen erstellen.
Neu importierte Produkte werden nicht automatisch übersetzt
Was Sie sehen: Importierte Produkte bleiben nur in der Originalsprache.
Warum dies passiert: „Alles übersetzen“ war während des Imports ausgeschaltet, oder die Produkte sind privat (diese werden von „Alles übersetzen“ nie übersetzt) oder Entwürfe (diese werden nur übersetzt, wenn Entwürfe automatisch übersetzen aktiviert ist und der Entwurf erneut gespeichert wird).
So beheben Sie es jetzt:
Senden Sie die Produkte: Gehen Sie zu WPML → Übersetzungen, öffnen Sie den Bereich Produkte, setzen Sie ein Häkchen bei den Produkten, wählen Sie für jede Sprache Automatisch übersetzen, wählen Sie unter „Was möchten Sie tun, wenn WPML die automatische Übersetzung Ihrer Inhalte abgeschlossen hat?“ die Option Ohne Überprüfung veröffentlichen und klicken Sie auf Inhalte übersetzen. Dies funktioniert auch für Entwürfe und private Produkte; ihre Übersetzungen erhalten den Status des Originals.
Oder aktivieren Sie „Alles übersetzen“. Es übersetzt jedes veröffentlichte, noch nicht übersetzte Produkt. WPML sendet sie, während die WPML-Admin-Seiten geladen werden.
Gehen Sie zuWPML → Übersetzungen → Alles übersetzen einrichten → Weiter → Alles automatisch übersetzen aktivieren.
Bleiben Sie aufWPML → Übersetzungen, bis dort „Übersetzung Ihrer Inhalte abgeschlossen“ steht.
So vermeiden Sie es: Aktivieren Sie „Alles übersetzen“ vor dem Import (Prozess A) und importieren Sie Produkte als veröffentlicht.
Geschrieben vonAmir·
Suchen Sie in der Dokumentation, im Blog, in Hooks und mehr.