Beheerdershandleiding

Deze handleiding documenteert de administratieve verantwoordelijkheden voor de ADP Car Market Hub WordPress Plugin. Het behandelt het eigendom van de eerste installatie, gebruikersrechten, importconfiguratie, geplande taken, systeemstatusbewaking en ondersteuningscoördinatie.

Wanneer u dit document moet gebruiken

Lees dit document als u:

• Een WordPress beheerder bent die verantwoordelijk is voor het installeren, configureren en onderhouden van de plugin.
• Moet begrijpen welke rechten vereist zijn en hoe u deze kunt beheren.
• Verantwoordelijk bent voor het betrouwbaar laten verlopen van imports en het onderzoeken van fouten.
• Coördineert met de technische ondersteuning of een integratiepartner.

Voor dagelijkse operationele taken zoals het controleren van de importstatus, het beoordelen van leads en het valideren van de frontend, raadpleegt u Dagelijkse gebruikswerkstromen.

---

Overzicht

ADP Car Market Hub vereist een zorgvuldige eerste configuratie voordat er voertuigen kunnen worden geïmporteerd. De beheerder is verantwoordelijk voor:

• Het invoeren en onderhouden van geldige API-inloggegevens.
• Het configureren van het importschema en het kiezen tussen WP-Cron en server-cron.
• Het instellen van de juiste standaard post-status, auteur, afbeeldingsverwerking en valuta.
• Het verlenen of beperken van toegang tot de beheerinterface van de plugin.
• Het onderhouden van de verkoopcontacten van het autobedrijf die aan klanten worden getoond en worden gebruikt voor lead-routing (CMH Team).
• Het bewaken van de gezondheid van de plugin, logboekuitvoer en het succes van de import.
• Het coördineren met AutoScout24 of uw integratiepartner wanneer er API-problemen optreden.

---

Vereisten of randvoorwaarden

• WordPress beheerdersgtoegang is vereist om de plugin te installeren en mogelijkheden te beheren.
• PHP 8.1 of hoger en WordPress 6.2 of hoger moeten op de server draaien.
• Geldige AutoScout24 API-inloggegevens (API Base URL, Seller ID(s), Client ID, Client Secret, Token URL, Audience) moeten vóór de installatie worden verkregen van AutoScout24 of uw integratiepartner. De plugin kan geen voertuigen importeren zonder deze gegevens.
• De server moet uitgaande HTTPS-verbindingen naar het geconfigureerde API-eindpunt toestaan.
• Als server-cron de voorkeur heeft boven WP-Cron, moet de hostingomgeving geplande taken (crontab of equivalent) ondersteunen.

---

Rechten en mogelijkheden

Beheermogelijkheid van de plugin

De plugin introduceert een aangepaste WordPress mogelijkheid: manage_as24_imports.

• Deze mogelijkheid is vereist om toegang te krijgen tot het ADP Car Market Hub beheermenu, imports uit te voeren, instellingen te wijzigen, leads te bekijken en alle beheertools te gebruiken.
• Bij activering krijgen WordPress beheerders (de rol administrator) automatisch manage_as24_imports toegewezen.
• Andere gebruikersrollen (redacteur, winkelmanager, etc.) ontvangen deze mogelijkheid niet standaard. Een WordPress beheerder moet dit expliciet toewijzen met behulp van een plugin voor rolbeheer of aangepaste code als toegang vereist is voor niet-beheerders.

WordPress post-mogelijkheden

Het aangepaste berichttype as24ci_car (het menu CMH Cars) gebruikt zijn eigen specifieke WordPress mogelijkheden (edit_as24ci_cars, publish_as24ci_cars, enzovoort). Voertuiggegevens verschijnen onder CMH Cars → All Cars, niet onder het standaard WordPress Berichten-scherm. Toegang tot de specifieke plugin-beheerpagina's onder CMH Center and CMH Team vereist bovendien manage_as24_imports.

Gevoelige instellingen beschermen

API-inloggegevens (Client ID en Client Secret) worden opgeslagen in de WordPress optietabel. Toegang tot het tabblad Instellingen is beveiligd met manage_as24_imports. Zorg ervoor dat alleen vertrouwde beheerders deze mogelijkheid hebben.

---

Eerste installatie

Volg deze stappen wanneer u de plugin voor de eerste keer configureert:

1. Installeer en activeer de plugin via WordPress Beheer → Plugins → Nieuwe toevoegen of door het plugin-archief te uploaden.
2. Navigeer naar ADP Car Market Hub → Instellingen.
3. Voer de API Base URL in voor uw AutoScout24-omgeving. Veelvoorkomende basis-URL's zijn de regionale AutoScout24 API-hosts (verifieer de juiste URL bij AutoScout24 of uw integratiepartner).
4. Voer een of meer Seller IDs in (gescheiden door komma's) die overeenkomen met uw AutoScout24 dealeraccount(s).
5. Voer de Client ID en Client Secret in die door AutoScout24 zijn verstrekt.
6. Voer de Token URL en Audience in als deze afwijken van de standaardwaarden die zijn afgeleid van de Base URL.
7. Stel de Standaard valuta in die overeenkomt met de valuta die in uw advertenties wordt gebruikt.
8. Configureer de Standaard post-status (publish om voertuigen onmiddellijk zichtbaar te maken, draft om ze te beoordelen vóór publicatie).
9. Stel de Standaard post-auteur in op de WordPress gebruiker die als auteur van de voertuigberichten moet worden vermeld.
10. Configureer de instellingen voor de afbeeldingsimport: of afbeeldingen moeten worden geïmporteerd, het maximale aantal afbeeldingen per voertuig en WebP-conversieopties.
11. Vink de optie Standaardpagina's aanmaken aan om de plugin automatisch het voertuigarchief en de vergelijkingspagina's te laten aanmaken.
12. Klik op Instellingen opslaan.
13. Gebruik de verbindingstest op het tabblad Systeem & Hulp of Tools om te controleren of de API-inloggegevens werken.
14. Navigeer naar Import & Limieten en voer de eerste volledige import uit met behulp van de Batch-Wizard.

---

Het importschema configureren

WP-Cron (standaard)

WordPress heeft een ingebouwd cron-systeem (WP-Cron) dat wordt geactiveerd bij het laden van pagina's. Dit is voldoende voor veel sites, maar kan vertraging oplopen op sites met weinig verkeer.

1. Navigeer naar ADP Car Market Hub → Import & Limieten.
2. Schakel Automatische import in.
3. Kies het interval: elk uur, elke 6 uur, twee keer per dag, dagelijks of een aangepast interval (minimaal 15 minuten).
4. Stel voor dagelijkse en tweemaal daagse schema's de gewenste starttijd in.
5. Sla de automatiseringsinstellingen op.

Server-cron (aanbevolen voor productie)

Voor een betrouwbare planning configureert u een externe server-cron om het REST-eindpunt van de plugin aan te roepen:

1. Navigeer naar ADP Car Market Hub → Import & Limieten.
2. Stel Cron-modus in op Server-cron.
3. Kopieer de weergegeven cron-eindpunt-URL (bevat een beveiligingstoken).
4. Voeg een cron-taak toe op uw server (bijvoorbeeld met behulp van crontab) om deze URL met het gewenste interval aan te roepen met behulp van curl of wget.
5. Als u het token opnieuw moet genereren (bijvoorbeeld na een beveiligingsincident), klikt u op Token opnieuw genereren op hetzelfde tabblad en werkt u uw server-cron-taak bij met de nieuwe URL.

Importvergrendeling

De plugin gebruikt een tijdelijke vergrendeling op basis van transients (ongeveer 40 minuten) om overlappende importruns te voorkomen. Als er al een importrun bezig is en er komt een tweede trigger binnen (van WP-Cron, server-cron of een handmatige trigger), wordt de tweede run overgeslagen. Dit is normaal gedrag.

---

Afbeeldingsimports beheren

• Wachtrijmodus voor afbeeldingen: Tijdens geplande cron-imports wordt alleen de eerste afbeelding per voertuig onmiddellijk gedownload. De overige afbeeldingen worden ongeveer elke 5 minuten verwerkt door een achtergrondwachtrij-worker. Dit voorkomt PHP-timeout-fouten tijdens grote imports.
• Bewaking van de afbeeldingenwachtrij: Het tabblad Systeem & Hulp toont de huidige grootte van de afbeeldingenwachtrij en een waarschuwing als de wachtrij groter is dan 1.000 items.
• Handmatige wachtrijverwerking: Gebruik de knop Afbeeldingenwachtrij nu uitvoeren op het tabblad Systeem & Hulp om de wachtrij onmiddellijk te verwerken.
• Afbeeldingenwachtrij wissen: De knop Afbeeldingenwachtrij wissen op hetzelfde tabblad verwijdert alle openstaande afbeeldingstaken zonder ze te verwerken. Gebruik dit met voorzichtigheid.
• WebP-conversie: Indien ingeschakeld, worden gedownloade afbeeldingen geconverteerd naar het WebP-formaat met behulp van GD of Imagick. Het tabblad Systeem & Hulp laat zien of deze extensies beschikbaar zijn.

---

Volledige synchronisatie

Volledige synchronisatie is een instelling op het tabblad Import & Limieten die, indien ingeschakeld, permanent elk voertuigbericht in WordPress verwijdert dat niet langer aanwezig is in de live AutoScout24-advertenties voor de geconfigureerde verkoper(s).

Gebruik Volledige synchronisatie alleen als u wilt dat WordPress de live AutoScout24-voorraad exact weerspiegelt. Indien ingeschakeld:

• Elk lokaal voertuigbericht dat niet in de huidige externe lijst wordt gevonden, wordt permanent verwijderd, inclusief alle bijgevoegde afbeeldingen.
• Dit geldt ook voor voertuigen die handmatig zijn bewerkt, zijn verrijkt met aanvullende inhoud of de status concept hebben gekregen.
• De verwijdering wordt geregistreerd in het logbestand van de plugin.

Schakel Volledige synchronisatie uit als u voertuigen in WordPress wilt behouden, zelfs nadat ze uit AutoScout24 zijn verwijderd.

---

Systeemstatusbewaking

Het tabblad Systeem & Hulp biedt een uitgebreid overzicht van de serveromgeving en de status van de plugin. Controleer dit regelmatig om mogelijke problemen te identificeren voordat ze de imports beïnvloeden.

Belangrijke controles:

Statusindicatoren gebruiken een stoplichtsysteem: groen (OK), geel (waarschuwing), rood (probleem).

---

Logboekbewaking

Het tabblad Logs toont het activiteitenlogboek van de plugin.

• Het logboek registreert API-aanroepen, token-aanvragen, importacties, afbeeldingsdownloads, fouten en waarschuwingen.
• De panelen Recente fouten en Recente waarschuwingen bovenaan het tabblad Logs lichten de nieuwste fouten en waarschuwingen uit de laatste 2.000 logregels uit.
• De Log Viewer toont de laatste N regels van het volledige logbestand (configureerbaar, 100–2.000 regels).
• Het logbestand wordt automatisch geroteerd wanneer het 10 MB bereikt.
• Om het logbestand handmatig te wissen, klikt u op de knop Logbestand wissen. Dit is onomkeerbaar.
• Uitgebreide logboekregistratie (indien ingeschakeld in de instellingen) schrijft details per voertuig en per afbeelding naar het logboek. Schakel uitgebreide logboekregistratie uit in productieomgevingen als het logboek te snel groeit.

---

Diagnostische export

Het tabblad Tools bevat een functie voor Diagnostische export. Hiermee wordt een JSON-bestand gegenereerd met daarin:

• Plugin-versie
• WordPress-versie
• PHP-versie
• Site-URL
• Grootte en pad van het logbestand
• Samenvatting van de systeemomgeving

Wanneer u contact opneemt met de ondersteuning, exporteert u dit bestand en deelt u het met uw ondersteuningsteam. Deel het onbewerkte logbestand niet openbaar, aangezien het API-URL's en advertentie-identificaties kan bevaten.

---

---

Managing features

De meeste optionele functies worden in- of uitgeschakeld via het scherm Settings in plaats van via een speciaal tabblad "Features". Open Car Market Hub → Settings en gebruik de kaarten Frontend Features en Admin Features om individuele functies in of uit te schakelen. Wijzigingen worden direct na het opslaan van kracht. Beschikbare schakelaars zijn onder andere:

• Schema.org gestructureerde data en Open Graph meta tags
• Knoppen voor delen op sociale media
• Favorieten / Verlanglijst
• Voertuigvergelijking
• PDF datasheet
• Sitemap-integratie
• Dashboard-widget
• Lazy loading
• Bulkacties
• Export
• REST API
• Analytics tracking
• Financieringscalculator (met configureerbare rentevoet, looptijd en aanbetaling)
• Proefrit boeken
• AI Assistant

Het uitschakelen van een functie verwijdert de functionaliteit van zowel de frontend als de admin zonder opgeslagen gegevens te verwijderen. Zie de Settings-referentie voor de volledige lijst met schakelaars.

Uitgaande webhook-URL's (nieuwe lead, nieuwe import) en het webhook-geheim worden geconfigureerd op het scherm Leads — zie de Leads-referentie. De schakelaar voor de PDF datasheet-functie bevindt zich op Settings, terwijl de sjablonen en branding hiervan worden beheerd in de PDF Manager (zie de PDF Manager-referentie).

De AI Assistant en Content Studio zijn niet op dezelfde manier eenvoudige aan/uit-schakelaars. De AI Assistant wordt geconfigureerd op zijn eigen scherm CMH Center → AI Assistant, en Content Studio is een aparte werkruimte onder CMH Center → Content Studio. Deze operationele gebieden kunnen ook een actieve plugin-licentie vereisen voordat ze kunnen worden gebruikt; zolang de plugin hiervoor geen licentie heeft, wordt het scherm vervangen door een melding "licentie vereist" en blijven bestaande gegevens onaangetast.

---

Managing the CMH Team

CMH Team is een apart menu op het hoogste niveau voor door de plugin beheerde verkoopcontacten van de dealer. Teamleden worden volledig binnen de plugin opgeslagen (er is geen WordPress-gebruikersaccount vereist) en kunnen worden weergegeven op detailpagina's van voertuigen en worden gebruikt als de voorkeursontvanger voor leads.

Het CMH Team-menu biedt de volgende schermen:

Hoe een contactpersoon voor een bepaald voertuig wordt bepaald: een handmatig toegewezen contactpersoon per auto heeft voorrang, daarna de standaardlocatie/verkoper en tot slot de wereldwijde standaard. Handmatige keuzes (handmatig, algemeen, geen) worden nooit overschreven door de importeur; automatische toewijzingen kunnen bij de import worden vernieuwd. Zie CMH Team en contactroutering voor de volledige referentie, en Werkstroom voor leadbeheer voor de manier waarop CMH Team invloed heeft op de routering van leadmeldingen.

---

Managing leads

Klantcontact- en proefritaanvragen worden opgeslagen als WordPress custom posts (as24ci_lead) en weergegeven op het tabblad Leads.

Verantwoordelijkheden van de beheerder:

• Configureer het e-mailadres van de ontvanger voor leadmeldingen (tabblad Leads).
• Controleer periodiek de leadstatussen en werk deze bij naar Contacted, Closed of Spam indien van toepassing.
• Exporteer leads naar CSV voor CRM-import of archivering.
• Verwijder verouderde of spam-leads van het tabblad Leads.

Opmerking: Lead-postrecords worden opgeslagen in WordPress. Als Delete data on uninstall is ingeschakeld in de Settings, worden deze records permanent verwijderd wanneer de plugin wordt gedeïnstalleerd.

---

Uninstall and cleanup

Het tabblad Settings bevat een optie Delete data on uninstall. Wanneer dit is ingeschakeld:

• Zal het deïnstalleren van de plugin via WordPress Admin → Plugins permanent alle geïmporteerde voertuigposts, leadposts, geïmporteerde afbeeldingen en plugin-opties verwijderen.

Wanneer deze optie is uitgeschakeld (de standaardinstelling), laat het deïnstalleren van de plugin alle gegevens achter in WordPress. U kunt de plugin dan opnieuw installeren en de werking hervatten zonder gegevensverlies.

Schakel deze optie alleen in als u een volledige verwijdering beoogt. Dit kan niet ongedaan worden gemaakt zodra de deïnstallatie is voltooid.

---

Support coordination

Wanneer een probleem moet worden geëscaleerd naar AutoScout24 of uw integratiepartner:

1. Controleer het tabblad Logs op relevante foutmeldingen en noteer de tijdstempel.
2. Exporteer het Diagnostics-bestand van het tabblad Tools.
3. Noteer de plugin-versie (weergegeven in de plugin-lijst en het tabblad System & Help) en de WordPress- en PHP-versies.
4. Controleer of de API-verbindingstest slaagt (System & Help → verbindingstest).
5. Verstrek al het bovenstaande aan uw supportcontact. Deel de onbewerkte Client Secret niet.

---

Troubleshooting

---

Related documents

• Gebruikershandleiding
• Dagelijkse werkstromen
• Werkstroom voor voertuigimport
• Werkstroom voor leadbeheer