Migration von Staging auf Live

Dieses Dokument erklärt, wie Sie die Konfiguration des ADP Car Market Hub-Plugins von einer Staging-WordPress-Website auf eine Produktions- (Live-) Website migrieren. Es beschreibt, welche Einstellungen aktualisiert werden müssen, welche transienten Daten gelöscht werden müssen, wie geplante Importe und Cronjobs neu konfiguriert werden und wie die Live-Website vor der Aktivierung automatisierter Importe validiert wird.

Wann dieses Dokument zu verwenden ist

Verwenden Sie dieses Dokument, wenn Sie:

• Eine vollständig konfigurierte und getestete Staging-Umgebung zum ersten Mal auf die Produktionsdomain übertragen.
• Eine Produktionsdatenbank auf Staging kopieren und wissen müssen, was auf Staging geändert werden muss, damit es die Live-Website nicht beeinträchtigt.
• Eine Servermigration oder einen Domainwechsel auf einer Website durchführen, auf der das Plugin bereits in der Produktion läuft.
• Die Übertragung von Konfigurationsänderungen (Design, Einstellungen, Mapping-Overrides), die auf Staging entwickelt wurden, koordinieren.

Die Zielgruppe ist ein WordPress-Administrator oder ein Agenturentwickler, der versteht, wie WordPress-Datenbanken und -Dateisysteme zwischen Umgebungen verschoben werden. Praktische Kenntnisse von wp-config.php und entweder SSH oder einem Hosting-Control-Panel sind hilfreich.

Übersicht

Das Plugin speichert seine gesamte Konfiguration als WordPress-Optionen in der Datenbank (Tabelle wp_options) und speichert importierte Fahrzeug-Beiträge, Leads, Analytics-Ereignisse und Suchabo-Anmeldungen in separaten Tabellen und Inhaltstypen (Post Types). Wenn eine Datenbank zwischen Umgebungen verschoben wird – zum Beispiel durch Kopieren der Staging-Datenbank auf die Produktion –, werden all diese Daten mitverschoben.

Eine kopierte Datenbank behält Werte bei, die für die Quellumgebung korrekt, aber für die Zielumgebung falsch oder unsicher sind. Die wichtigsten Beispiele sind:

• API-Zugangsdaten (Basis-URL, Seller IDs, Client ID, Client Secret). Auf Staging verwenden Sie möglicherweise eine Sandbox-API-Umgebung oder Test-Zugangsdaten mit geringerer Sicherheit. Die Live-Website benötigt die tatsächlichen Produktions-Zugangsdaten der Garage.
• Das Cron-Token. Das Token, das den REST-Cron-Endpunkt des Plugins authentifiziert, ist umgebungsspezifisch. Wenn Sie das Staging-Token auf der Live-Website verwenden (oder umgekehrt), ruft der Server-Cronjob die falsche URL auf oder verwendet das falsche Secret.
• Webhook-Ziel-URLs. Staging-Webhooks verweisen oft auf Test-Empfänger. Live-Webhooks müssen auf das produktive CRM oder den Benachrichtigungs-Endpunkt verweisen.
• Die WordPress-Website-URL. WordPress speichert seine eigene URL in den Optionen siteurl und home. Diese müssen mit der Live-Domain übereinstimmen, damit die REST-Endpunkt-URLs des Plugins und alle anderen absoluten URLs korrekt aufgelöst werden.
• Transiente Cache-Daten. Zwischengespeicherte OAuth-Access-Tokens, Import-Sperren (Run-Locks) und die Bildwarteschlange enthalten Staging-Status, die auf der Live-Website bedeutungslos oder schädlich sind.
• Geplante Cron-Ereignisse. WP-Cron-Ereignisse, die auf Staging geplant wurden, tragen auf Staging bezogene Zeitstempel und müssen auf der Live-Website neu geplant werden.

Jeder dieser Punkte wird im Folgenden Schritt für Schritt behandelt.

Voraussetzungen

Vor Beginn der Migration:

• Es existiert ein aktuelles, wiederherstellbares Backup sowohl der Staging-Datenbank als auch der Produktionsdatenbank. Migrieren Sie niemals ohne ein Backup des aktuellen Zustands jeder Website.
• Die produktive WordPress-Installation erfüllt die Anforderungen des Plugins. Siehe Technische Systemanforderungen.
• Sie haben Zugriff auf die Datei wp-config.php des Produktionsservers und auf die Cron-Einrichtung des Servers, falls Server-Cron verwendet wird.
• Sie kennen die produktiven API-Zugangsdaten (API-Basis-URL, Seller IDs, Client ID, Client Secret) und haben diese über einen sicheren Kanal erhalten. Siehe Einrichtung der API-Zugangsdaten.
• Wenn die Live-Website eine andere Domain als die Staging-Website verwendet, ist der Domainwechsel so vorbereitet, dass er gleichzeitig mit der Datenbankkopie auf die WordPress-URL-Optionen angewendet werden kann.

---

Schritt-für-Schritt-Anleitung

Arbeiten Sie diese Schritte der Reihe nach durch. Die Schritte 1 bis 5 sind Vorbereitungen auf der Staging-Umgebung, bevor die Datenbank kopiert wird. Die Schritte ab Nummer 6 gelten für die Live-Website, sobald die Datenbank oder das Plugin installiert ist.

Schritt 1 — Automatische Importe auf Staging vor der Migration deaktivieren

Wenn auf der Staging-Website automatische Importe aktiviert sind, deaktivieren Sie diese vor dem Kopieren der Datenbank. Dies verhindert eine Situation, in der beide Umgebungen denselben Planungsstatus teilen und beide versuchen, Importe zur gleichen Zeit auszuführen.

1. Öffnen Sie auf der Staging-Website Car Market Hub → Import & Limits.
2. Deaktivieren Sie den Schalter Automatischer Import und speichern Sie.
3. Wenn ein Server-Cronjob auf den REST-Endpunkt der Staging-Website verweist, deaktivieren oder entfernen Sie auch diesen Cronjob.

Schritt 2 — Backups erstellen

Bevor Sie Änderungen an einer der beiden Websites vornehmen:

1. Erstellen Sie ein Datenbank-Backup der Staging-Website.
2. Erstellen Sie ein Datenbank-Backup der Live-Website.
3. Wenn die Live-Website bereits importierte Fahrzeugdaten und hochgeladene Bilder enthält, erstellen Sie auch ein vollständiges Backup des Dateisystems von wp-content/uploads/.

Schritt 3 — Datenbank kopieren

Kopieren Sie die Staging-Datenbank mit Ihrer bevorzugten Methode auf den Live-Server (Export/Import über das Hosting-Control-Panel, WP-CLI db export / db import, SSH + mysqldump oder ein Plugin wie Duplicator oder All-in-One WP Migration). Das genaue Vorgehen hängt von Ihrer Hosting-Umgebung ab.

Wenn sich die Domains zwischen Staging und Live unterscheiden, führen Sie ein Suchen-und-Ersetzen aus, um alle Vorkommen der Staging-URL auf die Live-URL zu aktualisieren. Mit WP-CLI:

wp search-replace 'https://staging.example.com' 'https://www.example.com' --all-tables

Führen Sie diesen Befehl auf der Live-Datenbank aus, nicht auf der Staging-Datenbank. Erstellen Sie vor der Ausführung ein Backup.

Schritt 4 — Plugin-Dateien kopieren

Die Plugin-Dateien befinden sich in wp-content/plugins/adp-car-market-hub/. Wenn auf den Staging- und Live-Websites dieselbe Version des Plugins läuft, kann dieser Schritt übersprungen werden. Wenn sich die Versionen unterscheiden, kopieren Sie das Plugin-Verzeichnis von Staging auf Live (oder aktualisieren Sie vor der Migration auf beiden Websites über den WordPress-Adminbereich auf dieselbe Version).

Kopieren Sie nicht wp-config.php von Staging auf Live. Die beiden wp-config.php-Dateien enthalten unterschiedliche Datenbank-Zugangsdaten sowie umgebungsspezifische Konstanten und müssen unabhängig voneinander bleiben.

Schritt 5 — Theme-Overrides kopieren (falls zutreffend)

Wenn das Theme auf der Staging-Website Template-Override-Dateien für das Plugin enthält (zum Beispiel single-as24ci_car.php oder archive-as24ci_car.php im Theme-Verzeichnis), kopieren Sie diese Dateien an denselben Ort im Live-Theme. Weitere Details zu Template-Overrides finden Sie in der Anleitung für Template-Overrides.

Wenn keine Template-Overrides im Theme vorhanden sind, überspringen Sie diesen Schritt.

Schritt 6 — Live-API-Zugangsdaten aktualisieren

Nach dem Kopieren der Datenbank enthält die Live-Tabelle wp_options immer noch die Zugangsdaten, die auf Staging gespeichert waren. Ersetzen Sie diese durch die Live-Zugangsdaten.

1. Öffnen Sie auf der Live-Website Car Market Hub → Settings.
2. Tragen Sie im Bereich API Connection & General Settings die Live-Werte ein für: - API Base URL — die HTTPS-URL der Live-AutoScout24-Umgebung. - Seller ID — die Live-Seller ID(s) der Garage. Mehrere IDs werden durch Kommas getrennt. - Client ID — die Live-OAuth-Client-ID. - Client Secret — das Live-OAuth-Client-Secret. Das Feld Client Secret wird beim Öffnen der Einstellungsseite nicht vorausgefüllt; Sie müssen den Wert bei jeder Änderung neu eingeben.
3. Speichern Sie die Einstellungen.
4. Löschen Sie das zwischengespeicherte OAuth-Access-Token, falls eines aus der Staging-Sitzung existiert. Das Token wird als WordPress-Transient as24ci_access_token gespeichert. Sie können es unter Car Market Hub → Tools löschen (suchen Sie nach der Aktion Token-Cache leeren) oder indem Sie Folgendes ausführen: `` wp transient delete as24ci_access_token ``
5. Führen Sie den Verbindungstest unter Car Market Hub → Tools aus. Fahren Sie erst fort, wenn der Test erfolgreich war. Siehe Verbindungstest.

Schritt 7 — Webhook-URLs aktualisieren

Wenn Webhooks konfiguriert sind, verweist die Staging-Konfiguration möglicherweise auf einen Test-Empfänger:

1. Öffnen Sie Car Market Hub → Leads und suchen Sie den Bereich Webhooks.
2. Aktualisieren Sie die Webhook-URL für neue Leads und die Webhook-URL für neue Importe auf die Live-Empfänger-Endpunkte, oder löschen Sie sie, falls Webhooks in der Live-Umgebung nicht verwendet werden.
3. Aktualisieren Sie das Webhook-Secret, falls der Live-Empfänger einen anderen Secret-Wert verwendet. Siehe Webhook-Integration.

Schritt 8 — Verwaltete AI-Konfiguration bestätigen

Wenn der AI Assistant aktiviert ist:

1. Bestätigen Sie mit AD Promotion, dass die verwaltete Google Gemini-Konfiguration in AS24CI\Ai_Config für die Live-Umgebung bereitgestellt ist. Der Kunde gibt im WordPress-Backend keinen AI-Anbieter, kein Modell und keinen API-Key ein, und es wird kein AI-Key über die Datenbankkopie migriert.
2. Rufen Sie Car Market Hub → AI Assistant auf und bestätigen Sie, dass die Funktion als konfiguriert gemeldet wird.

Schritt 9 — Veraltete Transient-Daten löschen

Die migrierte Datenbank kann Transient-Werte aus der Staging-Umgebung enthalten, die nicht auf die Live-Umgebung übertragen werden dürfen:

1. Löschen Sie die Import-Sperre (Run-Lock), falls gesetzt. Dies verhindert, dass die Live-Website einen veralteten Status "Import bereits aktiv" von einem Staging-Durchlauf sieht: `` wp transient delete as24ci_cron_import_running ``
2. Löschen Sie die Sperre des Warteschlangen-Workers für Bilder, falls gesetzt: `` wp transient delete as24ci_image_queue_running ``
3. Löschen Sie optional die Bildwarteschlange selbst, falls die Staging-Bildwarteschlange Bild-Jobs der Staging-Umgebung enthält. Die Bildwarteschlange wird als WordPress-Option (as24ci_image_queue) und nicht als Transient gespeichert. Sie können sie unter Car Market Hub → System & Help → Bildwarteschlange leeren oder über die Befehlszeile löschen: `` wp option delete as24ci_image_queue wp option delete as24ci_image_queue_last_run ``
4. Entfernen Sie alle anderen zwischengespeicherten AI-Modelllisten aus früheren Staging-API-Aufrufen. Diese werden als Transients mit dem Präfix as24ci_ gespeichert. In WP-CLI können Sie diese mit wp transient list --search="as24ci_" überprüfen.

Schritt 10 — Cron-Token neu generieren

Das Cron-Token von Staging darf nicht in der Live-Umgebung verwendet werden. Ein anderes Token verhindert, dass Staging-Cronjobs versehentlich Live-Importe auslösen.

1. Öffnen Sie auf der Live-Website Car Market Hub → Import & Limits.
2. Klicken Sie im Bereich Automation auf Token neu generieren. Das Plugin generiert ein neues, zufälliges 32-stelliges Token und speichert es.
3. Notieren Sie sich das neue Token; Sie benötigen es in Schritt 11.

Wenn Sie den REST-Endpunkt mit dem Token in der URL verwenden, wird die neue Trigger-URL im selben Bereich angezeigt. Die alte URL gibt nach der Neugenerierung einen 403-Fehler zurück.

Schritt 11 — Live-Cron-Setup neu konfigurieren

Nach der Neugenerierung des Tokens ist jeder Server-Cronjob, der auf die Staging-URL verwies, ungültig. Konfigurieren Sie das Live-Cron-Setup neu:

1. Bei Verwendung des Server-Cron-Modus aktualisieren Sie die Server-Cronjobs mit der neuen Live-Trigger-URL. Das genaue Befehlsformat finden Sie unter Server-Cron-Setup.
2. Bei Verwendung des WP-Cron-Modus bestätigen Sie, dass die Konstante DISABLE_WP_CRON in wp-config.php entsprechend gesetzt ist: - Wenn die Live-Website Server-Cron verwendet, fügen Sie define( 'DISABLE_WP_CRON', true ); in wp-config.php hinzu oder bestätigen Sie dies. - Wenn die Live-Website auf WP-Cron basiert, entfernen oder kommentieren Sie DISABLE_WP_CRON aus wp-config.php aus, falls dies für Staging so eingestellt war.
3. Aktivieren Sie die automatischen Importe unter Car Market Hub → Import & Limits wieder, sobald alle Zugangsdaten und das Cron-Setup validiert wurden.

Schritt 12 — Standardseiten prüfen

Wenn das Plugin zum ersten Mal aktiviert wird, erstellt es zwei WordPress-Seiten (Fahrzeugarchiv und Fahrzeugvergleich) und speichert deren Beitrags-IDs in den Optionen as24ci_page_archive_id und as24ci_page_compare_id. Wenn die Live-Datenbank zuvor leer war, entsprechen die migrierten Seiten-IDs den auf Staging erstellten IDs und verweisen auf Staging-Beiträge. Nach dem Kopieren der Datenbank existieren diese Seiten zwar auf der Live-Website, aber ihre Slugs und Inhalte sollten überprüft werden.

1. Bestätigen Sie unter WordPress → Seiten, dass die Fahrzeugarchiv-Seite (Standard-Slug: cars) und die Fahrzeugvergleich-Seite existieren und veröffentlicht sind.
2. Rufen Sie beide Seiten im Frontend auf und bestätigen Sie, dass sie korrekt dargestellt werden.
3. Wenn die Seiten fehlen oder ihre IDs auf gelöschte Beiträge verweisen, deaktivieren Sie das Plugin und aktivieren Sie es erneut, um sie neu zu erstellen (bestätigen Sie vor der Reaktivierung, dass Standardseiten erstellen in Car Market Hub → Settings aktiviert ist).

Überprüfen Sie dieses Verhalten in der aktuellen Plugin-Version, bevor Sie sich darauf verlassen, da das Verhalten bei der Seitenerstellung variieren kann.

Schritt 13 — Permalink-Regeln neu generieren

Nach jeder Domainänderung oder Aktualisierung der WordPress-URL müssen die WordPress-Permalink-Regeln neu generiert werden, damit die URL des Fahrzeugarchivs und die URLs der Fahrzeugdetailseiten korrekt aufgelöst werden:

1. Öffnen Sie in WordPress Einstellungen → Permalinks.
2. Klicken Sie auf Änderungen speichern, ohne etwas zu ändern. Dadurch werden die .htaccess-Rewrite-Regeln neu generiert.
3. Rufen Sie die Fahrzeugarchiv-Seite und eine einzelne Fahrzeugseite auf, um zu bestätigen, dass sie ohne 404-Fehler geladen werden.

Schritt 14 — Live-Website validieren

Führen Sie nach der Migration die folgenden Validierungsprüfungen durch:

1. Verbindungstest. Öffnen Sie Car Market Hub → Tools und führen Sie den Verbindungstest aus. Bestätigen Sie, dass er mit der Live-API erfolgreich ist. Siehe Verbindungstest.
2. Registerkarte System & Help. Öffnen Sie Car Market Hub → System & Help und überprüfen Sie alle Diagnoseanzeigen. Beheben Sie alle roten oder gelben Badges.
3. Manueller Import. Stossen Sie einen manuellen Import über Car Market Hub → Import & Limits → Jetzt ausführen an. Bestätigen Sie, dass der Import ohne Fehler abgeschlossen wird.
4. Fahrzeugarchiv-Seite. Rufen Sie die URL des Fahrzeugarchivs auf und bestätigen Sie, dass die importierten Fahrzeuge mit korrekten Bildern, Preisen und Labels angezeigt werden.
5. Fahrzeugdetailseite. Klicken Sie sich zu einer Fahrzeugdetailseite durch und bestätigen Sie, dass das vollständige Detail-Layout, die Galerie und das Kontaktformular funktionieren.
6. Erster geplanter Import. Warten Sie nach dem Aktivieren des automatischen Zeitplans auf den ersten durch Cron ausgelösten Durchlauf und bestätigen Sie, dass die Registerkarte System & Help einen aktuellen Zeitstempel für den Letzten Import-Durchlauf anzeigt.
7. Logs. Öffnen Sie Car Market Hub → Logs und bestätigen Sie, dass beim ersten Live-Durchlauf keine Authentifizierungsfehler, API-Ausfälle oder andere unerwarteten Fehler aufgetreten sind.

Konfigurationsreferenz

Die folgenden Plugin-Optionsgruppen sind bei der Migration zwischen Umgebungen relevant. Alle werden als WordPress-Optionen gespeichert.

---

Betriebliche Hinweise

• Nur eine aktive Umgebung gleichzeitig. Deaktivieren Sie nach dem Verschieben von Staging auf Live die automatischen Importe und alle Server-Cronjobs auf der Staging-Website. Wenn beide Umgebungen mit denselben Produktions-API-Zugangsdaten verbunden sind und Importe gleichzeitig ausführen, kann dies zu unvorhersehbaren Ergebnissen führen. Verwenden Sie nach Möglichkeit separate API-Zugangsdaten pro Umgebung.
• Staging muss eigene Zugangsdaten verwenden. Nachdem die Datenbank auf Staging kopiert wurde, ersetzen Sie die API-Zugangsdaten auf Staging durch Sandbox- oder Staging-Umgebungswerte. Lassen Sie keine Produktions-Zugangsdaten auf einer Staging-Website. Siehe Externe API-Zugangsdaten.
• Vorsicht bei Vollständiger Synchronisierung. Die Option "Vollständige Synchronisierung" löscht lokale Fahrzeug-Beiträge, die in der API-Antwort nicht mehr vorhanden sind. Aktivieren Sie die Vollständige Synchronisierung auf der Live-Website erst, wenn mindestens ein vollständiger Importzyklus beobachtet und als korrekt bestätigt wurde. Eine Aktivierung vor dem ersten sauberen Import kann zu vorzeitigen Löschungen führen.
• Analytics- und Lead-Daten. Die Migration kopiert alle Analytics-Ereignisse und Lead-Beiträge von Staging nach Produktion. Dies sind synthetische oder Test-Datensätze und können die Berichterstattung verfälschen. Je nach den Anforderungen der Garage möchten Sie möglicherweise die auf Staging generierten Analytics-Daten aus der Produktionsdatenbank entfernen, bevor Sie echten Traffic zulassen. Die Analytics-Daten werden in der Datenbanktabelle {prefix}as24ci_analytics gespeichert. Vor dem Löschen überprüfen.
• Suchabo-Abonnements. Die Suchabo-Abonnements des Plugins (Name des Besuchers, E-Mail, Suchkriterien) werden in der Tabelle {prefix}as24ci_search_agents gespeichert. Staging-Testabonnements sollten aus der Produktionsdatenbank entfernt werden. Dies sind personenbezogene Daten und dürfen nicht ohne berechtigten Zweck aufbewahrt werden.
• Permalink-Struktur. Die Fahrzeug-Archiv-URL (Standard-Slug cars) und die URLs für einzelne Fahrzeuge (/cars/{slug}/) hängen davon ab, dass "schöne Permalinks" aktiviert sind. Bestätigen Sie nach der Migration, dass unter Einstellungen → Permalinks nicht der einfache Modus (Query-String) eingestellt ist.
• wp-config.php wird nicht migriert. Halten Sie wp-config.php-Dateien zwischen den Umgebungen unabhängig. Die Datenbank-Zugangsdaten, DISABLE_WP_CRON, WP_DEBUG und andere Umgebungskonstanten müssen der Konfiguration der Zielumgebung entsprechen.
• Protokollverzeichnis. Das Plugin schreibt Import- und Fehlerprotokolle nach wp-content/uploads/as24ci-logs/. Staging-Protokolldateien befinden sich nach einer vollständigen Dateisystem-Migration in diesem Verzeichnis. Die Protokolldaten sind auf der Produktion nicht schädlich, können aber verwirrend sein. Sie können Staging-Protokolldateien rotieren oder archivieren, bevor Sie Produktionsimporte aktivieren, wenn ein sauberer Startzustand bevorzugt wird.
• Cache-Invalidierung. Löschen Sie nach einer Domainänderung und Datenbankmigration alle WordPress-Objekt-Caches, Page-Caches, CDN-Caches und PHP-Opcode-Caches, damit die neuen URLs und frischen Plugin-Optionen konsistent bereitgestellt werden.

Fehlerbehebung

Verwandte Dokumente

• Externe API-Zugangsdaten
• AutoScout24 API-Einrichtung
• Server-Cron-Einrichtung
• Webhook-Integration
• Anleitung für Template-Overrides
• Verbindungstest
• Go-Live-Checkliste
• Sichern und Wiederherstellen
• Datenhaltungsübersicht
• API-Verbindungsfehler