WPML

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.

Sie benötigen WPML, WPML Multilingual & Multicurrency for WooCommerce und, für Importe mit Übersetzungen, WPML-Export und -Import.

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:

  1. Aktivieren Sie zuerst Multicurrency. Gehen Sie zu WPMLEinstellungenMulticurrency, 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.
  2. 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.
  3. 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.
  4. 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.

DuplikatUnabhängige Übersetzung
Was es istEine Kopie, die WPML pflegtEine Übersetzung mit eigenem Text
Text nach dem nächsten Speichern des OriginalsWird durch den Text des Originals ersetztWird nur beibehalten, wenn „Alles übersetzen“ deaktiviert ist oder Produkte auf Keine gesetzt ist
Preis und LagerbestandFolgen dem OriginalFolgen dem Original

Richten Sie den Shop ein, bevor das erste Produkt eintrifft

  1. 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.
  2. 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 ProdukteEigenschaftenBearbeiten.
  3. Ü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 übersetztProzess B: Sie importieren jede Sprache
Was Ihr System enthältNur die Standardsprache des ShopsJede Sprache
Was Sie importierenOriginalprodukteOriginale und deren Übersetzungen, verknüpft durch die Artikelnummer
Wer übersetztAlles übersetzen, mit der Private Translation Cloud (PTC) (wird in einem neuen Tab geöffnet)Ihre Übersetzer, vor dem Import
Wenn sich der Text eines Originals ändertAlles übersetzen übersetzt die ÄnderungWPML markiert die Übersetzung so, dass sie ein Update benötigt; Ihre nächste Datei bringt den neuen Text
Preise und LagerbestandFolgen dem OriginalFolgen 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:

  1. Gehen Sie zu WPMLÜbersetzungen und klicken Sie auf Alles übersetzen einrichten.
  2. Wählen Sie den Inhalt. Behalten Sie unter „Zu übersetzender Inhalt“ Alle Produkte bei und klicken Sie auf Weiter.
  3. Wählen Sie, wie Übersetzungen veröffentlicht werden. Behalten Sie unter „Veröffentlichungsmethode“ Ohne Überprüfung veröffentlichen bei.
  4. Klicken Sie auf Alles automatisch übersetzen aktivieren.

Importieren Sie Ihre Produkte nur in der Standardsprache des Shops. Verwenden Sie ProdukteImportieren (den CSV-Importer von WooCommerce) oder All ImportNeuer 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 WPMLEinstellungenKI-Ü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:

  1. Gehen Sie zu WPMLÜbersetzungen. Wenn Alles übersetzen deaktiviert ist, lassen Sie es deaktiviert und fahren Sie mit der Datei fort.
  2. 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.
  3. 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:

SpalteWas sie enthältBeispiel
Meta: _wpml_import_translation_groupDer Wert, der die Sprachen verknüpft. Verwenden Sie die Artikelnummer.HP-JK-SHELL
Meta: _wpml_import_language_codeDie Sprache der Zeilede
Meta: _wpml_import_source_language_codeDie Sprache des Originals, welche die Standardsprache des Shops ist. In Originalzeilen leer.en
Meta: _wpml_import_after_process_post_statusDer Status, nachdem WPML die Produkte verknüpft hatpublish

Eine deutsche Zeile eines variablen Produkts aus unserer Beispieldatei:

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

Importieren Sie sie:

  1. Gehen Sie zu ProdukteImportieren 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.
  2. Überprüfen Sie die Zuordnung. Die vier Meta:-Spalten werden Als Metadaten importieren zugeordnet. Klicken Sie auf Importer ausführen.
  3. Gehen Sie zu WPMLWPML-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.
  4. 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:

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:

  1. Lassen Sie Alles übersetzen aktiviert.
  2. Fügen Sie der Datei die Spalte Meta: _wpml_import_tea hinzu, mit dem Wert 1 für jedes zu übersetzende Produkt.
  3. Behalten Sie Meta: _wpml_import_translation_group in derselben Datei bei.
  4. Importieren Sie die Datei, gehen Sie dann zu WPMLWPML-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.

  1. 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 ProdukteEigenschaften, 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ÜbersetzungenTaxonomie einen Bleistift unter seiner Sprache an.
  2. Stellen Sie die Admin-Sprache auf die Standardsprache des Shops ein, und zwar im Sprachumschalter der Admin-Leiste, bevor Sie die Importe ausführen.
  3. Importieren Sie die Kategorien. Gehen Sie zu All ImportNeuer ImportDatei hochladen und wählen Sie TaxonomienProduktkategorien. 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.
  4. Importieren Sie die Attribut-Begriffe auf die gleiche Weise, zum Beispiel TaxonomienProduktfarbe, mit denselben drei Zeilen für Begriff-Metadaten.
  5. Verknüpfen Sie die Begriffe. Gehen Sie zu WPMLWPML-Export und -Import und klicken Sie auf WPML-Import ausführen. Überprüfen Sie unter WPMLÜbersetzungenTaxonomie (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.
  6. 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.
  7. Führen Sie WPML-Import ausführen erneut aus und warten Sie auf Mehrsprachiger Import abgeschlossen.

Unsere Beispiel-Begriffsdatei:

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

Zwei Einstellungen für eine Produktdatei, die jede Sprache enthält:

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:

  1. Senden Sie nur die Spalten, die Sie ändern. Eine Spalte mit einer leeren Zelle schreibt einen leeren Wert. Unsere Beispieldatei:
    SKU,Stock,Regular price,Meta: _wpml_import_language_code
    HP-JK-FIELD,11,95,en
    HP-JK-SHELL-BLU-S,5,72,en
  2. 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.
  3. Stellen Sie die Admin-Sprache auf die Standardsprache des Shops ein, und zwar im Sprachumschalter der Admin-Leiste.
  4. Gehen Sie zu ProdukteImportieren, 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:

  1. All ImportNew ImportDownload a fileFrom URL, mit der Feed-URL Ihres Lieferanten. Wählen Sie WooCommerce Products.
  2. Ordnen Sie SKU, regulären Preis und Lagerbestand zu im Abschnitt des WooCommerce-Add-ons.
  3. 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.
  4. 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.
  5. Planen Sie es. Unter All ImportManage ImportsScheduling 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:

  1. Gehen Sie zu WPMLSprachen, klicken Sie auf Websitesprachen verwalten und verbergen, verwenden Sie Sprache suchen und hinzufügen … und wählen Sie die Sprache aus.
  2. 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:

  1. 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.
  2. Gehen Sie zu ProdukteImportieren. Lassen Sie Vorhandene Produkte aktualisieren unmarkiert. Führen Sie den Importer aus.
  3. Gehen Sie zu WPMLExport 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

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 SpracheGesamter ImportDavon WPML-Import ausführen
500etwa eine halbe Stundewenige Minuten
1.000etwa eine Stundeetwa 10 Minuten
2.000etwa zwei Stundenetwa 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:

Dies ist der Ablauf, der mit WPML funktioniert:

  1. Der Konnektor schreibt nur in die Standardsprache des Shops.
  2. WPML kopiert den Lagerbestand und die Preise in jede Sprache, und zwar in derselben Anfrage.
  3. Alles übersetzen übersetzt neue Produkte in jede Sprache (Prozess A).
  4. Ein Produkt, das der Konnektor auf Entwurf setzt, wird in jeder Sprache auf Entwurf gesetzt.
  5. Ein Produkt, das der Konnektor löscht, folgt WPMLEinstellungenInhalte 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:

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

  1. Übersetzen Sie die Kategorie (und alle Attributbegriffe): POST /wp-json/wc/v3/products/categories
    JSON
    {
      "name": "Wohnen und Geschenke",
      "slug": "wohnen-und-geschenke",
      "lang": "de",
      "translation_of": 32
    }

    Verwenden Sie für Attributbegriffe POST /wc/v3/products/attributes/<id>/terms/batch mit denselben zwei Feldern für jeden Begriff.

  2. Erstellen Sie das 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. 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.
    JSON
    {
      "name": "Steingut-Kaffeebecher",
      "slug": "steingut-kaffeebecher",
      "status": "publish",
      "categories": [ { "id": 38 } ],
      "lang": "de",
      "translation_of": 120
    }
  4. 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.

Vollständige Feldreferenz: WooCommerce Multilingual REST API.

Produkte mit der WooCommerce REST API aktualisieren

Aktualisieren Sie das Original. WPML kopiert die Änderung in derselben Anfrage in jede Sprache.

Über die API löschen: DELETE /wc/v3/products/<id> folgt WPMLEinstellungenInhalte 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.

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();

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:

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:

Wie Sie es jetzt beheben:

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:

  1. Machen Sie sie unabhängig. Gehen Sie zu ProdukteAlle Produkte, wechseln Sie zur Sprache der Übersetzung, markieren Sie die Produkte und wählen Sie MehrfachaktionenUnabhängig übersetzen.
  2. 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.
  3. 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:

  1. Gehen Sie zu WPMLÜbersetzungen und öffnen Sie den Tab Taxonomie.
  2. Wählen Sie unter „Wählen Sie die zu übersetzende Taxonomie aus“ das Attribut, zum Beispiel Product Color.
  3. Ü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ÜbersetzungenTaxonomie 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:

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:

  1. Gehen Sie zu WPMLSupportWCML-Übersetzungen korrigieren. Die Funktion „WCML-Übersetzungen korrigieren“ ist Teil von WPML Troubleshooting, einem separaten Plugin.
  2. 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:

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:

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:

So vermeiden Sie es: Aktivieren Sie „Alles übersetzen“ vor dem Import (Prozess A) und importieren Sie Produkte als veröffentlicht.

Geschrieben vonAmir