Dokumentation · Erste Schritte

Checkliste für den Live-Gang

Dieses Dokument ist die Checkliste für die Produktionsreife von ADP Car Market Hub. Es fasst alle übergreifenden Punkte zusammen, die bestätigt werden sollten, bevor automatische Importe auf der Live-WordPress-Website eines Kunden aktiviert werden, damit der Start vorhersehbar und umkehrbar ist.

Es ergänzt die Ersteinrichtung, anstatt sie zu ersetzen: Die Ersteinrichtung beschreibt Schritt für Schritt, wie das Plugin konfiguriert wird; dieses Dokument beschreibt, wie verifiziert wird, dass die Konfiguration für den Wechsel in den Live-Betrieb sicher ist.

Wann dieses Dokument zu verwenden ist

Verwenden Sie dieses Dokument, wenn Sie:

Eine Agentur oder ein Implementierungspartner sind, die/der kurz davor steht, eine neue ADP Car Market Hub-Bereitstellung für einen Kunden freizugeben.
Ein WordPress-Administrator sind, der eine validierte Staging-Konfiguration auf eine Produktions-Website überträgt.
Ein Hosting-Team sind, das dafür verantwortlich ist, zu bestätigen, dass die Produktionsumgebung für geplante Importe dimensioniert und konfiguriert ist.
Ein Betriebsverantwortlicher sind, der einen kontrollierten Relaunch nach einer Servermigration, einer Domainänderung, einer Zertifikatserneuerung oder einem größeren Plugin-Update durchführt.

Die Zielgruppe ist technisch: ein WordPress-Administrator mit vollem Back-Office-Zugriff, der (falls zutreffend) mit dem Hosting-Anbieter und dem Inhaber des AutoScout24-API-Zugangs für das Autohaus zusammenarbeitet.

Übersicht

Ein Produktions-Go-Live für ADP Car Market Hub ist keine einzelne Aktion – die Aktivierung automatischer Importe ist der letzte Schritt in einer Kette, die von folgenden Faktoren abhängt:

Bereitschaft der Hosting- und PHP-Umgebung.
Korrekte, dem Autohaus gehörende API-Zugangsdaten.
Ein erfolgreicher, wiederholbarer Verbindungstest und mindestens ein erfolgreicher Testimport.
Ein Frontend, das anhand echter, importierter Fahrzeugdaten überprüft wurde.
Rechtliche, Datenschutz- und Einwilligungseinstellungen, die mit den veröffentlichten Richtlinien des Autohauses übereinstimmen.
Ein dokumentierter Rollback-Pfad, falls nach dem Start Probleme auftreten.

Die folgende Checkliste ist nach Themen gruppiert. Jeder Punkt sollte entweder abgehakt oder mit einer dokumentierten Begründung ausdrücklich akzeptiert werden, bevor die Website für den echten Datenverkehr mit Live-Importen freigegeben wird.

Voraussetzungen vor der Bearbeitung der Checkliste

Bestätigen Sie, dass alle folgenden Voraussetzungen erfüllt sind, bevor Sie diese Checkliste öffnen:

Das Plugin ist auf der Produktions-Website installiert und aktiviert (siehe Installationsanleitung).
Eine konfigurierte Staging-Umgebung existiert und dieselbe Konfiguration wurde auf der Produktionsumgebung repliziert (siehe Staging to Live Migration).
Die API-Zugangsdaten für das Konto des Autohauses sind über einen sicheren Kanal verfügbar (siehe Einrichtung der API-Zugangsdaten, AutoScout24 API Setup, External API Credentials).
Die Website verfügt über ein aktuelles, wiederherstellbares Backup, das die Datenbank und wp-content/ enthält.
Die Beteiligten (Autohaus, Agentur, Hosting) haben sich auf ein Go-Live-Zeitfenster geeinigt, in dem die ersten Importe überwacht werden sollen.

Schritt-für-Schritt-Anleitung

Arbeiten Sie die Abschnitte der Reihe nach durch. Aktivieren Sie die automatische Planung erst, wenn jeder zutreffende Punkt bestätigt ist.

1. Umgebung und Infrastruktur

[ ] WordPress erfüllt die Mindestversion des Plugins (Requires at least: 6.2) und PHP erfüllt die Mindestanforderungen (Requires PHP: 8.1). Siehe Technische Systemanforderungen.
[ ] Erforderliche PHP-Erweiterungen sind vorhanden: openssl, curl, mbstring, json und entweder gd oder imagick. Siehe PHP- und Datenbank-Anforderungen.
[ ] Ausgehende HTTPS-Verbindungen zum konfigurierten AutoScout24-API-Host sind durch die Hosting-Firewall und jede WAF vor der Website erlaubt. Siehe API-, Netzwerk- und SSL-Anforderungen.
[ ] Das CA-Bundle des Servers vertraut der Zertifikatskette des API-Hosts (keine SSL/TLS-Validierungsfehler während des Verbindungstests).
[ ] Das Verzeichnis wp-content/uploads/ ist für den Webserver-Benutzer beschreibbar, und wp-content/uploads/as24ci-logs/ ist für die Plugin-Protokollierung erstellt oder erstellbar.
[ ] Es ist ausreichend Speicherplatz für die geplante Medienbibliothek vorhanden (importierte Fahrzeugbilder, einschließlich aller WebP-Varianten, falls die Konvertierung aktiviert ist).
[ ] Die Serverressourcen (Arbeitsspeicher, maximale Ausführungszeit, Datenbank) sind für den erwarteten Katalog dimensioniert. Siehe Hosting-Anforderungen.
[ ] Alle Einträge auf der Checkliste vor der Installation sind bestätigt.
[ ] Car Market Hub → System & Hilfe zeigt keine roten Badges.

2. Plugin-Konfiguration

[ ] Die Lizenz wurde unter Car Market Hub → Einstellungen (Karte „Lizenzaktivierung“) aktiviert. Die Admin-Tabs des Plugins zeigen nicht mehr den Bildschirm „Lizenz erforderlich“, was bestätigt, dass die Premium-Bereiche freigeschaltet sind. Siehe Ersteinrichtung.
[ ] Die Haupteinstellungen des Plugins unter Car Market Hub → Einstellungen wurden gespeichert und spiegeln die Produktionsumgebung wider, nicht die Staging-Umgebung.
[ ] API-Basis-URL, Seller ID (eine oder mehrere), Client ID und Client Secret sind unter Einstellungen eingetragen.
[ ] Die Standardwährung entspricht der Preiswährung des Autohauses.
[ ] Bildoptionen (ob Bilder importiert werden sollen, maximale Anzahl an Bildern pro Fahrzeug, optionale WebP-Konvertierung und -Qualität) sind bewusst eingestellt und nicht auf unbestätigten Standardwerten belassen.
[ ] Der Standard-Beitragsstatus und der Standard-Beitragsautor für neu importierte Fahrzeuge sind für die Produktion geeignet.
[ ] Die Option Standardseiten ist entweder aktiviert (sodass die Seiten Fahrzeuge, Fahrzeuge vergleichen und Favoriten erstellt werden) oder wird explizit durch die eigenen Seiten des Autohauses unter Verwendung der dokumentierten Shortcodes gelöst.
[ ] Filter, Mappings, Design und Styles sowie alle Layout-Anpassungen wurden anhand echter, importierter Fahrzeugdaten überprüft – nicht anhand von Platzhalter-Inhalten.

3. API-Verbindung

[ ] Der API-Verbindungstest unter Car Market Hub → Tools wird auf der Produktionswebsite mit den Produktions-API-Zugangsdaten erfolgreich abgeschlossen. Siehe Verbindungstest.
[ ] Wenn mehrere Seller IDs konfiguriert sind, wurde ein Trockenlauf (Dry Run) unter Tools ausgeführt und liefert Daten für jede konfigurierte Seller ID.
[ ] In Car Market Hub → Protokolle (Logs) erscheinen für den jüngsten Verbindungstest und Trockenlauf keine Authentifizierungs-, Autorisierungs- oder SSL-Fehler.
[ ] Die Zugangsdaten in der Produktion sind nicht dieselben temporären Werte, die während der frühen Staging-Tests verwendet wurden; rotierte Produktions-Zugangsdaten wurden, falls zutreffend, erneut getestet.

4. Testimporte und Datenqualität

[ ] Mindestens ein manueller Import eines einzelnen Fahrzeugs über Car Market Hub → Fahrzeug-Importer war erfolgreich, einschließlich Bildanhängen.
[ ] Ein vollständiger manueller Import über den Batch-Wizard unter Car Market Hub → Import & Limits wurde fehlerfrei abgeschlossen. Der Batch-Wizard unterstützt bei Bedarf das Pausieren, Fortsetzen und Abbrechen.
[ ] Die Anzahl der importierten Fahrzeuge entspricht den Erwartungen für die konfigurierten Seller IDs (Abgleich mit dem AutoScout24-Bestand des Autohauses).
[ ] Eine repräsentative Stichprobe importierter Fahrzeuge wurde überprüft auf: Titel, Preis, Währung, Kilometerstand, Ausstattungsliste, Bildanzahl und Bildreihenfolge.
[ ] Der Full Sync wird erst aktiviert, nachdem der Testimport bestätigt hat, dass alle erwarteten Fahrzeuge korrekt ankommen. Der Full Sync löscht lokale Fahrzeug-Beiträge und deren Bilder dauerhaft für alle Angebote, die von der API nicht mehr zurückgegeben werden.

5. Planung und Hintergrundverarbeitung

[ ] Das gewünschte automatische Importintervall (stündlich, alle 6 Stunden, zweimal täglich, täglich oder benutzerdefiniert) wurde gewählt und spiegelt die Erwartungen des Autohauses an die Datenaktualisierung wider.
[ ] Wenn WP-Cron auf dem Host unzuverlässig ist (beispielsweise weil die Seitenaufrufe zu selten sind oder der Host interne Cron-Jobs drosselt), ist ein echter Server-Cron-Job für den mit einem Token gesicherten REST-Endpunkt des Plugins konfiguriert. Siehe Server-Cron-Einrichtung und Cron-Jobs und Hintergrundverarbeitung.
[ ] Die Bildwarteschlange (Image Queue) ist aktiviert, um Cron-Läufe bei großen Katalogen innerhalb der PHP-Timeouts zu halten. Der Warteschlangenstatus unter System & Hilfe zeigt nach dem Testimport einen gesunden Fortschritt.
[ ] Die Einstellungen zur Cron-Robustheit (maximale Anzahl an Fahrzeugen pro Cron-Lauf) sind auf den Katalog und die PHP-Ausführungslimits des Hosts abgestimmt.
[ ] Das Verhalten des Token-Caches wurde überprüft: Ein neuer Test nach der Rotation der Zugangsdaten ist erfolgreich (bei Bedarf wird der Token-Cache unter Tools geleert).

6. Frontend und Kundenerfahrung

[ ] Die Archivseite Fahrzeuge wird mit echten Fahrzeugen korrekt dargestellt, einschließlich Filtern, Paginierung, Sortierung und Bild-Thumbnails.
[ ] Mindestens eine einzelne Fahrzeugseite wurde vollständig überprüft: Galerie, Fahrzeug-Detailtabelle, Ausstattungsliste, Preisformatierung, Kontaktformular (mit der Einwilligung-Checkbox) und alle optionalen Funktionen (Finanzierungsrechner, Probefahrt-Formular, Social Sharing), die aktiviert sind.
[ ] Eine Einsendung über ein Test-Kontaktformular erscheint unter Car Market Hub → Leads und löst die konfigurierte Empfänger-E-Mail aus.
[ ] Wenn Suchaufträge aktiviert sind, wurde ein Test-Abonnement abgeschlossen, einschließlich der Double-Opt-In-Bestätigungs-E-Mail. Siehe Suchaufträge Double-Opt-In.
[ ] Wenn der KI-Assistent aktiviert ist, wurden die KI-generierten Ausgaben für mindestens ein Fahrzeug überprüft und sind für die Veröffentlichung akzeptabel.
[ ] Übersetzungen / Sprach-Strings im Frontend spiegeln die Sprache der Website wider; fehlende Strings wurden über den standardmäßigen WordPress-Übersetzungs-Workflow behoben. Siehe Übersetzungs- und PoEdit-Anleitung.

7. Rechtliches, Datenschutz und Einwilligung

[ ] Die Website verfügt über eine veröffentlichte Datenschutzerklärung, die die vom Plugin erfassten Daten abdeckt (Kontaktformulardaten, optionale Analytics-Ereignisse, optionale Suchauftrag-Abonnements). Siehe DSGVO-Hinweise und Datenhaltungs-Übersicht.
[ ] Die Beschriftung der Einwilligung-Checkbox des Kontaktformulars, der Pflichtstatus und die sichtbaren Felder unter Car Market Hub → Leads entsprechen der Datenschutzerklärung des Autohauses. Siehe Lead-Daten und Einwilligung.
[ ] Wenn die Probefahrt-Buchung aktiviert ist, spiegeln die verfügbaren Wochentage, das tägliche Zeitfenster, die Slot-Dauer und die Sperrtage die tatsächliche Verfügbarkeit des Autohauses wider.
[ ] Das Autohaus hat akzeptiert, dass importierte Lead- und Suchauftragsdaten in der WordPress-Datenbank gespeichert werden, und ist für alle Aufbewahrungs- oder Exportverpflichtungen nach geltendem Recht selbst verantwortlich.

8. Performance, Caching und SEO

[ ] Jeder Seiten- oder Objekt-Cache (serverseitiger Cache, CDN, Caching-Plugin) wurde so konfiguriert, dass das Fahrzeugarchiv und die einzelnen Fahrzeugseiten nach jedem Import aktuelle Daten anzeigen und Admin-Anfragen nicht aus dem Cache bedient werden.
[ ] Wenn ein CDN Bilder von wp-content/uploads/ bereitstellt, sind Bild-Purges oder kurze Cache-Laufzeiten eingerichtet, damit neu importierte Bilder zeitnah sichtbar werden.
[ ] Die Website ist auf der endgültigen Produktionsdomain über HTTPS erreichbar, und die Optionen für die WordPress-Website-Adresse / WordPress-Adresse verweisen auf diese Domain.
[ ] Die Website ist nicht auf „Suchmaschinen davon abhalten, diese Website zu indexieren“ eingestellt (es sei denn, dies ist die ausdrückliche Absicht des Autohauses).
[ ] Eine XML-Sitemap ist vorhanden (bereitgestellt durch den WordPress-Core oder durch ein SEO-Plugin) und die neuen Fahrzeug-URLs folgen der kanonischen Struktur des Autohauses.
[ ] In der Produktionskonfiguration verbleiben keine Staging-URLs, Test-E-Mail-Adressen oder Test-Einwilligungstexte.

9. Betrieb, Überwachung und Support

[ ] Car Market Hub → Protokolle wurde geöffnet und das Rotationsverhalten ist verstanden. Das Protokollverzeichnis wp-content/uploads/as24ci-logs/ ist beschreibbar. Siehe Protokollierung und Überwachung.
[ ] Ein Zeitplan für Routineprüfungen wurde mit dem Kunden vereinbart: tägliche Lead- und Importprüfung (Täglicher Betrieb), Wöchentliche Wartung und Monatliche Wartung.
[ ] Import-Überwachung und Wartung der Bildwarteschlange werden von der Person verstanden, die die Website betreiben wird.
[ ] Ein Backup- und Wiederherstellungsverfahren ist dokumentiert und wurde mindestens einmal getestet. Siehe Backup und Wiederherstellung.
[ ] Der Update-Kanal des Plugins ist vereinbart (Admin-Upload einer neuen ZIP-Datei oder SFTP-Austausch des Plugin-Ordners) und entspricht dem Update-Prozess.
[ ] Es existiert ein dokumentierter Rollback-Plan: wie die Planung deaktiviert wird, wie das Plugin ohne Datenverlust deaktiviert wird und wie bei Bedarf ein Backup wiederhergestellt wird.
[ ] Der tägliche Betrieb wurde über die Rollen und Berechtigungen des Plugins an die entsprechenden Benutzer delegiert. Siehe Zugriffskontrolle und Berechtigungen.
[ ] Kontaktwege für den Support sind auf Kundenseite dokumentiert: Wer kümmert sich um WordPress-Probleme, wer kümmert sich um das Hosting, wer besitzt das AutoScout24-API-Konto und wie erfolgt im Bedarfsfall eine Eskalation an AD Promotion.
[ ] Die Informationen, die zum Eröffnen eines Support-Tickets benötigt werden, sind im Voraus bekannt. Siehe Checkliste für Support-Informationen.

10. Letzte Go-Live-Aktionen

Erst wenn jeder zutreffende Punkt oben abgehakt ist:

Führen Sie den Verbindungstest auf der Produktionswebsite als abschließende Plausibilitätsprüfung erneut aus.
Aktivieren Sie die automatischen Importe unter Car Market Hub → Import & Limits mit dem gewählten Intervall.
Lösen Sie einen Import manuell aus (oder warten Sie auf den ersten geplanten Lauf) und beobachten Sie die Protokolle, bis er abgeschlossen ist.
Überprüfen Sie das Frontend auf der Produktionsdomain erneut, einschließlich einer echten Kontaktformular-Einsendung und, falls zutreffend, eines echten Suchauftrag-Abonnements.
Übergeben Sie das System an die vereinbarte Überwachungsroutine und informieren Sie den Kunden, dass die Importe nun live sind.

Konfigurations-Referenz

Dieses Dokument führt keine neuen Einstellungen ein; es verweist nur auf die an anderer Stelle dokumentierte Konfiguration. Die relevantesten Seiten sind:

Felder für die API-Verbindung: siehe Einrichtung der API-Zugangsdaten.
Importplanung und Limits: siehe Ersteinrichtung (Schritt 5) und Cron-Jobs und Hintergrundverarbeitung.
Lead- und Einwilligungsfelder: siehe Lead-Daten und Einwilligung.
Server-Cron und externe Trigger: siehe Server-Cron-Einrichtung.

Operational notes

Reversibilität. Das Deaktivieren des automatischen Zeitplans unter Import & Limits stoppt neue Importe, ohne bereits importierte Fahrzeuge zu entfernen. Das Deaktivieren des Plugins deaktiviert seine Funktionen, behält jedoch importierte Fahrzeuge, Optionen, Leads und Analytics-Daten in der Datenbank. Daten werden bei der Deinstallation nur entfernt, wenn die entsprechende Bereinigungseinstellung aktiviert ist. Siehe Deinstallation und Datenbereinigung.
Full Sync beim Start. Es ist im Allgemeinen sicherer, den Start mit deaktiviertem Full Sync durchzuführen, einen vollständigen Importzyklus zu beobachten und Full Sync erst dann zu aktivieren, wenn der importierte Bestand konsistent vollständig ist. Eine vorzeitige Aktivierung von Full Sync kann Fahrzeuge dauerhaft löschen, die lediglich in einer vorübergehenden API-Antwort fehlten. Überprüfen Sie dieses Verhalten im Zweifelsfall in der aktuellen Plugin-Version vor der Veröffentlichung.
Domain- und URL-Änderungen. Wenn die Website auf einer neuen Domain gestartet wird (z. B. beim Wechsel von staging.example.com zu www.example.com), stellen Sie sicher, dass die WordPress-URLs, alle Caching-Ebenen und alle externen Dienste, die auf die Website verlinken, aufeinander abgestimmt sind, bevor Sie Importe aktivieren. Siehe Migration von Staging zu Live.
Stille Starts. Bei sensiblen Starts sollten Sie in Erwägung ziehen, automatische Importe außerhalb der Geschäftszeiten zu aktivieren und den ersten Cron-Zyklus über die Ansicht Protokolle zu beobachten, bevor Kunden die neuen Seiten erreichen können.
Dokumentationsübergabe. Stellen Sie dem Kunden die relevanten Seiten aus dem Benutzerhandbuch und dem Abschnitt Betrieb und Wartung zur Verfügung, damit er die täglichen Arbeitsabläufe versteht, für die er die Verantwortung übernimmt.

Troubleshooting

Symptom beim Go-Live	Wahrscheinliche Ursache	Was zu prüfen ist
Verbindungstest schlägt auf der Live-Umgebung fehl, war aber auf der Staging-Umgebung erfolgreich.	Die Live-Zugangsdaten weichen ab, das Live-Netzwerk ist restriktiver oder der Live-Server verfügt über ein anderes CA-Bundle.	Geben Sie die Zugangsdaten erneut ein, bestätigen Sie ausgehende HTTPS-Verbindungen zum API-Host mit dem Hosting-Anbieter und überprüfen Sie SSL-Fehler. Siehe Verbindungstest und API-Verbindungsfehler.
Geplante Importe starten nach Aktivierung des Zeitplans nicht.	WP-Cron ist auf dem Host deaktiviert oder gedrosselt.	Konfigurieren Sie einen Server-Cron-Job für den REST-Endpunkt des Plugins. Siehe Einrichtung des Server-Crons und Cron-Fehler.
Der erste Live-Import löscht Fahrzeuge, die eigentlich noch existieren sollten.	Full Sync wurde aktiviert, bevor der importierte Bestand als vollständig bestätigt wurde.	Deaktivieren Sie Full Sync, stellen Sie die betroffenen Fahrzeuge aus dem Backup wieder her und aktivieren Sie Full Sync erst wieder, nachdem Sie einen vollständigen, fehlerfreien Importzyklus beobachtet haben.
Fahrzeugseiten werden ohne Bilder gerrendered oder Bilder erscheinen nur schrittweise.	Die Bildwarteschlange wird im Hintergrund verarbeitet (erwartet) oder PHP-Timeouts unterbrechen die Downloads.	Beobachten Sie den Status der Bildwarteschlange unter System & Hilfe; lösen Sie Bildwarteschlange jetzt ausführen aus. Siehe Fehler beim Bildimport und Wartung der Bildwarteschlange.
Lead-E-Mails werden nicht zugestellt.	Die Website kann keine E-Mails senden, die Empfängeradresse ist falsch oder der Host blockiert ausgehendes SMTP.	Überprüfen Sie die Empfänger-E-Mail unter Leads und die Konfiguration für ausgehende E-Mails der Website. Siehe E-Mail- und Lead-Fehler.
Gecachte Seiten zeigen weiterhin den alten Fahrzeugbestand an.	Der Seitencache oder das CDN liefert veraltete Inhalte aus.	Konfigurieren Sie die Cache-Invalidierung oder kürzere TTLs für die betroffenen URLs.
Besucher landen nach dem Start auf Staging-URLs.	Veraltete Links, falsche WordPress-Website-URL oder DNS noch nicht propagiert.	Bestätigen Sie die Optionen für WordPress Website-Adresse und WordPress-Adresse und überprüfen Sie die DNS-Propagierung für die Live-Domain.

Für eine umfassendere symptombasierte Diagnose siehe den Abschnitt Fehlerbehebung.