Mehrsprachige Inhalte in WordPress importieren – WooCommerce, CSV und XML

WPML-Export und -Import funktioniert zusammen mit dem WordPress-Import-Plugin, das Sie bereits verwenden. Das Import-Plugin verschiebt Ihre Daten. WPML-Export und -Import fügt am Ende die Sprachinformationen hinzu, sodass jede Zeile in der richtigen Sprache landet und jede Übersetzung mit ihrer Quelle verknüpft wird.

Bevor Sie starten

Installieren und aktivieren Sie diese Plugins auf der Website, in die Sie importieren:

Ein Import-Plugin: WP All Import Pro, WP All Export Pro, den nativen WooCommerce-CSV-Importer oder den Standard-WordPress-Importer.
WPML und WPML String-Übersetzung.
WPML-Export und -Import (das Add-on, das auf dieser Seite behandelt wird).
WPML Multilingual & Multicurrency for WooCommerce, wenn Sie WooCommerce-Produkte importieren.

Richten Sie WPML auf der Import-Website mit jeder Sprache ein, die Sie importieren möchten. Die Zielsprachen müssen bereits unter WPML → Einstellungen → Sprachen vorhanden sein, bevor Sie den Import ausführen.

Zwei Wege – Wählen Sie den aus, der zu Ihrer Quelle passt

Es gibt zwei Importwege, abhängig davon, woher die mehrsprachigen Daten stammen:

Unterstütztes Import-Plugin. Wenn Sie Inhalte mit WP All Export Pro (oder einem anderen unterstützten Export-Tool) aus einer bestehenden WordPress-Website verschieben, ist WPML-Export und -Import bereits in der Exportdatei enthalten – Sprachinformationen werden automatisch eingeschlossen. Springen Sie unten zum Schritt WPML-Import ausführen.
Benutzerdefinierte CSV oder XML. Wenn Sie mehrsprachige Daten in einer Tabelle pflegen oder Ihre Quelle ein Nicht-WordPress-System ist (PIM, MLS, ERP, Buchungsplattform), fügen Sie Ihrer Datei manuell drei Sprachspalten hinzu. Fahren Sie unten mit Bereiten Sie Ihre CSV oder XML vor fort.

Bereiten Sie Ihre CSV oder XML mit drei Sprachspalten vor

Fügen Sie für benutzerdefinierte Importe jeder Zeile Ihrer Tabelle drei Spalten hinzu. Auf diese Weise gruppiert WPML Übersetzungen und markiert jede Zeile mit der richtigen Sprache:

_wpml_import_translation_group. Ein eindeutiger Wert, der von allen Sprachversionen eines Inhalts geteilt wird. Verwenden Sie für Produkte die SKU. Generieren Sie für alles andere Ihre eigene ID und verwenden Sie diese für die Quellzeile und jede ihrer Übersetzungen wieder.
_wpml_import_language_code. Der ISO-Sprachcode für die Zeile (en für Englisch, es für Spanisch, fr für Französisch, pt-pt für europäisches Portugiesisch und so weiter).
_wpml_import_source_language_code. Nur in Übersetzungszeilen; der Sprachcode des Originals. Lassen Sie dies bei Zeilen in der Ausgangssprache leer.

Bereiten Sie für WP All Import Pro und ähnliche Tools zwei Tabellen vor: eine für Taxonomien (Kategorien, Schlagwörter, Produktkategorien), eine für Beiträge und Produkte. Der native WooCommerce-CSV-Importer benötigt eine einzige Tabelle, da Produktkategorien innerhalb der Produktzeilen existieren.

Benutzerdefinierte WooCommerce-Attribute für variable Produkte

Wenn Sie variable Produkte mit benutzerdefinierten Attributen haben, fügen Sie den übersetzten Produktzeilen eine vierte Spalte hinzu: _wpml_import_wc_local_attribute_labels. Der Wert ist ein JSON-Objekt aus slug:translation-Paaren. Für ein französisches variables Produkt mit den Attributen Size und Color:

{"size":"Taille","color":"Couleur"}

Der Slug ist der Attributname in Kleinbuchstaben, wobei Leerzeichen durch Bindestriche ersetzt werden.

Importreihenfolge

Importieren Sie Taxonomien immer zuerst, wenn Sie eine separate Datei dafür haben. Kategorien, Schlagwörter und alle anderen Taxonomien müssen vorhanden sein, bevor Beiträge und Produkte darauf verweisen können. Importieren Sie dann Beiträge, Seiten, Produkte und andere Inhaltstypen.

Wenn Sie Ihre Daten in eine Datei pro Sprache aufteilen, importieren Sie jede Sprachdatei, bevor Sie den WPML-Verknüpfungsschritt ausführen.

Ordnen Sie die Sprachspalten in Ihrem Import-Plugin zu

Jedes Import-Plugin verarbeitet benutzerdefinierte Spalten auf seine eigene Weise. Der entscheidende Schritt ist die Zuordnung der drei WPML-Spalten zu benutzerdefinierten Feldern (oder Begriff-Metadaten bei Taxonomien). In WP All Import Pro geschieht dies in Schritt 3 des Import-Assistenten:

Für Beiträge und Produkte. Öffnen Sie Benutzerdefinierte Felder, fügen Sie drei Felder hinzu, ziehen Sie die Sprachspalten in die Value-Felder und verwenden Sie die Spaltennamen ohne Klammern in den Name-Feldern.
Für Taxonomien. Öffnen Sie Begriff-Metadaten, fügen Sie drei Begriff-Metadaten-Felder hinzu und ordnen Sie die Sprachspalten auf die gleiche Weise zu.

Wenn die Spalten nicht zugeordnet sind, hat WPML nichts zum Lesen, wenn Sie den Verknüpfungsschritt ausführen.

Was Sie zwischen dem Import und dem Verknüpfungsschritt sehen

Bis Sie WPML-Export und -Import ausführen, befinden sich alle importierten Inhalte unter Ihrer Standardsprache, und WPML hält Beiträge und Produkte automatisch im Status Entwurf, um gemischtsprachige Inhalte vom Frontend fernzuhalten. Dies ist der erwartete Zwischenzustand und kein Zeichen für einen fehlgeschlagenen Import.

Bei nicht unterstützten Import-Plugins müssen Sie Beiträge manuell veröffentlichen, nachdem der Verknüpfungsschritt abgeschlossen ist.

WPML-Import ausführen

Sobald das Import-Plugin fertig ist:

Öffnen Sie WPML → Export und Import im WordPress-Admin-Bereich.
Klicken Sie auf WPML-Import ausführen.

WPML liest die Sprachspalten jeder Zeile, weist dieser Zeile die Sprache zu und verknüpft Übersetzungen mit ihrer Quelle. Bei großen Katalogen kann dies einige Minuten dauern. Wenn der Vorgang abgeschlossen ist, werden Ihre importierten Inhalte in der richtigen Sprache veröffentlicht und jede Übersetzung ist mit ihrer Quelle verbunden.

Führen Sie Stichproben im Backend und im Frontend durch:

Öffnen Sie die Liste der Beitragstypen oder Produkte – bestätigen Sie, dass jede Zeile unter der richtigen Sprachflagge angezeigt wird.
Besuchen Sie das Frontend und wechseln Sie die Sprachen – jede übersetzte Seite sollte ihre übersetzte Version laden und nicht auf die Ausgangssprache zurückgreifen.

Wenn eine Taxonomie-Übersetzung nicht verknüpft wurde, öffnen Sie den Begriff im WordPress-Admin-Bereich und verwenden Sie die Sprachen-Box des Begriffs, um ihn mit dem Begriff in der Standardsprache zu verbinden.

Automatisieren Sie es – Führen Sie den WPML-Import nach jedem geplanten Import aus

Für nächtliche Synchronisierungen, Lieferanten-Feeds oder jeden geplanten Import kann der WPML-Verknüpfungsschritt automatisch ausgeführt werden, direkt nachdem das Import-Plugin fertig ist. Es gibt drei Möglichkeiten, dies einzurichten:

Option 1 – POST-Endpunkt (für Cron-gesteuerte Importe wie WP All Import Scheduled Actions)

Dies ist der empfohlene Weg. Fügen Sie wp-config.php einen starken geheimen Schlüssel hinzu:

define( 'WPML_IMPORT_KEY', 'your-strong-secret-key-here' );

Fügen Sie dann Ihrem Setup für geplante Importe einen zweiten Befehl hinzu. Dieser sendet eine POST-Anfrage an Ihre Website und übergibt den Schlüssel im Anfragetext:

curl -X POST https://yoursite.com/ \
  -d 'wpml_import_trigger=your-strong-secret-key-here'

Der gleiche Aufruf mit wget:

wget -q -O - \
  --post-data='wpml_import_trigger=your-strong-secret-key-here' \
  https://yoursite.com/

Fügen Sie bei der manuellen Planung von WP All Import Pro einen der beiden Befehle direkt nach dem Importbefehl hinzu.

Wenn der Verknüpfungsschritt ausgeführt wird, antwortet Ihre Website mit dem Status 200 und dieser Nachricht:

Import process completed

Zwei andere Antworten sagen Ihnen, was passiert ist: 401 bedeutet, dass der Schlüssel nicht übereinstimmt, und 204 bedeutet, dass nichts mehr zu verarbeiten war.

Option 2 – URL-Endpunkt (Veraltet)

Vor WPML-Export und -Import 1.2.0 haben Sie den Schlüssel in der URL übergeben:

https://yoursite.com/?wpml_import_trigger=your-strong-secret-key-here

Diese URL funktioniert weiterhin, sodass Ihre aktuellen Cron-Jobs weiterlaufen. Sie ist jedoch veraltet und WPML wird sie in der nächsten Hauptversion entfernen.

Der Grund dafür ist der Schlüssel. Eine URL durchläuft Serverprotokolle, den Browserverlauf und Analysen, und Ihr Schlüssel wird dabei mit übertragen. Eine POST-Anfrage behält den Schlüssel im Anfragetext. Stellen Sie Ihre geplanten Importe auf den POST-Aufruf in Option 1 um.

Option 3 – Action-Hook (für PHP-geplante Importe)

Wenn Sie Importe aus PHP mit Action Scheduler oder wp_schedule_single_event planen, lösen Sie den WPML-Schritt mit einem Action-Aufruf aus:

do_action( 'wpml_import_process' );

Um ihn als einmalige Hintergrundaufgabe direkt nach Ihrer Importaktion auszuführen:

wp_schedule_single_event( time(), 'wpml_import_process' );

Wenn in einem dieser Wege etwas fehlschlägt, aktivieren Sie WP_DEBUG_LOG in wp-config.php, um den Fehler im PHP-Fehlerprotokoll zu erfassen.

Führen Sie den WPML-Import über die Befehlszeile aus

Für Bereitstellungsskripte, Container-Builds oder jede Pipeline, in der die Admin-Benutzeroberfläche nicht verfügbar ist, führen Sie den Verknüpfungsschritt über WP-CLI aus:

wp wpml import process

Der Befehl meldet, wie viele Übersetzungen verbunden wurden. Er ist ein direkter Ersatz für den Button WPML-Import ausführen.

Häufige Fallstricke

In der Importdatei fehlen die drei Sprachspalten. Inhalte werden importiert, landen aber als unmarkierte Zeilen in der Ausgangssprache; WPML-Import ausführen hat nichts zum Verknüpfen. Lösung: Fügen Sie die Spalten zu Ihren Quelldaten hinzu, exportieren Sie sie neu und importieren Sie sie erneut.
Die Zuordnung von Benutzerdefinierte Felder / Begriff-Metadaten in WP All Import wurde übersprungen. Gleiches Verhalten wie bei fehlenden Spalten. Die Daten befinden sich in der Datei, aber das Import-Plugin hat sie nicht im Beitrag gespeichert. Führen Sie den Import mit den zugeordneten Feldern erneut aus.
Zielsprachen sind auf der Import-Website nicht eingerichtet. Importierte Zeilen für eine nicht konfigurierte Sprache landen in der Standardsprache. Fügen Sie zuerst die fehlenden Sprachen unter WPML → Einstellungen → Sprachen hinzu und führen Sie den Import dann erneut aus.
Nicht unterstütztes Import-Plugin. Importierte Beiträge bleiben nach dem Verknüpfungsschritt im Entwurf. Veröffentlichen Sie sie manuell oder wechseln Sie zu einem unterstützten Plugin.
Benutzerdefinierte Importskripte, die keine Sprachdaten weitergeben. Die Lösung liegt auf Skriptebene. Die drei Sprachspalten (und die WooCommerce-Attributspalte, falls zutreffend) müssen die Zeile erreichen.

Wenn Importe immer wieder über dasselbe Problem stolpern, beantwortet das WPML-Support-Team Importfragen rund um die Uhr.

Wenn Sie nach dem Plugin WPML All Import gesucht haben

WPML All Import ist das alte Plugin, das vor WPML-Export und -Import existierte. Es wird nicht mehr unterstützt oder empfohlen. Das obige Verfahren ist der aktuelle Weg, um mehrsprachige Inhalte in eine WordPress-Website zu importieren – verwenden Sie es anstelle eines Workflows, der in der Dokumentation des alten Plugins beschrieben ist.