System- & Hilfe-Referenz

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

Wann dieses Dokument zu verwenden ist

Lesen Sie dieses Dokument, wenn Sie Folgendes tun müssen:

• Bestätigen, dass Ihre Datenquellen, der REST-Endpunkt des Plugins und die Market Hub API erreichbar sind.
• Überprüfen, ob geplante Aufgaben (Cron-Jobs) fehlerfrei laufen 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

Der Bildschirm ist ein schreibgeschütztes Status-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.

Der Bildschirm ist in die folgenden Karten unterteilt:

• Konnektivität & API – eine Zeile Datenquellen (Status pro Quelle), die Prüfung der REST-API-Integration des Plugins und der Status der Market Hub API. Die Diagnose für den AutoScout24-Endpunkt, die Erreichbarkeit und das OAuth2-Token befinden sich jetzt auf der AutoScout24-Quellenkarte auf der Seite Verbindungen, nicht hier.
• E-Mail & Zustellbarkeit – ob der ausgehende E-Mail-Versand voraussichtlich funktioniert, plus eine Aktion Test-E-Mail senden.
• 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 Verwaltungsberechtigung 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

1. Öffnen Sie CMH Center → System & Help.
2. Überprüfen Sie unter Konnektivität & API Folgendes: - Datenquellen – eine Statuszusammenfassung pro Quelle für Ihre verbundenen Quellen (AutoScout24, mobile.de, carcuro, Feed, E-Mail). - REST-API-Integration für den as24ci/v1/cron-import-Endpunkt des Plugins. - Market Hub API-Erreichbarkeit für die Market Hub API.
3. Bewegen Sie den Mauszeiger über ein beliebiges Badge, um den Tooltip mit den zugrunde liegenden Details (HTTP-Status, Latenz oder Fehlermeldung) anzuzeigen.
4. Für den AutoScout24-Endpunkt, die Erreichbarkeit und die Token-Diagnose öffnen Sie die AutoScout24-Karte auf der Seite Verbindungen.

E-Mail-Zustellbarkeit prüfen und eine Test-E-Mail senden

1. Scrollen Sie zur Karte E-Mail & Zustellbarkeit. Sie bestätigt, ob der ausgehende E-Mail-Versand für Lead-, Suchauftrags- und Probefahrt-Benachrichtigungen voraussichtlich funktioniert.
2. Überprüfen Sie die Ampel-Zeilen: - E-Mail-Transport – ob WordPress überhaupt E-Mails senden kann (PHP mail() oder ein SMTP-/Mailer-Transport). - SMTP / Mailer – ob ein erkanntes SMTP-/Mailer-Plugin aktiv ist (z. B. WP Mail SMTP, FluentSMTP, Post SMTP, Easy WP SMTP) oder nur das reine PHP mail(). - Absenderadresse – die effektive Absenderadresse und ob deren Domain mit Ihrer Website-Domain übereinstimmt (SPF/DKIM-Abgleich). - SPF-Eintrag und DMARC-Eintrag – Best-Effort-, zwischengespeicherte DNS-Abfragen für die sendende Domain.
3. Bewegen Sie den Mauszeiger über ein beliebiges Badge, um den Tooltip mit dem Behebungshinweis anzuzeigen.
4. Um die tatsächliche Zustellung zu bestätigen, verwenden Sie Test-E-Mail senden. Das Empfängerfeld ist standardmäßig mit der E-Mail-Adresse des aktuellen Administrators vorausgefüllt; passen Sie sie bei Bedarf an und senden Sie das Formular ab. Die Nachricht wird über WordPresss wp_mail() gesendet, und direkt im Anschluss wird ein eindeutiger Erfolgs- oder Fehlerhinweis inline angezeigt.

Update-Diagnose überprüfen

1. Öffnen Sie die Karte Private Update-Diagnose in der rechten Spalte.
2. 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 remote neue Version, die Konsistenz der Transients (zwischengespeicherte Update-Daten), der Lizenzstatus und die normalisierte Domain.
3. 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, um zu bestätigen, dass das Plugin private Updates sehen und anwenden kann, ohne dass sensible Zugangsdaten offengelegt werden.

Geplante Aufgaben überprüfen

1. Scrollen Sie zu Hintergrundaufgaben.
2. 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.
3. Ü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 Preisanalyse-Jobs gehören.
4. Neben dem normalen Zustand für die nächste Ausführung kann eine Aufgabe auch Sperre blockiert, Wird von Server-Cron verarbeitet oder Nicht geplant melden.
5. 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.
6. Verwenden Sie die Inline-Schaltflächen, um bei Bedarf Import jetzt ausführen, Bildwarteschlange jetzt ausführen oder Bildwarteschlange leeren zu wählen.

Serverkompatibilität überprüfen

1. Lesen Sie die Plugin-Anforderungen für die Mindestversionen und Feature-Flags, einschließlich der Verfügbarkeit von ZipArchive und des Status des ionCube Loader (mit seiner Loader-Version).
2. Lesen Sie Server & Speicher für die PHP-Konfiguration: - 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

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

---

Konfigurationsreferenz

Die Seite „System & Hilfe“ speichert keine eigenen Einstellungen. Sie liest die aktuelle WordPress-Konfiguration, die Plugin-Optionen und den Laufzeitstatus aus.

Konnektivitäts- & API-Badges

Der genaue Wortlaut der Labels 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 Zeile für die REST-API wird erst 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.

E-Mail- & Zustellbarkeits-Zeilen

Die Aktion Test-E-Mail senden unterhalb der Tabelle sendet eine Nachricht über wp_mail() an den Empfänger (standardmäßig die E-Mail-Adresse des aktuellen Administrators) und meldet direkt ein klares Erfolgs- oder Fehlerszenario.

Private Update-Diagnose

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 remote angebotene neue Version, die Konsistenz der Transients (zwischengespeicherte Update-Daten), den Lizenzstatus und die normalisierte Domain. Ein kopierbarer JSON-Bericht am Ende bündelt diese Werte für den Support.

Server-Schwellenwerte

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 kontextbezogenen Badge dargestellt.

Hintergrundaufgaben-Aktionen

Betriebshinweise

• Konnektivitätsprüfungen verwenden ein kurzes Timeout sowie einen benutzerdefinierten User-Agent und speichern ihr Ergebnis für etwa eine Minute im Cache, 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-Zustandsprü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), das an eine Supportanfrage angehängt werden kann.
• Der Tooltip zum Ablauf des Tokens verwendet zur Anzeige die Zeitzone der WordPress-Website, der zwischengespeicherte Wert wird jedoch als UNIX-Timestamp 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 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 andernfalls festzustecken.
• Das Warn-Badge für die Bild-Warteschlange erscheint, wenn die Größe der Warteschlange den internen Schwellenwert des Plugins überschreitet (derzeit 1.000 ausstehende Elemente).
• Der freie Speicherplatz wird als Best-Effort-Wert gemeldet. Einige Hosts verbergen diesen Wert; in diesem Fall zeigt das Badge Nicht ermittelbar an.

Fehlerbehebung

• Eine Datenquelle zeigt bad. Öffnen Sie die Karte dieser Quelle auf der Seite Verbindungen, um die quellenspezifische Diagnose anzuzeigen. Bei AutoScout24 fehlt möglicherweise die Basis-URL oder sie ist fehlerhaft, oder der Upstream ist offline – die AutoScout24-Karte zeigt den Endpunkt, die Erreichbarkeit und die Token-Details.
• AutoScout24 hat kein Token / das Token ist abgelaufen. Speichern Sie eine gültige Client ID und ein Secret für AutoScout24 auf der Seite Verbindungen (die AutoScout24-Karte zeigt den Token-Status) und führen Sie dann Verbindung testen unter Tools-Referenz aus.
• Der 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 einen veralteten Wert bei „Nächste Ausführung“. Der WordPress-Cron ist deaktiviert oder es erfolgt kein Traffic auf der Website. Verwenden Sie die Schaltfläche Import jetzt ausführen, um zu bestätigen, dass die Aufgabe selbst ausgeführt wird, und richten Sie dann einen serverseitigen Trigger ein.
• memory_limit hat bad markiert. 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 Bild-Warteschlange wächst kontinuierlich. Klicken Sie auf Bild-Warteschlange jetzt abarbeiten, um einen Stapel zu verarbeiten. Wenn die Anzahl weiter steigt, reduzieren Sie die Anzahl der importierten Bilder pro Fahrzeug unter Referenz für Import und Limits oder erhöhen Sie dort die Ausführungshäufigkeit des Workers.
• Die Protokolldatei wurde mit bad oder Noch keine Protokolldatei vorhanden markiert. Stellen Sie sicher, dass das Protokollverzeichnis beschreibbar ist. Überprüfen Sie dies in der aktuellen Plugin-Version vor der Veröffentlichung.

Zugehörige Dokumente

• Verbindungen-Referenz
• Einstellungs-Referenz
• Referenz für Import und Limits
• Tools-Referenz
• Protokoll-Referenz
• Support-Referenz