Dokumentation · Betrieb und Wartung
Täglicher Betrieb
Dieses Dokument beschreibt die routinemässigen täglichen Kontrollen, die ein Website-Administrator oder ein Garagen-Manager durchführen sollte, um sicherzustellen, dass das ADP Car Market Hub-Plugin auf einer produktiven WordPress-Website ordnungsgemäss funktioniert.
Wann Sie dieses Dokument verwenden sollten
Lesen Sie dieses Dokument, wenn Sie für den täglichen Betrieb einer Live-Website verantwortlich sind, die das Plugin verwendet, um Fahrzeugangebote von AutoScout24 zu importieren und anzuzeigen. Diese Kontrollen sind so konzipiert, dass sie schnell durchgeführt werden können und Probleme abfangen, bevor sie sich auf Besucher oder Leads auswirken.
Übersicht
Das Plugin führt Importaufträge automatisch über WP-Cron oder einen externen Server-Cron aus, lädt Fahrzeugbilder asynchron über eine Bild-Queue herunter und speichert Besucherereignisse sowie Kundenanfragen in der WordPress-Datenbank. Die täglichen Kontrollen stellen sicher, dass diese Hintergrundprozesse wie erwartet laufen und sich keine Fehler angesammelt haben.
Das WordPress-Admin-Panel bietet einen Dashboard-Tab und einen Logs-Tab, die die relevantesten Betriebsdaten an einem Ort zusammenführen.
Anforderungen
- Administrator-Konto mit der Berechtigung
manage_as24_imports, die WordPress-Administratoren bei der Plugin-Aktivierung erteilt wird. - Zugriff auf WordPress Admin → ADP Car Market Hub (das Plugin-Admin-Menü).
Tägliche Kontrollen
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, überprüfen 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 → Logs.
- Das Panel Kürzliche Fehler zeigt die neuesten Einträge mit dem Status "Error" aus der aktuellen Log-Datei. Falls Fehler vorhanden sind, lesen Sie diese und untersuchen Sie die Ursache.
- Das Panel Kürzliche Warnungen zeigt Einträge mit dem Status "Warning", 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 überprüfen
- Öffnen Sie ADP Car Market Hub → Leads (oder navigieren Sie zum Leads-Tab im Plugin-Admin-Bereich).
- Ü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-Queue überprüfen
- Öffnen Sie ADP Car Market Hub → System & Help.
- Suchen Sie den Bereich für die Bild-Queue. Wenn die Bild-Queue aktiviert ist, werden die verbleibenden Bilder nach jedem Import asynchron verarbeitet. Ein kleiner Rückstau in der Warteschlange ist normal. Ein sehr grosser oder stagnierender Rückstau (der Tab "System & Help" zeigt eine Warnung an, wenn die Warteschlange den konfigurierten Schwellenwert überschreitet) kann darauf hindeuten, dass der Cron-Hook für die Bild-Queue nicht ausgelöst wird.
- Wenn die Warteschlangengrösse unerwartet hoch ist, verwenden Sie die Schaltfläche Bild-Queue jetzt auslösen im Tab "Import & Limits", um sie manuell zu verarbeiten, und überprüfen Sie anschliessend die Cron-Einrichtung.
5. API-Verbindung prüfen
- Öffnen Sie ADP Car Market Hub → System & Help.
- Die Zeile zum Verbindungsstatus 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 → Settings.
Konfigurationsreferenz
| Einstellungsort | Relevante Option | Zweck |
|---|---|---|
| Tab "Import & Limits" | Auto Import Aktiviert | Aktiviert oder deaktiviert automatische, geplante Importe |
| Tab "Import & Limits" | Zeitplan | Importfrequenz (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-Queue-Modus | Wenn aktiviert, wird nur das erste Bild sofort heruntergeladen; die restlichen Bilder werden in die Warteschlange eingereiht |
| Tab "Settings" | Lead-Empfänger-E-Mail | E-Mail-Adresse für Lead-Benachrichtigungen überschreiben |
| Tab "Logs" | 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 Durchlauf unerwartet abgebrochen wurde, wird die Sperre nach Ablauf ihrer TTL (40 Minuten) automatisch aufgehoben. - Die Log-Datei wird im WordPress-Uploads-Verzeichnis unter
as24ci-logs/adp-car-market-hub.loggespeichert. Das Verzeichnis ist durch eine.htaccess-Datei und eine stilleindex.phpvor öffentlichem Webzugriff geschützt. - Log-Dateien 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 & Help"; ziehen Sie den Wechsel zu einem Server-Cron in Betracht |
| Fehler im Log nach einem Import | API-Zugangsdaten abgelaufen oder ungültig, oder Netzwerkproblem | Überprüfen Sie den API-Verbindungsstatus im Tab "System & Help"; ü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-Queue wächst, nimmt aber nicht ab | Cron-Hook für die Bild-Queue läuft nicht | Lösen Sie die Bild-Queue manuell über den Tab "Import & Limits" aus; überprüfen Sie den Server-Cron oder den Zustand von WP-Cron |
| Dashboard-Zahlen wirken veraltet | Temporärer Cache (Transient) | Warten Sie drei Minuten, bis der dreiminütige Cache abläuft, und laden Sie die Seite dann neu |