Dokumentation · Admin-Referenz

Support-Referenz

Dieses Dokument ist eine Referenz für den Support-Bildschirm des ADP Car Market Hub-Plugins (Car Market Hub → Support). Es behandelt den AI Support Assistant, das Kontakt-Eskalationsformular, die Dokumentationslinks und die Steuerung der lokalen Wissensdatenbank.

Wann Sie dieses Dokument verwenden sollten

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

Eine Frage zum Plugin stellen und eine Antwort erhalten möchten, die auf der offiziellen Wissensdatenbank basiert.
Ein strukturiertes Support-Ticket eröffnen möchten, wenn der Assistent das Problem nicht lösen kann.
Die offiziellen Dokumentationsabschnitte und das vollständige Dokumentations-Repository finden möchten.
Den lokalen AI-Wissensindex und die zwischengespeicherte externe Dokumentation verwalten möchten.
Antworten auf die häufigsten Fragen in den integrierten FAQ nachschlagen möchten.

Übersicht

Der Support-Bildschirm ist die zentrale Anlaufstelle für Hilfe. Eine Reihe von Status- (KPI-) Karten am oberen Rand fasst die Installation auf einen Blick zusammen, gefolgt von den Hauptkarten:

Statuskarten — Plugin-Version, Lizenz (Tarif und Betriebsstatus), Zuletzt aktualisiert, Support-Status (Betriebsbereit, N kürzliche Fehler oder Aufmerksamkeit erforderlich) und Wissensdatenbank (Anzahl der indexierten Einträge).
AI Support Assistant — Chat-Schnittstelle, die von einem verwalteten AI-Anbieter unterstützt wird und auf der lokalen Plugin-Wissensdatenbank sowie (optional) der zwischengespeicherten offiziellen Dokumentation basiert.
Kontakt-Eskalation — strukturiertes Ticket-Formular, das eine E-Mail an das ADP-Supportteam sendet, mit optionalem automatischem Anhang der Systemdiagnose.
Dokumentation & Ressourcen — Links zu den offiziellen Dokumentationsabschnitten und dem vollständigen Dokumentations-Repository.
Wissen & Cache — Zähler und Wartungsschaltflächen für die lokale AI-Wissensdatenbank und den externen Dokumentations-Cache.
Schnelle Fehlerbehebung & FAQ — kurze, kuratierte Antworten auf die häufigsten Fragen.

Anforderungen oder Voraussetzungen

Ein Benutzer mit der Berechtigung zur Verwaltung des Plugins.
Für den AI Support Assistant und den externen Dokumentations-Cache: ausgehender HTTPS-Zugriff vom Webserver.
Für das Kontaktformular: eine funktionierende WordPress-Mailkonfiguration (normalerweise ein SMTP-Plugin oder ein vom Hoster verwalteter Mail-Relay).
Cookies und JavaScript im Admin-Browser aktiviert (der Assistent und das Formular basieren auf AJAX).

Schritt-für-Schritt-Anleitung

Den AI Support Assistant fragen

Öffnen Sie Car Market Hub → Support.
Geben Sie auf der Karte AI Support Assistant Ihre Frage in eigenen Worten ein.
Klicken Sie auf AI fragen oder drücken Sie Ctrl + Enter (oder Cmd + Enter auf macOS).
Die Antwort wird im Konversationsbereich angezeigt. Wenn die Antwort auf Dokumentationsseiten verweist, wird die Quellenliste darunter angezeigt.

Der Assistent bevorzugt Antworten aus der lokalen Wissensdatenbank und greift bei Bedarf auf die zwischengespeicherte externe Dokumentation zurück. Der aktive Admin-Tab wird als Kontext mitgesendet, damit die Antwort auf den Bereich ausgerichtet werden kann, in dem Sie gerade arbeiten. Der Assistent versucht, in Ihrer WordPress-Admin-Sprache zu antworten; wenn Sie in einer anderen Sprache schreiben, folgt er der Sprache Ihrer Nachricht.

Ein Support-Ticket eröffnen

Scrollen Sie zu Kontakt-Eskalation.
Füllen Sie Name, E-Mail, Betreff und Nachricht aus. Name und E-Mail sind aus Ihrem WordPress-Profil vorausgefüllt.
Wählen Sie eine Priorität (Low, Normal (Standard), High, Urgent).
Lassen Sie Systemdiagnose automatisch anhängen aktiviert, wenn Sie das Plugin-Log und die WordPress debug.log anhängen möchten (jeweils auf 2 MB begrenzt).
Klicken Sie auf Ticket senden. Eine Statusmeldung bestätigt das Ergebnis direkt im Formular.

Offizielle Dokumentation öffnen

Verwenden Sie die Karte Dokumentation & Ressourcen, um Folgendes zu öffnen: - Erste Schritte — erste Schritte und Erstkonfiguration. - Admin-Referenz — Referenz für jeden Admin-Bildschirm. - Fehlerbehebung & FAQ — Antworten auf häufige Probleme und Fragen. - Frontend-Handbuch — die für Besucher sichtbare Suche, Fahrzeuglisten und Detailseiten. - Betrieb & Wartung — täglicher Betrieb, Importe und Pflege. - Checkliste für Support-Informationen — was vor der Kontaktaufnahme mit dem Support zu sammeln ist. - Vollständige Dokumentation — das vollständige Dokumentations-Repository.

Jeder Link öffnet sich in einem neuen Browser-Tab.

AI-Wissensdatenbank und Dokumentations-Cache verwalten

Überprüfen Sie auf der Karte Wissen & Cache die Zähler: - Lokale KB-Einträge — Anzahl der lokal indexierten Wissenseinträge. - Indexierte Q&A-Paare — Anzahl der Q&A-Paare, die der Assistent abgleichen kann. - Zwischengespeicherte Dokumente — lokal gespeicherte externe cached / total-Dokumentationsseiten.
Verwenden Sie die Schaltflächen: - AI-Wissensindex neu aufbauen — reindexiert die lokale Wissensdatenbank aus der Quelle. - Dokumentations-Cache aktualisieren — lädt die externen Dokumentationsseiten neu herunter. - Dokumentations-Cache löschen — entfernt die zwischengespeicherte externe Dokumentation. Destruktiv.

Die FAQ verwenden

Öffnen Sie Quick Troubleshooting & FAQ am unteren Rand des Bildschirms.
Klicken Sie auf eine beliebige Frage, um die Antwort auszuklappen. Kategorien werden, sofern festgelegt, am Ende jedes Eintrags angezeigt.

Konfigurationsreferenz

Der Support-Bildschirm speichert keine eigene Konfiguration. Er zeigt den Laufzeitstatus an und bietet direkte Aktionen.

Kontaktformular-Felder

Feld	Erforderlich	Hinweise
Name	Ja	Vorausgefüllt aus dem aktuellen Benutzerprofil.
E-Mail	Ja	Vorausgefüllt aus dem aktuellen Benutzerprofil.
Betreff	Ja	Klartext.
Priorität	Nein	Eine von `Low`, `Normal`, `High`, `Urgent`. Standardmässig `Normal`.
Nachricht	Ja	Klartext.
Systemdiagnose automatisch anhängen	Nein	Standardmässig aktiviert. Hängt das Plugin-Log und WordPress `debug.log` an (jeweils max. 2 MB).

Steuerung für Wissen & Cache

Steuerelement	Auswirkung
AI-Wissensindex neu aufbauen	Erstellt den lokalen Wissensindex neu, der als Grundlage für den Assistenten dient.
Dokumentations-Cache aktualisieren	Lädt den Snapshot der externen Dokumentation neu herunter.
Dokumentations-Cache löschen	Leert die zwischengespeicherte externe Dokumentation (der Assistent verlässt sich dann nur noch auf die lokale KB).

Betriebshinweise

Der AI Assistant ruft über das Plugin einen verwalteten AI-Anbieter auf. Es werden keine rohen Endkundendaten gesendet, es sei denn, Sie geben diese explizit in den Chat ein.
Das Kontaktformular sendet seine Nachricht und alle angehängten Diagnosedaten über die WordPress-Mail an eine feste ADP-Supportadresse; dieser Empfänger ist nicht website-spezifisch konfigurierbar. Die Zustellung hängt von der Mailkonfiguration Ihrer Website ab.
Der Systemdiagnose-Anhang soll helfen, Probleme schnell zu reproduzieren. Jeder Anhang ist auf 2 MB begrenzt. Wenn Ihr Log diese Grösse überschreitet, wird nur der neueste Teil angehängt.
Die lokale Wissensdatenbank wird mit dem Plugin ausgeliefert und aus den Quelldateien neu aufgebaut. Der externe Dokumentations-Cache wird aus dem offiziellen Dokumentations-Repository abgerufen und lokal gespeichert, damit GitHub nicht bei jeder Frage abgefragt werden muss.
Der Assistent empfiehlt immer, ein Support-Ticket zu eröffnen, wenn er unsicher ist — betrachten Sie dies als explizites Signal und nicht als Fehler.

Fehlerbehebung

Der Assistent gibt einen Fehler zurück. Überprüfen Sie den ausgehenden HTTPS-Zugriff vom Server. Öffnen Sie die Browserkonsole für eine spezifischere Fehlermeldung. Versuchen Sie es nach einer kurzen Verzögerung erneut; vorübergehende Upstream-Fehler sind häufig.
Das Kontaktformular meldet einen Fehler. WordPress-Mail ist nicht konfiguriert. Installieren Sie ein Transaktions-Mail-Plugin (oder lassen Sie Ihren Hoster SMTP konfigurieren) und senden Sie das Formular erneut ab.
Der Systemdiagnose-Anhang fehlt. Entweder waren die Logdateien nicht lesbar oder jede einzelne überschritt 2 MB und wurde übersprungen. Überprüfen Sie den Pfad der Logdatei unter System- und Hilfe-Referenz.
Der Zähler für zwischengespeicherte Dokumente zeigt 0 / N. Die externe Dokumentation wurde noch nicht abgerufen. Klicken Sie auf Dokumentations-Cache aktualisieren.
AI-Wissensindex neu aufbauen meldet null Einträge. Überprüfen Sie, ob die Plugin-Dateien intakt sind. Installieren Sie das Plugin bei Bedarf neu.
Ressourcen-Links öffnen die falsche Seite. Der Cache ist möglicherweise veraltet; klicken Sie auf Dokumentations-Cache aktualisieren und laden Sie den Bildschirm neu.