Dokumentation · Fehlerbehebung

Übersicht zur Fehlerbehebung

Dieses Dokument bietet einen strukturierten Einstiegspunkt für die Diagnose und Behebung von Problemen mit dem ADP Car Market Hub WordPress Plugin. Es beschreibt die empfohlene Reihenfolge der Diagnose, wo Protokolle und Statusinformationen zu finden sind sowie sichere Praktiken bei der Einbindung des Supports.

Wann dieses Dokument zu verwenden ist

Lesen Sie dieses Dokument immer zuerst, wenn sich das Plugin nicht wie erwartet verhält. Es führt Sie zur richtigen Spezialseite und hilft Ihnen, die vor der Kontaktaufnahme mit dem Support benötigten Informationen zu sammeln.

Übersicht

Das ADP Car Market Hub-Plugin verbindet sich mit der AutoScout24-API, importiert Fahrzeugdaten in WordPress, verwaltet geplante Automatisierungen und stellt die Fahrzeuge im Frontend dar. Probleme können auf jeder dieser Ebenen auftreten. Eine systematische Diagnose-Reihenfolge verhindert, dass Sie Zeit auf der falschen Ebene verlieren.

Empfohlene Reihenfolge der Diagnose

Arbeiten Sie jede Ebene nacheinander ab. Halten Sie an und konsultieren Sie das entsprechende Spezialdokument, sobald Sie den Problembereich identifiziert haben.

  1. Prüfen Sie das Plugin-Protokoll – Das Plugin schreibt alle wichtigen Ereignisse, Fehler und Importergebnisse in eine eigene Protokolldatei. Dies ist immer die erste Anlaufstelle.
  2. Prüfen Sie die API-Verbindung – Wenn das Protokoll Authentifizierungs- oder HTTP-Fehler anzeigt oder die Systemstatus-Seite ein Verbindungsproblem meldet, konsultieren Sie API-Verbindungsfehler.
  3. Prüfen Sie die Importergebnisse – Wenn Fahrzeuge fehlen, nur teilweise importiert wurden oder veraltete Daten aufweisen, konsultieren Sie Importfehler.
  4. Prüfen Sie die geplante Automatisierung – Wenn automatische Importe nicht ausgeführt werden oder sich die Zeit der letzten Ausführung nicht ändert, konsultieren Sie Cron-Fehler.
  5. Prüfen Sie die Bildimporte – Wenn Fahrzeugbilder fehlen oder nicht vollständig heruntergeladen wurden, konsultieren Sie Bildimport-Fehler.
  6. Prüfen Sie die Frontend-Anzeige – Wenn Fahrzeuge im Backend erscheinen, aber im Frontend nicht korrekt dargestellt werden, konsultieren Sie Probleme mit der Frontend-Anzeige.
  7. Prüfen Sie die Berechtigungen – Wenn Admin-Seiten oder Import-Aktionen Fehler wegen verweigerten Zugriffs zurückgeben, konsultieren Sie Berechtigungsfehler.

Wo Protokolle und Statusinformationen zu finden sind

Plugin-Protokolldatei

Das Plugin schreibt in eine Protokolldatei im WordPress-Uploads-Verzeichnis:

wp-content/uploads/as24ci-logs/adp-car-market-hub.log

Das Protokollverzeichnis ist durch eine .htaccess-Datei und eine index.php-Barriere vor direktem Webzugriff geschützt. Greifen Sie auf die Datei über SFTP, den Datei-Manager des Hostings oder ein Protokoll-Anzeigetool mit Serverzugriff zu.

Die Protokolldatei rotiert automatisch, sobald sie 10 MB überschreitet. Rotierte Archive werden als adp-car-market-hub-YYYYMMDD-HHMMSS.log benannt und nach 7 Tagen automatisch gelöscht.

Eine detaillierte Protokollierung (Einträge pro Fahrzeug und pro Bild) ist standardmäßig aktiviert. Sie können diese in den Plugin-Einstellungen deaktivieren, um das Protokollvolumen bei großen Katalogen zu reduzieren.

Systemstatus-Seite

Der Plugin-Admin-Bereich enthält einen Reiter „System & Hilfe“, der Folgendes anzeigt:

  • API-Verbindungsstatus (zuletzt mit der konfigurierten Seller ID getestet)
  • Letzte Import-Laufzeit und Ergebniszahlen (eingefügt, aktualisiert, übersprungen, Fehler)
  • WP-Cron- oder Server-Cron-Status und letzte Ausführungszeit
  • Status der Bildwarteschlange (ausstehende Elemente, letzter Worker-Lauf)

Überprüfen Sie diese Seite, bevor Sie die Rohprotokolle prüfen.

WordPress-Admin

Standardmäßige WordPress-Tools bieten ebenfalls nützliche Informationen:

  • Werkzeuge → Geplante Ereignisse (oder ein WP-Cron-Viewer-Plugin): Überprüfen Sie, ob die Ereignisse as24ci_scheduled_import und as24ci_image_queue_process vorhanden sind und eine realistische nächste Ausführungszeit haben.
  • Mediathek: Bestätigen Sie, dass Fahrzeugbilder den korrekten Beiträgen zugeordnet sind.
  • Beiträge → Cars: Überprüfen Sie die Anzahl der veröffentlichten Fahrzeugbeiträge sowie alle Entwürfe oder ausstehenden Einträge.

Voraussetzungen für eine effektive Fehlerbehebung

Bestätigen Sie vor der Untersuchung Folgendes:

  • Sie haben Administrator-Zugriff auf das WordPress-Dashboard.
  • Sie haben Serverzugriff (SFTP, SSH oder Hosting-Datei-Manager), um die Protokolldatei zu lesen.
  • Sie kennen die aktuell installierte Plugin-Version (sichtbar unter Plugins → Installierte Plugins).
  • Sie kennen die PHP-Version und die WordPress-Version der Website (sichtbar unter Werkzeuge → Website-Zustand).

Sichere Praktiken bei der Einbindung des Supports

  • Teilen Sie keine API-Zugangsdaten (Client ID, Client Secret oder Zugriffs-Tokens) in Support-Tickets oder öffentlichen Foren. Das Plugin-Protokoll maskiert diese Werte automatisch.
  • Stellen Sie den relevanten Abschnitt der Protokolldatei bereit (nicht die gesamte Datei, es sei denn, Sie werden darum gebeten).
  • Fügen Sie die Ausgabe der Systemstatus-Seite oder einen Screenshot bei.
  • Beschreiben Sie die genauen Schritte, die Sie unternommen haben, bevor das Problem auftrat, einschließlich aller kürzlich vorgenommenen Einstellungsänderungen oder Plugin-Updates.
  • Wenn Sie ein Problem mit WordPress oder der Hosting-Umgebung vermuten, fügen Sie die Ausgabe von Werkzeuge → Website-Zustand → Info bei.

Betriebliche Hinweise

  • Die meisten Probleme werden durch fehlerhafte Zugangsdaten, einen nicht erreichbaren API-Endpunkt oder einen deaktivierten oder falsch konfigurierten Cron-Zeitplan verursacht.
  • Das Plugin verwendet temporäre Sperren (WordPress transients), um überschneidende Importläufe zu verhindern. Wenn ein Import abnormal abgebrochen wurde, kann die Sperre bis zu 40 Minuten bestehen bleiben, bevor sie automatisch aufgehoben wird.
  • Das Plugin speichert das letzte Importergebnis (Zahlen und Zeitstempel) in den WordPress-Optionen. Diese sind auf dem Admin-Dashboard sichtbar und werden auch in das Protokoll geschrieben.

Verwandte Dokumente