Einrichtung · Kapitel 7 von 11
Umstieg von einem anderen Plugin
Du hast schon ein Plugin für deine Fahrzeugbörse? Dann wechselst du in einer ruhigen Stunde. Alte Fahrzeuglinks nach dem Muster /fahrzeugarchiv/… leitet WPCarlo selbst weiter, andere Muster richtest du per Filter ein.
Ablauf
Plane etwa eine Stunde ein. Zwischen dem Abschalten des alten Plugins und dem Ende des ersten Syncs ist deine Fahrzeugliste leer.
Sichern Starte in deinem Sicherungs-Plugin oder beim Hoster eine Sicherung mit Datenbank, Plugins, Themes und Uploads, danach meldet das Werkzeug die Sicherung als fertig.
Screenshot folgt: umstieg-01-sicherung.pngSicherungs-Plugin mit fertiger Sicherung von heute, Datenbank, Plugins, Themes und Uploads enthalten Zugang abschreiben Öffne die Einstellungen deines alten Plugins, danach siehst du den mobile.de-Benutzernamen, den du dir zusammen mit dem Passwort sicher notierst.
Screenshot folgt: umstieg-02-alter-zugang.pngEinstellungen des alten Plugins mit dem Feld für den mobile.de-Benutzernamen, Passwort verdeckt, Testzugang Altes Plugin deaktivieren Klicke unter PluginsInstallierte Plugins beim alten Plugin auf „Deaktivieren“ und nicht auf „Löschen“, danach steht es als inaktiv in der Liste.
Screenshot folgt: umstieg-03-altes-plugin-deaktiviert.pngPlugins › Installierte Plugins, altes Fahrzeugbörsen-Plugin inaktiv, Link Aktivieren sichtbar WPCarlo einrichten Folge den Kapiteln Installation, Lizenz und mobile.de verbinden, danach steht dein Bestand unter WPCarlo › Fahrzeuge.
Screenshot folgt: umstieg-04-bestand-da.pngWPCarlo › Fahrzeuge nach dem ersten Sync, Liste mit Testfahrzeugen Alte Shortcodes ersetzen Öffne jede Seite, die noch einen Shortcode des alten Plugins enthält, ersetze ihn nach der Tabelle unten und klicke auf „Aktualisieren“, danach zeigt die Seite den Baustein von WPCarlo.
Screenshot folgt: umstieg-05-shortcode-ersetzt.pngSeite im Editor, an der Stelle des alten Shortcodes steht [carlo_archive], Knopf Aktualisieren Systemstatus prüfen Klicke im Menü auf WPCarlo und im Abschnitt „Systemstatus“ auf „Jetzt prüfen“, danach zeigt jede Zeile grün oder nennt, was noch fehlt, samt Link zur betroffenen Seite.
Screenshot folgt: umstieg-06-systemstatus.pngWPCarlo-Übersicht, Abschnitt Systemstatus nach Jetzt prüfen, alle Zeilen grün Alten Link testen Öffne einen alten Fahrzeuglink nach dem Muster
/fahrzeugarchiv/<marke>/<modell>/<name>-<id>/oder nach deinem eigenen Muster aus Für Agenturen, danach landest du auf der neuen Fahrzeugseite und nicht auf einer Fehlerseite.Screenshot folgt: umstieg-07-weiterleitung.pngBrowser mit neuer Fahrzeugseite eines Testfahrzeugs nach dem Aufruf einer alten Adresse unter /fahrzeugarchiv/
Shortcodes ersetzen
Die Namen der alten Shortcodes hängen vom Plugin ab. Ersetze sie nach ihrer Aufgabe:
| Baustein im alten Plugin | Ersatz in WPCarlo |
|---|---|
| Fahrzeugliste, Archiv | [carlo_archive] oder Block „Fahrzeug-Archiv“ |
| Suchmaske, Schnellsuche | [carlo_search] |
| Merkliste, geparkte Fahrzeuge | [carlo_merkliste] |
| Einzelansicht eines Fahrzeugs | nicht nötig, WPCarlo hat eine eigene Seite je Fahrzeug. Die alte Seite auf Entwurf setzen. |
Alte Adressen weiterleiten
Adressen nach dem Muster /fahrzeugarchiv/<marke>/<modell>/<name>-<id>/ leitet WPCarlo selbst per 301 auf die neue Fahrzeugseite um. Die Zahl am Ende ist die Inseratsnummer bei mobile.de. Ist ein Fahrzeug verkauft, führt die Weiterleitung zur Liste der Marke und des Modells oder zur Fahrzeugliste.
Andere alte Adressen, etwa /auto/12345, leitet WPCarlo nicht von selbst weiter. Sie liefern eine Fehlerseite, bis du ihr Muster wie unter „Für Agenturen“ beschrieben einrichtest. Prüfe deshalb vor dem Wechsel, wie die Fahrzeuglinks deines alten Plugins aussehen.
Für Agenturen
Soll die Fahrzeugliste unter dem alten Pfad bleiben, etwa /fahrzeugarchiv/ statt /fahrzeuge/, setzt du den Basispfad per Filter, am besten in einem Must-Use-Plugin:
add_filter( 'carlo/permalinks/base_slug', static fn () => 'fahrzeugarchiv' );Danach unter Einstellungen › Permalinks einmal „Änderungen speichern“ klicken. Andere alte Muster leitest du mit einem eigenen Ausdruck um:
add_filter( 'carlo/permalinks/legacy_patterns', function ( $patterns ) {
// alte Adresse /autos/<name>-<inseratsnummer>/
$patterns['#^/autos/[^/]+-(\d+)/?$#'] = static fn ( $m, $index ) =>
$index->canonicalUrlFor( (int) $m[1] );
return $patterns;
} );Rückweg
Bleibt die Fahrzeugliste leer oder kommen keine Anfragen an und du findest den Grund nicht schnell, gehst du zurück:
- WPCarlo unter Plugins › Installierte Plugins deaktivieren.
- Das alte Plugin wieder aktivieren.
- Unter Einstellungen › Permalinks einmal „Änderungen speichern“ klicken.
- Die alten Shortcodes wieder eintragen oder die Sicherung aus Schritt 1 einspielen.
Schreib uns danach, was passiert ist, siehe Fehler melden.