Dokumentation · Fehlerbehebung

Fehlerbehebung Übersicht

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 Logs und Statusinformationen zu finden sind sowie sichere Praktiken bei der Kontaktaufnahme mit dem Support.

Wann Sie dieses Dokument verwenden sollten

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 erforderlichen Informationen zu sammeln, bevor Sie den Support kontaktieren.

Übersicht

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

Empfohlene Diagnosereihenfolge

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

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

Wo Logs und Statusinformationen zu finden sind

Plugin-Logdatei

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

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

Das Log-Verzeichnis ist durch eine .htaccess-Datei und eine index.php-Sperre vor direktem Webzugriff geschützt. Greifen Sie auf die Datei über SFTP, den Datei-Manager des Hostings oder ein Log-Viewer-Tool mit Serverzugriff zu.

Die Logdatei 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.

Die detaillierte Protokollierung (Einträge pro Fahrzeug und Bild) ist standardmässig aktiviert. Sie können diese in den Plugin-Einstellungen deaktivieren, um das Log-Volumen bei grossen Katalogen zu reduzieren.

Systemstatus-Seite

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

  • API-Verbindungsstatus (zuletzt mit der konfigurierten Seller ID getestet)
  • Zeitpunkt des letzten Importlaufs und Anzahl der Ergebnisse (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 Roh-Logs analysieren.

WordPress-Admin

Standardmässige 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 Fahrzeug-Beiträ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 Logdatei 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 Kontaktaufnahme mit dem Support

  • Teilen Sie keine API-Zugangsdaten (Client ID, Client Secret oder Access-Tokens) in Support-Tickets oder öffentlichen Foren. Das Plugin-Log maskiert diese Werte automatisch.
  • Stellen Sie den relevanten Ausschnitt der Logdatei bereit (nicht die gesamte Datei, ausser 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, einschliesslich kürzlicher 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 ungültige Zugangsdaten, einen nicht erreichbaren API-Endpunkt oder einen deaktivierten bzw. 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 gelöscht wird.
  • Das Plugin speichert das letzte Importergebnis (Anzahl und Zeitstempel) in den WordPress-Optionen. Diese sind auf dem Admin-Dashboard sichtbar und werden auch in das Log geschrieben.

Verwandte Dokumente