System- und Hilfe-Referenz

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

Wann Sie dieses Dokument verwenden sollten

Lesen Sie dies, 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 (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

Die Seite ist ein Dashboard für den Systemzustand, das hauptsächlich zum Lesen gedacht ist. 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 –, mit der Sie ein Diagnosepaket herunterladen können, das Sie einer Supportanfrage beifügen können.

Die Seite 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 befindet sich jetzt auf der AutoScout24-Quellenkarte auf der Seite Verbindungen und 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, plus Aktionsschaltflächen.
• Plugin-Anforderungen – Mindestversionen und Feature-Flags.
• Server & Speicher – PHP-Konfiguration, Serverumgebung und Zustand des Upload-Verzeichnisses.
• Logdatei-Status – aktuelle Logdateigrösse, Rotationsstatus und Pfad.
• Bildwarteschlangen-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 „Pretty 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 die Diagnose des AutoScout24-Endpunkts, der Erreichbarkeit und des Tokens ö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 Benachrichtigungen zu Leads, Suchaufträgen und Probefahrten 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- und zwischengespeicherte DNS-Abfragen für die Absender-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ässig auf die E-Mail-Adresse des aktuellen Administrators eingestellt; passen Sie es bei Bedarf an und senden Sie es ab. Die Nachricht wird über das wp_mail() von WordPress gesendet, und direkt im Anschluss wird ein klarer Inline-Erfolgs- oder Fehlerhinweis 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 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.
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 vor X ausgeführt 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 Pricing Analysis-Jobs gehören.
4. Neben dem normalen Zustand der nächsten Ausführung kann eine Aufgabe auch Sperre blockiert, Verarbeitet durch Server-Cron 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 bei Bedarf die Inline-Schaltflächen Import jetzt ausführen, Bildwarteschlange jetzt ausführen oder Bildwarteschlange leeren.

Serverkompatibilität überprüfen

1. Lesen Sie unter Plugin-Anforderungen die Mindestversionen und Feature-Flags nach, einschliesslich der Verfügbarkeit von ZipArchive und des Status des ionCube Loader (mit seiner Loader-Version).
2. 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.

Logdatei und Bildwarteschlange überprüfen

1. Der Logdatei-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.
2. Der Bildwarteschlangen-Status zeigt ausstehende Bildimporte sowie Statistiken des letzten Worker-Durchlaufs (Anzahl verarbeiteter Elemente, Fehler, verbleibende Elemente).

---

---

Konfigurationsreferenz

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

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 REST-API-Zeile wird nur dann vollständig überprüft, wenn in Import & Limits ein Cron-Token generiert wurde. Andernfalls wird Not checked — no cron token configured angezeigt.

E-Mail- & Zustellbarkeitszeilen

Die Aktion Test-E-Mail senden unterhalb der Tabelle sendet eine Nachricht via wp_mail() an den Empfänger (standardmässig die E-Mail-Adresse des aktuellen Administrators) und meldet ein klares Inline-Erfolgs- oder Fehlerergebnis.

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 der Transients (gepufferte Update-Daten), den Lizenzstatus und die normalisierte Domain. Ein kopierbarer JSON-Bericht am Ende fasst diese Werte für den Support zusammen.

Server-Grenzwerte

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

Betriebliche Hinweise

• Konnektivitätsprüfungen verwenden ein kurzes Timeout sowie einen benutzerdefinierten User-Agent und cachen ihr Ergebnis für etwa eine Minute, um eine Überlastung der Upstream-Dienste zu vermeiden. 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).
• Der Button Diagnose herunterladen in der oberen Aktionsleiste erstellt ein Diagnosepaket (ein ZIP, wo unterstützt, andernfalls eine JSON-Datei) zum Anhängen an eine Supportanfrage.
• Der Tooltip für den Token-Ablauf verwendet die WordPress-Zeitzone der Website für die Anzeige, aber der gecachte Wert wird 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 den 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 bleiben ohne dies hängen.
• Das Warnungs-Badge für die Bildwarteschlange erscheint, wenn die Grösse der Warteschlange den internen Schwellenwert des Plugins überschreitet (derzeit 1'000 ausstehende Elemente).
• Freier Speicherplatz wird als Best-Effort gemeldet. Einige Hosts verbergen dies; in diesem Fall zeigt das Badge Nicht ermittelbar.

Fehlerbehebung

• Eine Datenquelle zeigt bad. Öffnen Sie die Karte dieser Quelle auf der Seite Verbindungen, um die quellenspezifische Diagnose anzuzeigen. Für AutoScout24 fehlt möglicherweise die Basis-URL oder sie ist fehlerhaft, oder der Upstream ist offline – die AutoScout24-Karte zeigt Endpunkt, Erreichbarkeit und 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 aus.
• Der 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 neu.
• Die REST-API-Zeile meldet "Nicht geprüft – kein Cron-Token konfiguriert." Öffnen Sie Import & Limits und generieren Sie ein Cron-Token.
• Hintergrundaufgaben haben ein veraltetes "Nächste Ausführung". Der WordPress-Cron ist deaktiviert oder es geht kein Traffic auf die Website ein. Verwenden Sie den Button Import jetzt ausführen, um zu bestätigen, dass die Aufgabe selbst läuft, und richten Sie dann einen serverseitigen Trigger ein.
• memory_limit hat bad markiert. Erhöhen Sie memory_limit in php.ini oder wp-config.php (define('WP_MEMORY_LIMIT', '256M');) – erforderlich für grosse Importe.
• Die Bildwarteschlange wächst weiter. Klicken Sie auf Bildwarteschlange jetzt abarbeiten, um einen Batch zu verarbeiten. Wenn die Anzahl weiter steigt, reduzieren Sie die Anzahl der importierten Bilder pro Fahrzeug in Import & Limits oder erhöhen Sie dort die Ausführungshäufigkeit des Workers.
• Die Logdatei wurde mit bad oder Noch keine Logdatei markiert. Stellen Sie sicher, dass das Log-Verzeichnis beschreibbar ist. Überprüfen Sie dies in der aktuellen Plugin-Version vor der Veröffentlichung.

Verwandte Dokumente

• Referenz zu Verbindungen
• Einstellungs-Referenz
• Referenz zu Import & Limits
• Tools-Referenz
• Logs-Referenz
• Support-Referenz