Dokumentation · Admin-Referenz

System- und Hilfe-Referenz

Dieses Dokument ist eine Referenz für den System & Help-Bildschirm des ADP Car Market Hub-Plugins (Car Market Hub → System & Help). Es erklärt die Bereiche für Konnektivität, Hintergrundaufgaben, Server, Logdateien und die Bildwarteschlange, die in dieser Statusübersicht dargestellt werden.

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dies, wenn Sie Folgendes tun müssen:

Bestätigen, dass die AutoScout24-API, der REST-Endpunkt des Plugins und die Market Hub-API erreichbar sind.
Überprüfen, ob geplante Aufgaben (Cronjobs) einwandfrei funktionieren und wann sie das nächste Mal ausgeführt werden.
Einen Import, einen Durchlauf der Bildwarteschlange oder das Leeren der Warteschlange von einer einzigen Stelle aus auslösen.
Überprüfen, ob der Server die Anforderungen des Plugins erfüllt (PHP-Version, Arbeitsspeicher, Ausführungszeit).
Die Grösse der Logdatei und den Rotationsstatus sowie den Zustand der Bildimport-Warteschlange überprüfen.

Übersicht

Der Bildschirm ist ein Dashboard zur Statusüberwachung, das hauptsächlich zum Lesen dient. Eine obere Aktionsleiste über den Karten enthält eine Schaltfläche Download Diagnostics – beschriftet mit Download Diagnostics ZIP oder Download Diagnostics JSON, wenn die ZIP-Unterstützung auf dem Server nicht verfügbar ist –, mit der Sie ein Diagnosepaket herunterladen können, das Sie einer Supportanfrage beifügen können.

Der Bildschirm ist in die folgenden Karten unterteilt:

Connectivity & API – Status der AutoScout24-API, OAuth2-Token-Status, Überprüfung des Plugin-REST-Endpunkts und Status der Market Hub-API.
Private Update Diagnostics – Update- und Versionsdiagnose mit einem kopierbaren JSON-Bericht.
Background Tasks – Liste der geplanten Cron-Ereignisse mit ihrem Zeitplan und der nächsten Ausführungszeit sowie Aktionsschaltflächen.
Plugin Requirements – Mindestversionen und Feature-Flags.
Server & Storage – PHP-Konfiguration, Serverumgebung und Zustand des Upload-Verzeichnisses.
Log File Status – aktuelle Grösse der Logdatei, Rotationsstatus und Pfad.
Image Queue Status – ausstehende Bilder, Statistiken des letzten Worker-Durchlaufs.

Jede Zeile verwendet Ampel-Badges (ok, warn, bad) mit Tooltips, die den Schwellenwert oder den Behebungsschritt erklären.

Anforderungen oder Voraussetzungen

Ein Benutzer mit der Berechtigung zur Verwaltung des Plugins.
Für die Konnektivitätsprüfungen: ausgehender HTTPS-Zugriff vom Webserver auf die konfigurierten API-Endpunkte.
Für die REST-API-Prüfung: WordPress (schöne Permalinks) müssen aktiviert sein.
Für den Cron-Bereich: Der integrierte Cron von WordPress muss aktiv sein, oder ein serverseitiger Scheduler muss wp-cron.php aufrufen.

Schritt-für-Schritt-Anleitung

Konnektivität überprüfen

Öffnen Sie Car Market Hub → System & Help.
Überprüfen Sie unter Connectivity & API Folgendes: - AS24 API Endpoint Status und AS24 API Reachability für die AutoScout24-Basis-URL. - Token Status (Gültig / Läuft bald ab / Abgelaufen / Kein Token). - REST API Status für den as24ci/v1/cron-import-Endpunkt des Plugins. - Market Hub Reachability für die Market Hub-API.
Bewegen Sie den Mauszeiger über ein Badge, um den Tooltip mit den zugrunde liegenden Details (HTTP-Status, Latenz oder Fehlermeldung) anzuzeigen.

Update-Diagnose überprüfen

Öffnen Sie die Karte Private Update Diagnostics in der rechten Spalte.
Lesen Sie die Zeilen, um zu bestätigen, dass der Update-Kanal des Plugins einwandfrei funktioniert: die installierte Version, ob Update-Hooks registriert sind, die angebotene neue Remote-Version, die Konsistenz der Transients (zwischengespeicherte Update-Daten), der Lizenzstatus und die normalisierte Domain.
Wenn Sie den Support wegen eines Update- oder Lizenzierungsproblems kontaktieren, verwenden Sie den kopierbaren JSON-Bericht unten auf der Karte und fügen Sie ihn in Ihr Ticket ein.

Diese Karte ist eine schnelle Möglichkeit zu bestätigen, dass das Plugin private Updates sehen und anwenden kann, ohne dass sensible Zugangsdaten offengelegt werden.

Geplante Aufgaben überprüfen

Scrollen Sie zu Background Tasks.
Der Kartenkopf zeigt ein Badge an, das angibt, ob die Planung über WP-Cron oder einen Server Cron läuft, zusammen mit einem Heartbeat-Hinweis wie Last import ran X ago (Letzter Import lief vor X) oder No recent import run detected (Kein kürzlicher Importlauf erkannt).
Überprüfen Sie die Tabelle: Jede Zeile zeigt die Cron-Aufgabe, ihren Zeitplan, den Zeitstempel der nächsten Ausführung und ein Status-Badge. Zu den Aufgaben können Import-, Bildwarteschlangen-, Analytics- und Pricing Analysis-Jobs gehören.
Neben dem normalen Zustand der nächsten Ausführung kann eine Aufgabe auch Lock stuck (Sperre blockiert), Handled by server cron (Vom Server-Cron verarbeitet) oder Not scheduled (Nicht geplant) melden.
Wenn der integrierte Cron von WordPress deaktiviert ist (DISABLE_WP_CRON), wird eine Warnung angezeigt; richten Sie in diesem Fall einen serverseitigen Scheduler ein, der wp-cron.php aufruft.
Verwenden Sie bei Bedarf die Inline-Schaltflächen Run Import Now, Run Image Queue Now oder Clear Image Queue.

Serverkompatibilität überprüfen

Lesen Sie unter Plugin Requirements die Mindestversionen und Feature-Flags ab, einschliesslich der Verfügbarkeit von ZipArchive und des Status des ionCube Loader (mit seiner Loader Version).
Lesen Sie unter Server & Storage die PHP-Konfiguration ab: - memory_limit, WP Memory Limit, max_execution_time, upload_max_filesize, post_max_size, max_input_vars. - PHP SAPI und Server OS. - Zustand des Upload-Verzeichnisses und freier Speicherplatz.

Logdatei und Bildwarteschlange überprüfen

Log File Status zeigt an, ob die Logdatei existiert, ihre aktuelle Grösse, den verbleibenden Spielraum vor der Rotation, den Zeitpunkt der letzten Rotation und den Dateipfad.
Image Queue Status zeigt ausstehende Bildimporte sowie Statistiken des letzten Worker-Durchlaufs (Anzahl verarbeiteter Bilder, Fehler, verbleibende Elemente).

Konfigurationsreferenz

Der Bildschirm „System & Help“ speichert keine eigenen Einstellungen. Er liest aus der aktuellen WordPress-Konfiguration, den Plugin-Optionen und dem Laufzeitstatus.

Badges für Connectivity & API

Zeile	Mögliche Zustände
AS24 API Endpoint Status	`ok` (konfiguriert und erreichbar), `bad` (keine Basis-URL oder unerreichbar).
AS24 API Reachability	Latenz-basiertes Ergebnis mit `ok` / `warn` / `bad`; Beschriftungen wie Connection active, Host reachable, API endpoint not verified oder Server error (HTTP n). Für 60 Sekunden zwischengespeichert.
Token Status	`Valid`, `Valid — expires <time>`, `Expires soon` (weniger als 5 Minuten), `Expired`, `No token`.
REST API Status	Endpunkt erreichbar, z. B. Active, token protection works (der Endpunkt weist ein ungültiges Health-Check-Token mit HTTP 403 ab); REST endpoint not found (HTTP 404); oder unerreichbar.
Market Hub Reachability	Ähnliches Muster wie bei der AS24-API-Prüfung.

Der genaue Wortlaut der Beschriftungen kann sich zwischen den Plugin-Versionen leicht unterscheiden; verlassen Sie sich eher auf die Badge-Farbe und die Tooltip-Details als auf den präzisen Text.

Die REST-API-Zeile wird nur dann vollständig überprüft, wenn in Referenz zu Import & Limits ein Cron-Token generiert wurde. Andernfalls wird Not checked — no cron token configured angezeigt.

Private Update Diagnostics

Diese Karte zeigt den Update- und Lizenzierungsstatus des Plugins an. Die Zeilen enthalten in der Regel die installierte Version, ob Update-Hooks registriert sind, die angebotene neue Remote-Version, die Konsistenz der Transients (zwischengespeicherte Update-Daten), den Lizenzstatus und die normalisierte Domain. Ein kopierbarer JSON-Bericht am unteren Rand fasst diese Werte für den Support zusammen.

Server-Schwellenwerte

Einstellung	`ok`	`warn`	`bad`
`memory_limit`	≥ 256 MB oder unbegrenzt	128–255 MB	< 128 MB
`max_execution_time`	> 60 s oder unbegrenzt	30–60 s	< 30 s

Die anderen PHP-Werte (upload_max_filesize, post_max_size, max_input_vars, Beschreibbarkeit des Upload-Verzeichnisses, freier Speicherplatz) werden mit ihren aktuellen Werten und einem kontextuellen Badge dargestellt.

Aktionen für Hintergrundaufgaben

Schaltfläche	Auswirkung
Run Import Now	Löst den regulären Import einmalig und sofort aus.
Run Image Queue Now	Verarbeitet den nächsten Stapel aus der Bildwarteschlange.
Clear Image Queue	Leert die Warteschlange der ausstehenden Bilder. Destruktiv.

Betriebliche Hinweise

Konnektivitätsprüfungen verwenden ein kurzes Timeout und einen benutzerdefinierten User-Agent und speichern ihr Ergebnis für etwa eine Minute zwischen, um die Upstream-Dienste nicht zu überlasten. Sie verwenden nicht alle dieselbe HTTP-Methode: Die AutoScout24-Prüfung sendet eine HEAD-Anfrage, während die REST-Selbstprüfung des Plugins und die Market Hub-Statusprüfung GET verwenden (die Market Hub-Prüfung zielt auf einen /v1/health-Endpunkt ab).
Die Schaltfläche Download Diagnostics in der oberen Aktionsleiste erstellt ein Diagnosepaket (eine ZIP-Datei, wo unterstützt, andernfalls eine JSON-Datei), das Sie einer Supportanfrage beifügen können.
Der Tooltip für den Token-Ablauf verwendet zur Anzeige die Zeitzone der WordPress-Website, der zwischengespeicherte Wert wird jedoch als UNIX-Zeitstempel gespeichert.
Die REST-API-Prüfung verwendet absichtlich ein ungültiges Token – eine funktionierende Installation antwortet mit HTTP 403. HTTP 404 weist darauf hin, dass der Endpunkt nicht erreichbar ist (normalerweise ein Problem mit den Permalinks oder Rewrite-Regeln).
Wenn DISABLE_WP_CRON aktiv ist, werden geplante Aufgaben nicht ausgeführt, es sei denn, der Host ist so konfiguriert, dass er wp-cron.php selbstständig aufruft. Importe und Bildverarbeitung scheinen ohne dies blockiert zu sein.
Das Warn-Badge für die Bildwarteschlange erscheint, wenn die Warteschlangengrösse den internen Schwellenwert des Plugins überschreitet (derzeit 1'000 ausstehende Elemente).
Der freie Speicherplatz wird nach bestem Bemühen gemeldet. Einige Hosts verbergen dies; in diesem Fall zeigt das Badge Unable to determine (Bestimmung nicht möglich) an.

Fehlerbehebung

AS24 API Reachability ist bad. Die Basis-URL in den Einstellungen fehlt, ist fehlerhaft oder der Upstream-Dienst ist offline. Überprüfen Sie den Tooltip auf den zugrunde liegenden Fehler.
Token Status ist No token. Speichern Sie eine gültige Client ID und ein Secret in den Einstellungen und führen Sie dann Test Connection unter Tools aus.
REST API Status meldet, dass der Endpunkt nicht gefunden wurde (HTTP 404). Schöne Permalinks sind deaktiviert, oder ein anderes Plugin überschreibt das REST-Routing. Speichern Sie die Permalinks unter Settings → Permalinks erneut ab.
Die REST-API-Zeile meldet "Not checked — no cron token configured." Öffnen Sie die Referenz zu Import & Limits und generieren Sie ein Cron-Token.
Hintergrundaufgaben haben ein veraltetes "Next Run". Der WordPress-Cron ist deaktiviert oder es geht kein Traffic auf die Website ein. Verwenden Sie die Schaltfläche Run Import Now, um zu bestätigen, dass die Aufgabe selbst läuft, und richten Sie dann einen serverseitigen Trigger ein.
memory_limit meldet bad. Erhöhen Sie memory_limit in der php.ini oder wp-config.php (define('WP_MEMORY_LIMIT', '256M');) – erforderlich für grosse Importe.
Die Bildwarteschlange wächst weiter. Klicken Sie auf Run Image Queue Now, um einen Stapel zu verarbeiten. Wenn die Anzahl weiter steigt, reduzieren Sie die Anzahl der importierten Bilder pro Fahrzeug in den Einstellungen oder erhöhen Sie die Häufigkeit der Worker-Durchläufe in der Referenz zu Import & Limits.
Logdatei meldet bad oder No log file yet. Bestätigen Sie, dass das Log-Verzeichnis beschreibbar ist. Überprüfen Sie dies in der aktuellen Plugin-Version vor der Veröffentlichung.