Documentatie · Overzicht
Productoverzicht
Dit document introduceert de ADP Car Market Hub WordPress-plugin: wat het doet, voor wie het is bedoeld en hoe het past binnen een typische dealerwebsite.
Wanneer u dit document moet gebruiken
Lees dit document wanneer u de plugin voor het eerst evalueert, wanneer u een korte samenvatting nodig heeft om te delen met een collega of belanghebbende, of wanneer u wilt controleren of een specifieke use case binnen de scope valt voordat u de gedetailleerde secties leest.
Overzicht
ADP Car Market Hub verbindt een WordPress-site met de voertuigvoorraad van een dealer en zet deze om in native WordPress-content. Voertuigen kunnen afkomstig zijn uit verschillende gegevensbronnen — de officiële AutoScout24 API, de carcuro API, een automatische feed, een e-mailbox of een eenmalige bestandsupload vanuit uw dealersoftware (DMS) — allemaal verbonden vanaf één enkele Universal Import-pagina. Geïmporteerde advertenties worden opgeslagen als een custom post type (as24ci_car), verrijkt met taxonomieën voor voertuigkenmerken, en weergegeven via de templates, shortcodes en beheerfunctionaliteiten van de plugin.
De plugin is ontworpen voor autodealers en dealergroepen, inclusief partijen die al toegang hebben tot de AutoScout24 of carcuro API. De plugin scraped de openbare AutoScout24-website niet. Live API-gegevens worden opgehaald via de geconfigureerde eindpunten met inloggegevens die door uw provider zijn verstrekt.
Belangrijkste mogelijkheden:
- Importeer en synchroniseer voertuigadvertenties, afbeeldingen, uitrusting en prijzen uit meerdere gegevensbronnen (AutoScout24, carcuro, feed, e-mail of bestandsupload), verbonden en voorzien van inloggegevens op de Universal Import-pagina.
- Plan terugkerende imports via WP-Cron of een externe systeem-cron met een met token beveiligde REST-trigger.
- Beheer voertuigen in de WordPress-beheeromgeving en presenteer ze op de frontend via de meegeleverde archief-, detail-, vergelijkings- en favoritentemplates.
- Leg leads vast via contactformulieren en proefritaanvragen en stuur ze door naar het geconfigureerde ontvangersadres.
- Beheer door de plugin beheerde verkoopcontacten van de dealer (CMH Team) die op voertuigpagina's worden getoond en worden gebruikt om leads door te sturen.
- Optionele add-ons voor door AI gegenereerde beschrijvingen, Content Studio-marketingteksten, zoekopdracht-alerts (Smart Stock Alerts), Analytics, een financieringscalculator, een PDF datasheet, Locaties, Market Insights en meer.
Doelgroep
- Dealermedewerkers en redacteuren — beheren voorraad, leads en de frontend-presentatie via de WordPress-beheeromgeving.
- Sitebeheerders — installeren, configureren en bedienen de plugin, inclusief inloggegevens, cron en integraties.
- Ontwikkelaars en integrators — breiden de plugin uit, bouwen aangepaste integraties of overschrijven templates (theme overrides).
Waar dit past in de documentatie
De Nederlandse documentatie is onderverdeeld in de volgende hoofdsecties:
- Aan de slag — installatie en eerste verbinding.
- Technische systeemvereisten — hosting-, PHP- en netwerkvereisten.
- Gebruikershandboek — dagelijkse redactionele werkstromen.
- Beheerdersreferentie — elk beheerscherm uitgelegd.
- Technische documentatie — architectuur, datamodel en intern gedrag.
- Integratiehandleiding — inloggegevens, server-cron, thema's en pagebuilders.
- Frontend-handleiding — wat bezoekers zien en hoe dit is opgebouwd.
- Exploitatie en onderhoud — de plugin in productie draaien.
- Privacy, beveiliging en naleving — gegevensverwerking, toestemming en toegangscontrole.
- Probleemoplossing — probleemgerichte oplossingen.
- Release-opmerkingen — wijzigingen per versie.
- Bijlagen — snelle naslagwerken voor shortcodes, instellingen, hooks en eindpunten.
- Ontwikkelaarsdocumentatie — uitbreidingspunten voor aangepaste code.
Buiten scope
- Het scrapen van HTML-pagina's van AutoScout24 of een andere derde partij.
- Dienen als vervanging voor een AutoScout24-dealercontract of API-toegang.
- Het hosten van de WordPress-site zelf; de plugin draait binnen een door de klant beheerde WordPress-installatie.
Operationele opmerkingen
- De plugin gebruikt de WordPress-optietabel om de configuratie op te slaan. Gevoelige geheimen zijn beveiligd in rust: geheimen van gegevensbronnen (het AutoScout24 API-clientgeheim, het carcuro-bedrijfstoken en de feed-/mailboxwachtwoorden) worden versleuteld opgeslagen via de geheime opslag van de plugin met behulp van geauthenticeerde AES-256-GCM-versleuteling (waarbij de sleutel is afgeleid van de WordPress-salts), en het cron-importtoken wordt opgeslagen als een eenrichtings-HMAC-SHA256-hash. Het onversleutelde cron-token wordt na het genereren slechts gedurende een kort venster in de beheeromgeving weergegeven. Databaseback-ups moeten nog steeds als gevoelig worden behandeld, omdat ze ook leads, instellingen en andere operationele gegevens bevatten.
- Optionele functies zoals de AI Assistant, Webhooks, Zoekopdracht-alerts en de openbare REST API zijn uitgeschakeld totdat een beheerder ze inschakelt.
- Gelokaliseerde beheerderslabels en vertaalbestanden worden met de plugin meegeleverd. De Engelse documentatie is de brontaal en kan voorzichtige bewoordingen gebruiken wanneer het gedrag afhangt van de configuratie van de klant. Controleer elk gedrag dat u voor klanten wilt publiceren tegen de huidige plugin-versie.