Dokumentation · Betrieb und Wartung

Täglicher Betrieb

Dieses Dokument beschreibt die routinemäßigen täglichen Prüfungen, die ein Website-Administrator oder Autohaus-Manager durchführen sollte, um zu bestätigen, dass das ADP Car Market Hub-Plugin auf einer produktiven WordPress-Website ordnungsgemäß funktioniert.

Wann dieses Dokument zu verwenden ist

Lesen Sie dieses Dokument, wenn Sie für den täglichen Betrieb einer Live-Website verantwortlich sind, die das Plugin verwendet, um Fahrzeugbestände von AutoScout24 zu importieren und anzuzeigen. Diese Prüfungen sind so konzipiert, dass sie schnell durchgeführt werden können und Probleme abfangen, bevor sie Besucher oder Leads beeinträchtigen.

Übersicht

Das Plugin führt Import-Jobs automatisch über WP-Cron oder einen externen Server-Cron aus, lädt Fahrzeugbilder asynchron über eine Warteschlange herunter und speichert Besucherereignisse sowie Kundenanfragen in der WordPress-Datenbank. Tägliche Prüfungen bestätigen, dass diese Hintergrundprozesse wie erwartet laufen und sich keine Fehler angesammelt haben.

Das WordPress-Admin-Panel bietet einen Dashboard-Tab und einen Protokoll-Tab, die die relevantesten Betriebsdaten an einem Ort zusammenführen.

Systemvoraussetzungen

Administrator-Konto mit der Berechtigung manage_as24_imports, die WordPress-Administratoren bei der Aktivierung des Plugins erteilt wird.
Zugriff auf WordPress-Admin → ADP Car Market Hub (das Plugin-Admin-Menü).

Tägliche Prüfungen

1. Letzten Importlauf bestätigen

Öffnen Sie ADP Car Market Hub → Dashboard.
Suchen Sie die KPI-Zeile. Sie zeigt die Gesamtzahl der importierten Fahrzeuge, die in den letzten sieben Tagen neu hinzugefügten Fahrzeuge und den Zeitstempel des letzten Importlaufs an.
Überprüfen Sie, ob der Zeitstempel des letzten Imports dem erwarteten Zeitplan entspricht. Wenn der Import seit dem letzten erwarteten Intervall nicht ausgeführt wurde, untersuchen Sie die Automatisierungseinstellungen oder die Cron-Konfiguration.
Für weitere Details öffnen Sie ADP Car Market Hub → Import & Limits und überprüfen Sie die Zeit unter Letzter Lauf sowie den Status des letzten Laufs (eingefügt, aktualisiert, übersprungen, Fehler).

2. Auf Importfehler prüfen

Öffnen Sie ADP Car Market Hub → Protokoll.
Das Panel Kürzliche Fehler zeigt die neuesten Einträge mit Fehler-Status aus der aktuellen Protokolldatei. Wenn Fehler vorhanden sind, lesen Sie diese und untersuchen Sie die Ursache.
Das Panel Kürzliche Warnungen zeigt Einträge mit Warnungs-Status, die auf einen eingeschränkten Betrieb hinweisen können (z. B. teilweise Bildfehler oder API-Rate-Limit-Antworten).
Ein leeres Fehler-Panel ist der erwartete fehlerfreie Zustand.

3. Neue Leads prüfen

Öffnen Sie ADP Car Market Hub → Leads (oder navigieren Sie zum Leads-Tab innerhalb der Plugin-Verwaltung).
Überprüfen Sie alle Leads mit dem Status Neu, die seit dem Vortag eingegangen sind.
Weisen Sie bearbeiteten Leads einen Status zu (Kontaktiert, Geschlossen oder Spam), damit die Warteschlange übersichtlich bleibt.
Überprüfen Sie, ob die Lead-Benachrichtigungs-E-Mails zugestellt wurden, indem Sie den Posteingang der konfigurierten Empfängeradresse prüfen. Der Empfänger wird unter Einstellungen → Lead-Empfänger-E-Mail festgelegt.

4. Bild-Warteschlange überprüfen

Öffnen Sie ADP Car Market Hub → System & Hilfe.
Suchen Sie den Bereich für die Bild-Warteschlange. Wenn die Bild-Warteschlange aktiviert ist, werden verbleibende Bilder nach jedem Import asynchron verarbeitet. Ein kleiner Rückstau in der Warteschlange ist normal. Ein sehr großer oder stagnierender Rückstau (der Tab „System & Hilfe“ zeigt eine Warnung an, wenn die Warteschlange den konfigurierten Schwellenwert überschreitet) kann darauf hindeuten, dass der Cron-Hook für die Bild-Warteschlange nicht ausgelöst wird.
Wenn die Warteschlangengröße unerwartet hoch ist, verwenden Sie die Schaltfläche Bild-Warteschlange jetzt auslösen im Tab „Import & Limits“, um sie manuell zu verarbeiten, und untersuchen Sie anschließend die Cron-Einrichtung.

5. API-Verbindung prüfen

Öffnen Sie ADP Car Market Hub → System & Hilfe.
Die Verbindungsstatuszeile bestätigt, ob das Plugin die AutoScout24-API mit den aktuell konfigurierten Zugangsdaten erreichen kann.
Der Status Verbunden mit AutoScout24 – Token gültig und API erreichbar ist der erwartete fehlerfreie Zustand.
Wenn der Status einen Fehler anzeigt, überprüfen Sie die Einstellungen für Client ID, Client Secret und Seller ID unter ADP Car Market Hub → Einstellungen.

Konfigurationsreferenz

Einstellungsort	Relevante Option	Zweck
Tab „Import & Limits“	Automatischer Import aktiviert	Aktiviert oder deaktiviert automatische geplante Importe
Tab „Import & Limits“	Zeitplan	Import-Häufigkeit (stündlich, alle 6 Stunden, zweimal täglich, täglich oder benutzerdefiniertes Intervall)
Tab „Import & Limits“	Max. Fahrzeuge pro Durchlauf	Begrenzt die Anzahl der in einem einzelnen Cron-Durchlauf verarbeiteten Fahrzeuge (0 = unbegrenzt)
Tab „Import & Limits“	Bild-Warteschlangen-Modus	Wenn aktiviert, wird nur das erste Bild sofort heruntergeladen; verbleibende Bilder werden in die Warteschlange eingereiht
Tab „Einstellungen“	Lead-Empfänger-E-Mail	Abweichende E-Mail-Adresse für Lead-Benachrichtigungen
Tab „Protokoll“	Ausführliche Protokollierung	Wenn aktiviert, wird für jedes Fahrzeug und jede Bildaktion eine Zeile protokolliert

Betriebshinweise

Das Plugin verwendet eine temporäre Sperre (as24ci_cron_import_running), um überschneidende Importläufe zu verhindern. Wenn ein vorheriger Lauf unerwartet abgebrochen wurde, wird die Sperre nach Ablauf ihrer TTL (40 Minuten) automatisch aufgehoben.
Die Protokolldatei wird im WordPress-Uploads-Verzeichnis unter as24ci-logs/adp-car-market-hub.log gespeichert. Das Verzeichnis ist durch eine .htaccess-Datei und eine stille index.php vor öffentlichem Webzugriff geschützt.
Protokolldateien werden automatisch rotiert, wenn sie 10 MB überschreiten. Rotierte Archive werden nach 7 Tagen gelöscht.
Die Daten im Dashboard-Tab werden für drei Minuten zwischengespeichert. Wenn Sie gerade einen manuellen Import ausgelöst haben, warten Sie einige Minuten, bevor Sie die Zahlen überprüfen.

Fehlerbehebung

Symptom	Wahrscheinliche Ursache	Prüfung
Letzte Importzeit ist älter als erwartet	WP-Cron wird nicht ausgelöst oder Website hat wenig Traffic	Überprüfen Sie den Cron-Modus im Tab „System & Hilfe“; erwägen Sie den Wechsel zu einem Server-Cron
Fehler im Protokoll nach einem Import	API-Zugangsdaten abgelaufen oder ungültig, oder Netzwerkproblem	Überprüfen Sie den API-Verbindungsstatus im Tab „System & Hilfe“; überprüfen Sie die Zugangsdaten in den Einstellungen
Keine neuen Leads trotz Besucheraktivität	Kontaktformular nicht konfiguriert oder E-Mail-Zustellung schlägt fehl	Testen Sie das Kontaktformular manuell; überprüfen Sie die Einstellung für die Lead-Empfänger-E-Mail
Bild-Warteschlange wächst, nimmt aber nicht ab	Cron-Hook für die Bild-Warteschlange läuft nicht	Lösen Sie die Bild-Warteschlange manuell über den Tab „Import & Limits“ aus; überprüfen Sie den Zustand des Server-Crons oder von WP-Cron
Dashboard-Zahlen wirken veraltet	Temporärer Cache	Warten Sie drei Minuten, bis der dreiminütige Cache abläuft, und laden Sie die Seite dann neu