Documentatie · Beheerdersreferentie
Supportreferentie
Dit document is een referentie voor het Support-scherm van de ADP Car Market Hub plugin (Car Market Hub → Support). Het behandelt de AI Support Assistant, het contact-escalatieformulier, de documentatielinks en de lokale kennisbank-instellingen.
Wanneer u dit document moet gebruiken
Lees dit als u het volgende wilt doen:
- Een vraag stellen over de plugin en een antwoord krijgen dat is gebaseerd op de officiële kennisbank.
- Een gestructureerd supportticket openen wanneer de assistent het probleem niet kan oplossen.
- De officiële documentatiesecties en de volledige documentatie-repository vinden.
- De lokale AI-kennisindex en de gecachte externe documentatie beheren.
- Antwoorden op de meest gestelde vragen opzoeken in de ingebouwde FAQ.
Overzicht
Het Support-scherm is de centrale help-hub. Een rij statuskaarten (KPI's) bovenaan geeft in één oogopslag een samenvatting van de installatie, gevolgd door de belangrijkste kaarten:
- Statuskaarten — Plugin Version, License (abonnement en operationele status), Last Updated, Support Status (Operational, N recente fouten, of Attention required) en Knowledge Base (aantal geïndexeerde items).
- AI Support Assistant — chatinterface ondersteund door een beheerde AI-provider, gebaseerd op de lokale plugin-kennisbank en (optioneel) gecachte officiële documentatie.
- Contact Escalation — gestructureerd ticketformulier dat een e-mail stuurt naar het ADP-supportteam, met optionele automatische bijlage van diagnostische gegevens.
- Documentation & Resources — links naar de officiële documentatiesecties en de volledige documentatie-repository.
- Knowledge & Cache — tellers en onderhoudsknoppen voor de lokale AI-kennisbank en de externe documentatiecache.
- Quick Troubleshooting & FAQ — korte, geselecteerde antwoorden op de meest gestelde vragen.
Vereisten of randvoorwaarden
- Een gebruiker met de beheerdersrechten van de plugin.
- Voor de AI Support Assistant en de externe documentatiecache: uitgaande HTTPS-toegang vanaf de webserver.
- Voor het contactformulier: een werkende WordPress e-mailconfiguratie (meestal een SMTP-plugin of een door de host beheerde mailrelay).
- Cookies en JavaScript ingeschakeld in de browser van de beheerder (de assistent en het formulier maken gebruik van AJAX).
Stapsgewijze instructies
De AI Support Assistant vragen stellen
- Open
Car Market Hub → Support. - Typ in de kaart AI Support Assistant uw vraag in uw eigen woorden.
- Klik op Ask AI of druk op
Ctrl + Enter(ofCmd + Enterop macOS). - Het antwoord verschijnt in het gesprekspanel. Wanneer het antwoord verwijst naar documentatiepagina's, wordt de bronnenlijst eronder weergegeven.
De assistent geeft de voorkeur aan antwoorden uit de lokale kennisbank en valt indien nodig terug op de gecachte externe documentatie. De actieve beheerderstab wordt als context meegestuurd, zodat het antwoord kan worden afgestemd op het gebied waarin u momenteel werkt. De assistent probeert te antwoorden in uw WordPress beheerders-taal; als u in een andere taal schrijft, volgt hij de taal van uw bericht.
Een supportticket openen
- Scrol naar Contact Escalation.
- Vul Name, Email, Subject en Message in. Naam en e-mailadres zijn vooraf ingevuld vanuit uw WordPress profiel.
- Kies een Priority (
Low,Normal(standaard),High,Urgent). - Laat Attach system diagnostics automatically ingeschakeld als u wilt dat het plugin-logboek en de WordPress
debug.logworden bijgevoegd (elk beperkt tot 2 MB). - Klik op Submit Ticket. Een statusbericht bevestigt het resultaat direct op de pagina.
Officiële documentatie openen
- Gebruik de kaart Documentation & Resources om het volgende te openen: - Getting Started — eerste stappen en initiële configuratie. - Admin Reference — referentie voor elk beheerdersscherm. - Troubleshooting & FAQ — antwoorden op veelvoorkomende problemen en vragen. - Frontend Guide — de voor bezoekers zichtbare zoek-, overzichts- en detailpagina's. - Operations & Maintenance — dagelijks beheer, importen en onderhoud. - Support Information Checklist — wat u moet verzamelen voordat u contact opneemt met support. - Full Documentation — de volledige documentatie-repository.
Elke link opent in een nieuw browsertabblad.
De AI-kennisbank en documentatiecache onderhouden
- Controleer in de kaart Knowledge & Cache de tellers:
- Local KB entries — aantal lokaal geïndexeerde kennisitems.
- Indexed Q&A pairs — aantal vraag-en-antwoordparen waarmee de assistent kan vergelijken.
- Cached docs —
cached / totalexterne documentatiepagina's die lokaal zijn opgeslagen. - Gebruik de knoppen: - Rebuild AI Knowledge Index — de lokale kennisbank opnieuw indexeren vanaf de bron. - Refresh Documentation Cache — de externe documentatiepagina's opnieuw downloaden. - Clear Documentation Cache — de gecachte externe documentatie verwijderen. Dit is destructief.
De FAQ gebruiken
- Open
Quick Troubleshooting & FAQonderaan het scherm. - Klik op een vraag om het antwoord uit te klappen. Categorieën worden onderaan elk item weergegeven, indien ingesteld.
Configuratiereferentie
Het Support-scherm slaat geen eigen configuratie op. Het toont de runtime-status en directe acties.
Velden van het contactformulier
| Veld | Vereist | Opmerkingen |
|---|---|---|
| Name | Ja | Vooraf ingevuld vanuit het huidige gebruikersprofiel. |
| Ja | Vooraf ingevuld vanuit het huidige gebruikersprofiel. | |
| Subject | Ja | Platte tekst. |
| Priority | Nee | Een van Low, Normal, High, Urgent. Standaard is Normal. |
| Message | Ja | Platte tekst. |
| Attach system diagnostics automatically | Nee | Standaard ingeschakeld. Voegt het plugin-logboek en WordPress debug.log toe (elk max. 2 MB). |
Knowledge & Cache-instellingen
| Instelling | Effect |
|---|---|
| Rebuild AI Knowledge Index | Bouwt de lokale kennisindex die wordt gebruikt om de assistent te voeden opnieuw op. |
| Refresh Documentation Cache | Downloadt de momentopname van de externe documentatie opnieuw. |
| Clear Documentation Cache | Leegt de gecachte externe documentatie (de assistent zal dan alleen op de lokale kennisbank vertrouwen). |
Operationele opmerkingen
- De AI Assistant roept via de plugin een beheerde AI-provider aan. Er worden geen ruwe gegevens van eindklanten verzonden, tenzij u deze expliciet in de chat typt.
- Het contactformulier verzendt het bericht en eventuele bijgevoegde diagnostische gegevens naar een vast ADP-supportadres via WordPress mail; deze bestemming is niet configureerbaar op de site. De bezorging is afhankelijk van de e-mailconfiguratie van uw site.
- De bijlage met diagnostische gegevens is bedoeld om problemen snel te kunnen reproduceren. Elke bijlage is beperkt tot 2 MB. Als uw logboek dit overschrijdt, wordt alleen het meest recente deel meegestuurd.
- De lokale kennisbank wordt met de plugin meegeleverd en wordt opnieuw opgebouwd uit bronbestanden. De externe documentatiecache wordt opgehaald uit de officiële documentatie-repository en lokaal opgeslagen, zodat GitHub niet bij elke vraag hoeft te worden geraadpleegd.
- De assistent adviseert altijd om een supportticket te openen als hij onzeker is — beschouw dat als een expliciet signaal, niet als een fout.
Probleemoplossing
- De assistent geeft een foutmelding. Controleer de uitgaande HTTPS-toegang vanaf de server. Open de browserconsole voor een specifiekere foutmelding. Probeer het na een korte vertraging opnieuw; tijdelijke upstream-fouten komen vaker voor.
- Het contactformulier meldt een fout. WordPress mail is niet geconfigureerd. Installeer een plugin voor transactionele e-mail (of laat uw host SMTP configureren) en verzend het formulier opnieuw.
- Diagnostische bijlage ontbreekt. Ofwel de logbestanden waren niet leesbaar, ofwel elk bestand overschreed de 2 MB en is overgeslagen. Controleer het pad naar het logbestand op de Systeem- en hulpreferentie.
- De teller voor gecachte documenten toont
0 / N. Externe documentatie is nog niet opgehaald. Klik op Refresh Documentation Cache. - Rebuild AI Knowledge Index meldt nul items. Controleer of de plugin-bestanden intact zijn. Installeer de plugin indien nodig opnieuw.
- Links naar bronnen openen de verkeerde pagina. De cache is mogelijk verouderd; klik op Refresh Documentation Cache en herlaad het scherm.