Eerste installatie

Deze handleiding legt uit wat een WordPress-beheerder moet configureren na het activeren van de ADP Car Market Hub-plugin, en in welke volgorde. Het volgen van de aanbevolen volgorde voorkomt de meest voorkomende herstelwerkzaamheden — bijvoorbeeld het uitvoeren van een import voordat de API-verbinding is gevalideerd, of live gaan voordat de frontend is geverifieerd op een echte voertuigpagina.

Dit document behandelt de installatie-flow. Gedetailleerd referentiemateriaal voor elk beheerders-tabblad is beschikbaar in de sectie Beheerdersreferentie. Een specifieke referentie voor de in-plugin First Setup Wizard is te vinden in de Setup Wizard Reference.

First Setup Wizard

ADP Car Market Hub wordt geleverd met een First Setup Wizard die een beheerder in zeven beknopte stappen door de meest voorkomende configuratiekeuzes loodst. De eerste stap is licentie-activering, wat verplicht is: totdat een geldige licentie is geactiveerd, blijft elke operationele wizard-stap (en elk ander beheerders-tabblad van de plugin dan Instellingen) vergrendeld. Zodra de licentie actief is, zijn de resterende stappen het aanbevolen startpunt voor zowel demo-evaluaties als live AutoScout24-implementaties, maar ze zijn niet verplicht — elke optie die ze bieden kan ook handmatig worden geconfigureerd via de reguliere beheerders-tabbladen die zijn gedocumenteerd in de Beheerdersreferentie.

Wat de wizard doet

• Activeert uw licentie als eerste stap. De licentie ontgrendelt de premium-onderdelen van de plugin; zonder licentie kan de wizard niet verder gaan dan het licentiescherm en tonen de andere beheerders-tabbladen een "Licentie vereist"-scherm.
• Laat de beheerder kiezen tussen Demo-installatie (installeert demovoertuigen, past demo-standaardwaarden toe en schakelt analytics in zodat de Dashboard- en Analytics-pagina's gegevens hebben om weer te geven) en Live AutoScout24-installatie (slaat echte inloggegevens en geselecteerde pagina's op zonder demogegevens te installeren).
• Legt het dealerprofiel vast (naam, adres, contactgegevens, logo).
• Legt de AutoScout24-verbinding vast (Client ID, Client Secret, Seller ID, API Base URL).
• Maakt optioneel de openbare pagina's Auto's, Auto's vergelijken en Favorieten aan met de canonieke shortcodes.
• Schakelt de meest voorkomende standaardfuncties in of uit (social sharing, PDF-datasheet, PDF QR-code, gebruikskosten per 100 km, Vergelijken, Favorieten, Zoekalerts, Analytics-tracking).
• Markeert de installatie als voltooid en stuurt de beheerder terug naar het Dashboard.

Wanneer de wizard verschijnt

• Na de eerste activering van de plugin verschijnt er bovenaan elke WordPress-beheerpagina een melding met de titel Welkom bij ADP Car Market Hub.
• De melding is geen geforceerde omleiding — de beheerder kan doorgaan met browsen in WordPress en de wizard later starten.
• De melding wordt alleen getoond als al het volgende waar is:
• De huidige gebruiker heeft de beheerdersrechten van de plugin.
• Er is een tijdstempel van de eerste activering geregistreerd.
• De wizard is niet als voltooid gemarkeerd.
• De wizard is niet als overgeslagen gemarkeerd.
• Plugin-upgrades die geen nieuwe activering triggeren, tonen de melding niet op bestaande installaties.

Hoe de wizard te starten

• Klik op Start Setup Wizard in de welkomstmelding, of
• Open Car Market Hub → Dashboard en gebruik de link Run Setup Wizard bovenaan, of
• Open Car Market Hub → Tools en gebruik de kaart Setup Wizard.

De wizard is geregistreerd als een verborgen beheerpagina die bereikbaar is via wp-admin/admin.php?page=as24ci-setup-wizard. Rechten- en nonce-controles worden bij elke stap afgedwongen.

Hoe de wizard over te slaan

• Klik op Nu overslaan in de welkomstmelding. De melding verschijnt niet opnieuw bij het laden van volgende beheerpagina's.
• De wizard blijft bereikbaar via het Dashboard en het tabblad Tools, zodat deze op elk gewenst moment kan worden hervat.

Stappen van de wizard

1. Licentie — voer uw licentiecode in en activeer deze. Deze stap wordt als eerste afgedwongen; de wizard kan niet doorgaan naar een operationele stap totdat de licentie operationeel is. De licentiecode is write-only — deze wordt nooit vooraf ingevuld op het scherm.
2. Modus — kies Demo-installatie of Live AutoScout24-installatie; kies dealerland, valuta en beheerders-taal.
3. Dealerprofiel — naam, straat, postcode, plaats, land, telefoon, e-mail, website, logo.
4. AutoScout24 — Client ID, Client Secret, Seller ID en API Base URL. Het veld Client Secret wordt bewust leeg weergegeven (zie API-inloggegevens instellen).
5. Pagina's — kies voor elke openbare pagina (Auto's, Auto's vergelijken, Favorieten) voor Automatisch aanmaken, Bestaande pagina gebruiken of Overslaan.
6. Functies — schakel de hierboven genoemde standaardfuncties in of uit.
7. Voltooien — controleer de samenvatting en bevestig. In de Demo-modus triggert de laatste stap ook het installatieprogramma voor demogegevens; in de Live-modus slaat het alleen de instellingen van de wizard op.

Veiligheid voor bestaande installaties

• Plugin-activering plaatst alleen niet-destructieve standaardwaarden; het overschrijft nooit bestaande optiewaarden.
• Het deactiveren en opnieuw activeren van de plugin opent de wizard niet automatisch opnieuw en overschrijft geen instellingen.
• De wizard wijzigt alleen instellingen waarvan de beheerder de formuliervelden daadwerkelijk verzendt.
• Demo-installatie is het enige pad dat demogegevens installeert en door demo beheerde opties reset; dit is een expliciete reset- en seed-bewerking. De Live-installatie is niet-destructief met betrekking tot voertuigen en klantinstellingen.

Voor volledige details over vlaggen, rechten, de URL van de verborgen beheerpagina en het opslaggedrag van stappen, zie Setup Wizard Reference.

Wanneer u dit document moet gebruiken

Gebruik dit document als u:

• ADP Car Market Hub configureert op een nieuw geactiveerde installatie.
• De plugin opnieuw configureert na een servermigratie, heropbouw van de omgeving of staging-naar-productie-promotie.
• Een herhaalbaar on-boardingproces documenteert voor een nieuwe klantensite.

De doelgroep is een WordPress-beheerder die de Installatiehandleiding al heeft voltooid en toegang heeft tot de AutoScout24 API-inloggegevens die zijn verstrekt door het account van de dealer of hun integratiepartner.

Voordat u begint

Controleer het volgende voordat u met de configuratie begint:

• De plugin is geïnstalleerd en geactiveerd en het menu Car Market Hub verschijnt in het WordPress-beheerpaneel.
• De site voldoet aan alle punten op de Pre-installatie checklist.
• U heeft uw ADP Car Market Hub-licentiecode. De licentie is vereist om de premium-onderdelen van de plugin te ontgrendelen: totdat deze is geactiveerd, toont elk beheerders-tabblad behalve Instellingen een "Licentie vereist"-scherm en blijven imports, cron en de andere functies vergrendeld.
• U heeft de AutoScout24 API-inloggegevens die vereist zijn voor uw account: API Base URL, Seller ID(s), Client ID en Client Secret. Deze zijn afkomstig van het AutoScout24-account van de dealer of van de integratiepartner die de API-toegang beheert. De plugin levert deze niet zelf.
• U heeft beslissingen genomen over de standaard bedrijfswaarden die de configuratie zullen beïnvloeden: standaardvaluta, welke juridische/toestemmingstekst de dealer op contactformulieren wil hebben, en welke functies (Proefrit boeken, Zoekalerts, AI Assistant, Analytics) bij de lancering ingeschakeld moeten zijn.
• Er is een back-up van de WordPress-site gemaakt, en bij voorkeur wordt de configuratie uitgevoerd op een staging-omgeving die een kopie is van de productie-omgeving.

Aanbevolen installatievolgorde

De volgende tien stappen zijn de aanbevolen volgorde. Elke stap bouwt voort op de vorige. Sla geen stappen over — schakel bijvoorbeeld geen automatische imports in voordat de verbindingstest is geslaagd.

1. Licentie-activering
2. Systeemgereedheid
3. API-inloggegevens
4. Verbindingstest
5. Importinstellingen
6. Lay-out- en frontend-instellingen
7. Juridische, privacy- en toestemmingsinstellingen
8. Testimport
9. Frontend-validatie
10. Go-live checks

---

Stapsgewijze instructies

Stap 1 — Licentieactivering

Open Car Market Hub → Settings en vul de kaart License Activation bovenaan de pagina in. Voer uw licentiecode in en klik op Activate. Een succesvolle activering ontgrendelt de premium-onderdelen van de plugin; de overige beheertabbladen van Car Market Hub (behalve Settings) tonen niet langer het scherm "License required", en imports, cron en achtergrondverwerking worden beschikbaar.

De licentiecode is 'write-only': deze wordt na het opslaan nooit meer aan u getoond. Dezelfde kaart biedt ook de opties Check license (valideert de opgeslagen code opnieuw) en Remove license (wist de code met behoud van uw geïmporteerde voertuigen, pagina's en media). Als u bent begonnen met de First Setup Wizard, is licentieactivering de eerste stap, dus dit is dan al gedaan.

Ga niet verder voordat de licentie actief is. Zonder actieve licentie blijven de overige configuratietabbladen vergrendeld.

Stap 2 — Systeemgereedheid

Open Car Market Hub → System & Help en controleer de omgevingscontroles. De pagina rapporteert de status van PHP, JSON, OpenSSL, cURL, GD/Imagick, de uploads-map, de cron-planning, de token-cache, het logbestand en de afbeeldingenwachtrij met statusbadges in verkeerslichtkleuren.

Los eventuele rode badges op voordat u verdergaat. Typische acties zijn het inschakelen van een ontbrekende PHP-extensie, het herstellen van de rechten op de uploads-map of het oplossen van een niet-werkende WP-Cron.

Voor een diepgaandere controle van de omgeving raadpleegt u de Technische systeemvereisten en API-, netwerk- en SSL-vereisten.

Stap 3 — API-inloggegevens

Open Car Market Hub → Universal Import — de centrale hub voor alle gegevensbronnen — en klik op de rij AutoScout24 om deze uit te klappen. (In eerdere versies bevond deze verbinding zich onder Settings; deze is verplaatst naar Universal Import. Settings bevat nu alleen nog een beknopte verwijzingskaart Data sources & API connections met een knop Manage data sources die deze pagina opent.) Vul de AutoScout24-velden in:

• API Base URL — de volledige HTTPS-URL voor uw AutoScout24-omgeving of integratie-endpoint, inclusief https://.
• Seller ID — één of meer Seller IDs, gescheiden door komma's als u meerdere verkopersaccounts beheert.
• Client ID en Client Secret — de inloggegevens die zijn verstrekt voor uw API-toegang. De Client Secret wordt versleuteld opgeslagen via de beveiligde opslag van de plugin.

Sla de bron op. De statuspil verandert in Connected en er verschijnt een link Open Car Importer.

Als uw voorraad afkomstig is van een andere live bron zoals carcuro (een carcuro-bedrijfstoken), of van een automatische feed, e-mailbox of een eenmalige bestandsupload, verbind deze dan in plaats daarvan via dezelfde Universal Import-accordeon. De Default currency wordt apart geconfigureerd onder General Settings op Car Market Hub → Settings.

Een volledige handleiding voor elk inlogveld, waar het vandaan komt en hoe u er veilig mee omgaat, vindt u in de API-inloggegevens instellen en de Universal Import Reference. Voor achtergrondinformatie over het verkrijgen van API-toegang, zie AutoScout24 API Setup en External API Credentials.

Stap 4 — Verbindingstest

Valideer uw inloggegevens na het opslaan en vóór elke import. Open Car Market Hub → Tools en gebruik de kaart API Connection Test. Klik op Test Connection. Een succesvolle test bevestigt dat de plugin kan authenticeren bij het geconfigureerde token-endpoint en de AutoScout24-advertentie-API kan bereiken voor de eerste geconfigureerde Seller ID.

Ga niet verder met de importinstellingen totdat de verbindingstest slaagt. De volledige procedure, inclusief het interpreteren van het resultaat en het reageren op veelvoorkomende fouten, is gedocumenteerd in de Verbindingstest.

Stap 5 — Importinstellingen

Zodra de verbinding werkt, configureert u hoe voertuigen worden geïmporteerd. De relevante instellingen bevinden zich op twee plaatsen:

• Car Market Hub → Settings — afbeeldingsopties (of afbeeldingen moeten worden geïmporteerd, maximaal aantal afbeeldingen per voertuig, optionele WebP-conversie en kwaliteit), de standaard berichtstatus en auteur voor nieuw aangemaakte voertuigen, en de optie Default pages die bij het opslaan de pagina's Cars, Compare Cars en Favorites kan aanmaken.
• Car Market Hub → Import & Limits — planning en runtime-gedrag: het WP-Cron-interval (elk uur, elke 6 uur, tweemaal per dag, dagelijks of aangepast), de starttijd voor dagelijkse/tweemaal-dagelijkse planningen, de optionele Full Sync-modus (die lokale auto's verwijdert die niet langer aanwezig zijn op AutoScout24), en de cron-robuustheidsinstellingen (maximaal aantal voertuigen per cron-run, schakelaar voor de afbeeldingenwachtrij).

Kies voor de eerste installatie voor voorzichtige waarden:

• Laat automatische planning voorlopig uitgeschakeld. Plan deze pas in na een succesvolle testimport.
• Houd de afbeeldingenwachtrij ingeschakeld, zodat cron-runs de PHP-time-outs niet overschrijden.
• Laat Full Sync uitgeschakeld totdat u hebt gecontroleerd of alle verwachte voertuigen correct binnenkomen. Full Sync verwijdert permanent lokale berichten, inclusief afbeeldingen, voor elke advertentie die niet door de API wordt geretourneerd.

Voor externe cron (op serverniveau), inclusief het met een token beveiligde REST-endpoint, zie Server Cron Setup.

Stap 6 — Lay-out- en frontend-instellingen

Configureer hoe voertuigen op de frontend worden gepresenteerd voordat u ze aan bezoekers toont:

• Car Market Hub → Design & Styles — kleuren, lettertypen, archief- en detailpagina-lay-outs, galerij-lay-out, lightbox, conditiebadges en intro-/footertekst op archiefpagina's.
• Car Market Hub → Layout Manager — in-/uitschakelen van individuele filters die op het auto-archief verschijnen (merk, model, jaar, prijs, kilometerstand, brandstof, versnellingsbak, kleur, carrosserievorm en andere).
• Car Market Hub → Mapping — beheer de menselijk leesbare labels en de zichtbaarheid van elk AutoScout24-gegevensveld op detailpagina's. De standaardwaarden zijn verstandig gekozen; pas alleen de labels of zichtbaarheid aan die u daadwerkelijk wilt wijzigen.
• Car Market Hub → Shortcodes & Widgets — de referentie voor shortcodes die worden gebruikt in aangepaste paginalay-outs (bijvoorbeeld de vergelijkings- en favorietenpagina's). Als u de optie Default pages in Settings hebt ingeschakeld, bestaan de bijbehorende pagina's al; plaats anders de shortcodes handmatig.

Stap 7 — Juridische, privacy- en toestemmingsinstellingen

ADP Car Market Hub verwerkt leadgegevens en, optioneel, abonnementen op zoekfilters. Configureer de bijbehorende instellingen voordat u live gaat:

• Car Market Hub → Leads — configureer het e-mailadres van de ontvanger, de zichtbare formuliervelden, het selectievakje voor toestemming (label en verplichte status) en de meldingsberichten. De toestemmingstekst en de zichtbare velden moeten overeenstemmen met het privacybeleid van de dealer.
• Car Market Hub → Leads — configureer op dit tabblad ook de opties voor Test Drive booking (beschikbare weekdagen, dagelijks tijdsbestek, duur van het tijdslot, uitgesloten datums). Car Market Hub → Search Alerts — als de functie Search Alerts is ingeschakeld op het tabblad Settings (of in de Setup Wizard), beheert u hier de abonnementen. Search Alerts maken gebruik van een AVG-conforme Double-Opt-In e-mailbevestiging; de e-mailsjablonen voor dealer- en klantmeldingen worden respectievelijk geconfigureerd op het tabblad Search Alerts en het tabblad Leads.
• Privacybeleid voor de hele site — de WordPress-site moet een gepubliceerd privacybeleid hebben dat de gegevens dekt die de plugin verzamelt (contactformuliergegevens, optionele analytics-gebeurtenissen, optionele abonnementen op zoekfilters).

Achtergrondinformatie is beschikbaar in Lead Data and Consent, Search Alerts Double Opt-In, GDPR / DSGVO Notes en het Data Storage Overview.

Stap 8 — Testimport

Voer een kleine, gecontroleerde import uit voordat u automatische planning inschakelt.

Twee veilige opties:

• Dry run. Open Car Market Hub → Tools en gebruik de kaart Dry Run. Deze haalt een voorbeeld van advertenties op voor de geconfigureerde Seller ID('s) zonder daadwerkelijk voertuigberichten aan te maken. Dit valideert of de inloggegevens echte gegevens bereiken zonder de site te wijzigen.
• Handmatige import via Car Importer. Open Car Market Hub → Car Importer. Bekijk het voorbeeld van de advertenties die door de API worden geretourneerd en start een import voor een of twee individuele voertuigen. Dit maakt echte as24ci_car-berichten aan en koppelt afbeeldingen, waardoor dit de snelste manier is om het volledige importtraject van begin tot eind te valideren.

Zodra een kleine import succesvol is, voert u een volledige handmatige import uit via de Batch-Wizard op Car Market Hub → Import & Limits. De Batch-Wizard draait in adaptieve batches met een voortgangsbalk en kan worden gepauzeerd, hervat of afgebroken.

Controleer achteraf het tabblad Logs om te bevestigen dat er geen waarschuwingen of fouten waren.

Stap 9 — Frontend-validatie

Valideer na de testimport de frontend met echte gegevens:

• Open de archiefpagina Cars (of de pagina waar het voertuigarchief is ingesloten). Controleer of de voertuigkaarten correct worden weergegeven, of afbeeldingen laden, of filters werken zoals geconfigureerd en of de paginering naar verwachting functioneert.
• Open ten minste één detailpagina van een voertuig. Controleer de galerij, de tabel met voertuigdetails, de uitrustingslijst, de prijsopmaak, het contactformulier (en het selectievakje voor toestemming) en eventuele optionele functies die u hebt ingeschakeld (financieringscalculator, proefritformulier, delen op sociale media).
• Verzend een testcontactformulier vanaf de detailpagina van het voertuig. Controleer of de lead verschijnt onder Car Market Hub → Leads en of de e-mail naar de ontvanger is afgeleverd.
• Als Search Alerts zijn ingeschakeld, voltooi dan één testabonnement inclusief de Double-Opt-In bevestigingsmail.
• Als de AI Assistant is ingeschakeld, controleer dan bij ten minste één voertuig of de door AI gegenereerde beschrijving (en andere AI-uitvoer die u hebt ingeschakeld) acceptabel is voor publicatie.

Los eventuele problemen op — labels, ontbrekende velden, lay-out — door het relevante tabblad aan te passen (Mapping, Design & Styles, Layout Manager, Leads, Settings) en opnieuw te valideren.

Stap 10 — Go-live controles

Bereid de site pas voor op livegang nadat de voorgaande stappen zijn voltooid:

• Schakel automatische imports in op Car Market Hub → Import & Limits met een verstandig interval (voor veel dealers is een uurschema geschikt; kleinere catalogi kunnen een dagelijks schema gebruiken). Op hosts die WP-Cron beperken, configureert u een echte server-cronjob die verwijst naar het met een token beveiligde REST-endpoint van de plugin, zoals beschreven in Server Cron Setup.
• Beslis of u Full Sync wilt inschakelen, zodat advertenties die op AutoScout24 zijn verwijderd, ook van de site worden verwijderd. Schakel dit pas in nadat u hebt gecontroleerd of alle verwachte voertuigen consistent in de import verschijnen.
• Voer de Verbindingstest nogmaals uit als laatste controle.
• Loop de Go-live checklist door om alle overige algemene punten af te vinken (DNS, caching, zichtbaarheid in zoekmachines, monitoring).

---

Configuratieredactie

• Instellingenpagina slaat alleen zichtbare kaarten op. De instellingenpagina groepeert opties in kaarten (Algemene instellingen, Gegevensbronnen & API-verbindingen, Standaardpagina's & Shortcodes, enz.) met elk een eigen Opslaan-knop. Sla de kaart op die u hebt bewerkt voordat u weggaat. API-inloggegevens staan niet langer op deze pagina; ze worden ingevoerd op Universal Import.
• Standaardpagina's. Als de optie Standaardpagina's is ingeschakeld en de bijbehorende pagina's nog niet bestaan, worden bij het opslaan van de instellingen automatisch de pagina's Cars, Compare Cars en Favorites aangemaakt. Als u deze pagina's handmatig beheert, laat u de optie uitgeschakeld en plaatst u de shortcodes van het tabblad Shortcodes & Widgets.
• Standaardvaluta. De standaardvaluta is alleen van invloed op nieuwe of bijgewerkte importen waarvoor de API geen valutawaarde retourneert. Bestaande berichten behouden hun opgeslagen valuta.
• Mapping vs. taxonomieën. Het tabblad Mapping regelt alleen de labels en zichtbaarheid van velden in detailtabellen. Het verandert niets aan de onderliggende WordPress taxonomieën die geïmporteerde attribuutwaarden opslaan. Het hernoemen van een Mapping-label verplaatst geen bestaande taxonomietermen.
• Afbeeldingenwachtrij. Wanneer de afbeeldingenwachtrij is ingeschakeld, downloaden cron-importen alleen de eerste afbeelding per voertuig synchroon; de overige afbeeldingen worden asynchroon verwerkt door een achtergrondworker. Dit is de aanbevolen standaard en voorkomt PHP-timeouts bij grote catalogi.
• Volledige synchronisatie is destructief. Volledige synchronisatie verwijdert permanent lokale voertuigberichten (inclusief afbeeldingen) voor advertenties die niet langer door de API worden geretourneerd. Behandel dit als een optie voor productieomgevingen en schakel deze pas in als de import stabiel is.

Operationele opmerkingen

• Eerst staging, dan productie. Alle configuratiestappen in dit document moeten eerst op een staging-kopie worden uitgevoerd. Zodra de dealer akkoord gaat met de werking op staging, repliceert u de configuratie op productie. Exporteer en importeer de volledige WordPress database niet tussen staging en productie, tenzij u de impact op URL's, opties en ID's begrijpt.
• Dagelijkse werking. Na de installatie worden de dagelijkse verantwoordelijkheden (importen controleren, leads verwerken, logs bekijken) behandeld in Dagelijkse werkstromen en de Gebruikershandleiding.
• Rechten en delegatie. De eerste installatie vereist een volledige WordPress beheerder. Voor lopende werkzaamheden voorziet de plugin in een gedelegeerde recht en rol, zodat dagelijkse gebruikers geen volledige WordPress beheerdersrechten nodig hebben. Zie Toegangscontrole en rechten.
• Logboekregistratie. Alle API-aanroepen, token-aanvragen, importacties en fouten worden met rotatie opgeslagen in de logbestanden van de plugin in wp-content/uploads/as24ci-logs/. Uitgebreide logboekregistratie (verbose) voegt details per voertuig en per afbeelding toe en mag alleen tijdelijk worden ingeschakeld voor probleemoplossing.

Probleemoplossing

Gerelateerde documenten

• Installatiehandleiding
• API-inloggegevens instellen
• Verbindingstest
• Go-live checklist
• Beheerdersreferentie voor de Car Importer
• Pre-installatie checklist
• Technische systeemvereisten
• API-, netwerk- en SSL-vereisten
• AutoScout24 API Setup
• Externe API-inloggegevens
• Server-cron instellen