Dokumentation · Admin-Referenz

System- und Hilfe-Referenz

Dieses Dokument ist eine Referenz für die Ansicht System & Hilfe des ADP Car Market Hub-Plugins (Car Market Hub → System & Help). Es erklärt die Bereiche für Konnektivität, Hintergrundaufgaben, Server, Protokolldateien und die Bildwarteschlange, die in dieser Integritätsü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 (Cron-Jobs) fehlerfrei sind 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öße der Protokolldatei, den Rotationsstatus und den Zustand der Bildimport-Warteschlange überprüfen.

Übersicht

Die Ansicht ist ein schreibgeschütztes Integritäts-Dashboard. Eine obere Aktionsleiste über den Karten enthält eine Schaltfläche Diagnose herunterladen — beschriftet mit Diagnose-ZIP herunterladen oder Diagnose-JSON herunterladen, wenn die ZIP-Unterstützung auf dem Server nicht verfügbar ist —, die ein Diagnosepaket herunterlädt, das Sie an eine Supportanfrage anhängen können.

Die Ansicht ist in folgende Karten unterteilt:

Konnektivität & API — AutoScout24-API-Status, OAuth2-Token-Status, Überprüfung des Plugin-REST-Endpunkts und Status der Market Hub-API.
Private Update-Diagnose — Update- und Versionsdiagnose mit einem kopierbaren JSON-Bericht.
Hintergrundaufgaben — Liste der geplanten Cron-Ereignisse mit ihrem Zeitplan und der nächsten Ausführungszeit sowie Aktionsschaltflächen.
Plugin-Anforderungen — Mindestversionen und Feature-Flags.
Server & Speicher — PHP-Konfiguration, Serverumgebung und Zustand des Upload-Verzeichnisses.
Status der Protokolldatei — Aktuelle Größe der Protokolldatei, Rotationsstatus und Pfad.
Status der Bildwarteschlange — 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 (sprechende 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 Konnektivität & API Folgendes: - AS24 API-Endpunkt-Status und AS24 API-Erreichbarkeit 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-Erreichbarkeit 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-Diagnose in der rechten Spalte.
Lesen Sie die Zeilen, um zu bestätigen, dass der Update-Kanal des Plugins fehlerfrei ist: die installierte Version, ob Update-Hooks registriert sind, die angebotene neue Remote-Version, die Konsistenz des 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 sensible Zugangsdaten offenzulegen.

Geplante Aufgaben überprüfen

Scrollen Sie zu Hintergrundaufgaben.
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 Letzter Import lief vor X oder Kein kürzlicher Import-Durchlauf 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 gehören Import-, Bildwarteschlangen-, Analytics- und Preisanalyse-Jobs.
Neben dem normalen Zustand der nächsten Ausführung kann eine Aufgabe auch Sperre blockiert, Vom Server-Cron verarbeitet oder 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 Import jetzt ausführen, Bildwarteschlange jetzt ausführen oder Bildwarteschlange leeren.

Serverkompatibilität überprüfen

Lesen Sie unter Plugin-Anforderungen die Mindestversionen und Feature-Flags ab, einschließlich der Verfügbarkeit von ZipArchive und des Status des ionCube Loader (mit seiner Loader-Version).
Lesen Sie unter Server & Speicher 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-Betriebssystem. - Zustand des Upload-Verzeichnisses und freier Speicherplatz.

Protokolldatei und Bildwarteschlange untersuchen

Status der Protokolldatei zeigt an, ob die Protokolldatei existiert, ihre aktuelle Größe, den verbleibenden Spielraum vor der Rotation, den Zeitpunkt der letzten Rotation und den Dateipfad.
Status der Bildwarteschlange zeigt ausstehende Bildimporte sowie Statistiken des letzten Worker-Durchlaufs (Anzahl der verarbeiteten Elemente, Fehler, verbleibende Elemente).

Konfigurationsreferenz

Die Ansicht „System & Hilfe“ speichert keine eigenen Einstellungen. Sie liest aus der aktuellen WordPress-Konfiguration, den Plugin-Optionen und dem Laufzeitstatus.

Badges für Konnektivität & API

Zeile	Mögliche Zustände
AS24 API-Endpunkt-Status	`ok` (konfiguriert und erreichbar), `bad` (keine Basis-URL oder unerreichbar).
AS24 API-Erreichbarkeit	Latenz-Ergebnis mit `ok` / `warn` / `bad`; Beschriftungen wie Verbindung aktiv, Host erreichbar, API-Endpunkt nicht verifiziert oder Serverfehler (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. Aktiv, Token-Schutz funktioniert (der Endpunkt weist ein ungültiges Integritätsprüfungs-Token mit HTTP 403 ab); REST-Endpunkt nicht gefunden (HTTP 404); oder unerreichbar.
Market Hub-Erreichbarkeit	Ä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 ein Cron-Token unter Referenz für Import und Limits generiert wurde. Andernfalls wird Not checked — no cron token configured angezeigt.

Private Update-Diagnose

Diese Karte zeigt den Update- und Lizenzierungsstatus des Plugins an. Ihre Zeilen enthalten in der Regel die installierte Version, ob Update-Hooks registriert sind, die angebotene neue Remote-Version, die Konsistenz des Transients (zwischengespeicherte Update-Daten), den Lizenzstatus und die normalisierte Domain. Ein kopierbarer JSON-Bericht am Ende 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, Schreibbarkeit des Upload-Verzeichnisses, freier Speicherplatz) werden mit ihren aktuellen Werten und einem kontextuellen Badge dargestellt.

Aktionen für Hintergrundaufgaben

Schaltfläche	Auswirkung
Import jetzt ausführen	Löst den regulären Import einmalig und sofort aus.
Bildwarteschlange jetzt ausführen	Verarbeitet den nächsten Stapel aus der Bildwarteschlange.
Bildwarteschlange leeren	Leert die Warteschlange der ausstehenden Bilder. Destruktiver Vorgang.

Betriebshinweise

Konnektivitätsprüfungen verwenden ein kurzes Timeout sowie einen benutzerdefinierten User-Agent und speichern ihr Ergebnis für etwa eine Minute zwischen, um die vorgeschalteten 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-Integritätsprüfung GET verwenden (die Market Hub-Prüfung zielt auf einen /v1/health-Endpunkt ab).
Die Schaltfläche Diagnose herunterladen in der oberen Aktionsleiste erstellt ein Diagnosepaket (eine ZIP-Datei, sofern unterstützt, andernfalls eine JSON-Datei) zum Anhängen an eine Supportanfrage.
Der Tooltip für den Token-Ablauf verwendet die Zeitzone der WordPress-Website für die Anzeige, der zwischengespeicherte Wert wird jedoch als UNIX-Zeitstempel gespeichert.
Die REST-API-Prüfung verwendet absichtlich ein ungültiges Token — eine fehlerfreie Installation antwortet mit HTTP 403. HTTP 404 weist darauf hin, dass der Endpunkt nicht erreichbar ist (normalerweise ein Problem mit 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 andernfalls festzustecken.
Das Warnungs-Badge für die Bildwarteschlange wird angezeigt, wenn die Größe der Warteschlange 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 Nicht ermittelbar an.

Fehlerbehebung

AS24 API-Erreichbarkeit ist bad. Die Basis-URL in den Einstellungen fehlt, ist fehlerhaft oder der vorgeschaltete 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 Verbindung testen unter Werkzeuge aus.
REST-API-Status meldet, dass der Endpunkt nicht gefunden wurde (HTTP 404). Sprechende 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 „Nicht geprüft — kein Cron-Token konfiguriert“. Öffnen Sie die Referenz für Import und Limits und generieren Sie ein Cron-Token.
Hintergrundaufgaben haben eine veraltete „Nächste Ausführung“. Der WordPress-Cron ist deaktiviert oder es geht kein Traffic auf der Website ein. Verwenden Sie die Schaltfläche Import jetzt ausführen, 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 große Importe.
Die Bildwarteschlange wächst weiter. Klicken Sie auf Bildwarteschlange jetzt ausführen, 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 für Import und Limits.
Protokolldatei meldet bad oder Noch keine Protokolldatei. Vergewissern Sie sich, dass das Protokollverzeichnis beschreibbar ist. Überprüfen Sie dies in der aktuellen Plugin-Version vor der Veröffentlichung.