Von WordPress migrieren

Verwenden Sie die Migration, wenn Sie einen bestehenden WordPress-Blog haben und dessen Beiträge in eine Structura Headless-Website übertragen möchten – zum Beispiel, wenn Sie eine selbst gehostete WordPress-Installation abschalten und denselben Inhalt stattdessen über ein Next.js-, Astro- oder anderes Frontend ausliefern möchten.

Die Migration kopiert Ihre veröffentlichten Beiträge (optional auch Entwürfe) in die Headless-Website, rehostet alle Bilder in Structuras dauerhaften Speicher, damit nichts kaputtgeht, wenn die alte Website verschwindet, behält für jeden Beitrag den slug und die SEO-Metadaten bei und erstellt eine Redirect-Map, damit Suchmaschinen Ihre alten URLs zu den neuen weiterverfolgen.

Die Migration ist in jedem Tarif verfügbar, einschließlich Free – der Free-Tarif importiert bis zu Ihren neuesten 500 Beiträgen; kostenpflichtige Tarife sind unbegrenzt.

Vorbereitung

Sie benötigen:

Eine bereits erstellte Structura Headless-Website (dies ist das Ziel). Siehe Headless-Modus für den größeren Zusammenhang von Headless Publishing.
Die Adresse Ihrer alten WordPress-Website (z. B. https://old-blog.com).
Lassen Sie die alte WordPress-Website während der Migration online. Bilder werden während des Imports live von ihr kopiert – wenn sie bereits offline ist, können die Bilder nicht gespeichert werden.

Optional: Mit Zugangsdaten verbinden

Standardmäßig liest die Migration den öffentlichen Inhalt Ihrer Website – jeden veröffentlichten Beitrag sowie den SEO-Titel und die SEO-Beschreibung aus Yoast oder Rank Math. Das reicht für die meisten Umzüge aus.

Verbinden Sie sich mit einem Anwendungspasswort, wenn Sie auch Entwürfe und ausstehende Beiträge, benutzerdefinierte SEO-Felder oder Ihre vorhandenen Redirection-Plugin-Regeln übernehmen möchten. So erstellen Sie eines auf der alten Website:

Gehen Sie auf der alten WordPress-Website zu Nutzer → Profil → Anwendungspasswörter.
Geben Sie einen Namen ein (z. B. „Structura migration”) und klicken Sie auf Neues Anwendungspasswort hinzufügen.
Kopieren Sie das generierte Passwort und fügen Sie es zusammen mit Ihrem WordPress-Nutzernamen in die Erweitert-Option der Migration ein.

Das Anwendungspasswort wird nur für die Dauer der Migration verwendet und sofort nach Abschluss gelöscht. Sie können es anschließend auf der alten Website widerrufen.

Schritte

Öffnen Sie Ihre Headless-Website im Kundenportal und starten Sie Von WordPress migrieren.
Geben Sie Ihre alte WordPress-Adresse ein. Erweitern Sie optional Erweitert, um sich mit Nutzername und Anwendungspasswort zu verbinden.
Structura prüft die Verbindung und zeigt an, was gefunden wurde – wie viele Beiträge, welches SEO-Plugin und ein vorgeschlagenes URL-Muster, das Ihren alten permalinks entspricht. Passen Sie das Ziel-URL-Muster an, wenn die neuen URLs genau mit den alten übereinstimmen sollen.
Starten Sie die Migration. Eine Fortschrittsansicht zeigt, wie Beiträge und Bilder importiert werden. Sie können die Seite sicher verlassen und zurückkehren – die Migration läuft weiter und der Fortschritt wird dort wieder aufgenommen, wo er aufgehört hat.
Wenn der Vorgang abgeschlossen ist, überprüfen Sie den Schritt Weiterleitungen und laden Sie die Konfiguration für Ihr Frontend herunter (siehe unten).

Was als nächstes passiert

Importierte Beiträge erscheinen in der Beitragsliste Ihrer Headless-Website. Beiträge, die auf WordPress veröffentlicht waren, sind veröffentlicht; Entwürfe landen zur Überprüfung, damit Sie sie zunächst prüfen können.
Jeder Beitrag behält seinen ursprünglichen slug, seinen SEO-Titel und die SEO-Beschreibung sowie sein Beitragsbild, und sein Inhalt ist im Structura Editor vollständig bearbeitbar.
Links innerhalb Ihrer Beiträge, die auf andere Beiträge Ihrer alten Website verwiesen haben, werden automatisch auf deren neue Adresse umgeleitet, sodass die migrierte Website auf sich selbst verlinkt. Der Import zeigt nach Abschluss die Anzahl der korrigierten Links an. Einige Links könnten noch auf Ihre alte Website verweisen – zum Beispiel Links auf Seiten, die keine Blogbeiträge sind, Beiträge, die Sie nicht übertragen haben, oder Beiträge jenseits des Limits des Free-Tarifs. Diese funktionieren weiterhin und können jederzeit aktualisiert werden.
Die Migration erstellt eine Redirect-Map von Ihren alten URLs zu den neuen. Wenden Sie sie auf dem Server an, der Ihre neue Website ausliefert, damit alte Links und Suchmaschinenergebnisse weiterhin funktionieren:
- Next.js / Vercel – fügen Sie die Regeln in Ihre next.config-Weiterleitungen oder vercel.json ein.
- Apache – fügen Sie die Regeln zu Ihrer .htaccess hinzu.
- nginx – fügen Sie die Regeln zu Ihrem Server-Block hinzu.
- CSV / JSON – eine portable Map für jedes andere Setup.

Sobald die neue Website live ist und die Weiterleitungen eingerichtet sind, können Sie den alten WordPress-Blog sicher abschalten.

Häufige Probleme

„Die Website konnte nicht erreicht werden.” Überprüfen Sie die Adresse (geben Sie https:// an) und ob die Website online ist. Websites hinter einem Passwortschutz, einer IP-Zulassungsliste oder einem „Demnächst verfügbar”-Plugin können nicht gelesen werden.

„Anmeldung fehlgeschlagen” mit Zugangsdaten. Der Nutzername oder das Anwendungspasswort ist falsch, oder Anwendungspasswörter sind auf der Quell-Website deaktiviert. Erstellen Sie das Anwendungspasswort neu und versuchen Sie es erneut – oder lassen Sie die Erweitert-Felder leer, um nur öffentliche Beiträge zu importieren.

Einige Bilder wurden nicht übertragen. Bilder werden live von der alten Website kopiert; wenn diese während der Migration offline gegangen ist oder ein Bild bereits ein defekter Link war, wird dieses Bild übersprungen und der Rest des Beitrags wird trotzdem importiert.

Free-Tarif hat bei 500 Beiträgen aufgehört. Der Free-Tarif importiert Ihre neuesten 500 Beiträge. Führen Sie ein Upgrade durch, um den Rest eines größeren Archivs zu importieren.