Documentatie · Gebruikershandleiding
Gebruikersworkflow voor de frontend
Dit document beschrijft hoe bezoekers omgaan met de voertuigvoorraad op de openbare (frontend) zijde van een WordPress-site die wordt aangedreven door de ADP Car Market Hub-plugin. Het behandelt de voertuigarchiefpagina, detailpagina's, filteropties, Favorieten, Vergelijken, contact- en proefritformulieren, de financieringscalculator, delen op sociale media, de PDF-datasheet en Zoekalerts.
Wanneer u dit document moet gebruiken
Lees dit document als u:
- Wilt begrijpen wat bezoekers zien en welke acties ze kunnen uitvoeren op de frontend.
- Frontend-functies configureert of test (filters, favorieten, vergelijken, formulieren, enzovoort).
- Moet controleren of de frontend de voorraad correct weergeeft na een import.
- Shortcodes integreert in WordPress-pagina's.
Zie de Beheerdershandleiding voor de configuratie van deze functies door de beheerder.
Overzicht
De plugin geeft de voertuigvoorraad weer op de WordPress-frontend met behulp van een speciaal aangepast berichttype (as24ci_car) en een set ingebouwde templates. De belangrijkste frontend-gebieden zijn:
- Voertuigarchiefpagina — een gepagineerd raster van alle gepubliceerde voertuigkaarten.
- Voertuigdetailpagina — de volledige informatie van een afzonderlijk voertuig.
- Vergelijkingspagina — een zij-aan-zij vergelijking van geselecteerde voertuigen.
- Favorietenpagina — een lijst met voertuigen die de bezoeker heeft opgeslagen.
Deze pagina's kunnen worden aangeboden via de WordPress CPT-archief-URL, systeemeigen taxonomie-archief-URL's of WordPress-pagina's die plugin-shortcodes bevatten.
Vereisten of randvoorwaarden
- Er moet ten minste één voertuig zijn geïmporteerd en gepubliceerd (berichtstatus:
publish) voordat er iets op de frontend verschijnt. - Het voertuigarchief en de vergelijkings-/favorietenpagina's moeten gepubliceerde WordPress-pagina's zijn die de juiste shortcodes bevatten, of het WordPress CPT-archief moet toegankelijk zijn via uw permalinkstructuur.
- Functies zoals Favorieten, Vergelijken, Financieringscalculator, Proefrit, Delen op sociale media en Zoekalerts moeten zijn ingeschakeld voordat ze op de frontend verschijnen. De schakelaars voor Favorieten en Vergelijken bevinden zich op het tabblad Instellingen (en in de Setup Wizard); Delen op sociale media wordt geconfigureerd onder Ontwerp & Stijlen; Zoekalerts worden beheerd op het speciale tabblad Zoekalerts; Proefritboeking en de Financieringscalculator worden respectievelijk geconfigureerd op het tabblad Leads en de sectie voor financieringsinstellingen. Controleer de huidige plaatsing in de geïnstalleerde plugin-versie, aangezien de admin-lay-out tussen releases kan veranderen.
- Voor de Proefrit-functie moeten de beschikbare weekdagen, het tijdsvenster, de duur van de tijdsloten en (optioneel) uitsluitingsdata worden geconfigureerd op het tabblad Leads.
Voertuigarchiefpagina
Weergave
De archiefpagina toont gepubliceerde voertuigen als een raster op basis van kaarten. Elke kaart toont:
- Voertuigafbeelding (thumbnail).
- Conditiebadge (Nieuw, Gebruikt, Aanbieding of Topdeal — configureerbaar in Ontwerp & Stijlen).
- Voertuigtitel (merk, model, uitvoering).
- Belangrijkste specificaties (bouwjaar, kilometerstand, brandstoftype, vermogen).
- Prijs.
- Favorieten-hartjesknop (als de Favorieten-functie is ingeschakeld).
- Vergelijkingsknop (als de Vergelijkingsfunctie is ingeschakeld).
- Link naar de voertuigdetailpagina.
Het aantal voertuigen per pagina is configureerbaar (12, 24, 48, 72 of alle) en kan worden gewijzigd via de selector voor het aantal per pagina in de filter-zijbalk of werkbalk.
Shortcode
Het archief kan op elke WordPress-pagina worden ingesloten met behulp van:
[as24ci_archive]De shortcode ondersteunt optionele filterattributen om instellingen te overschrijven, bijvoorbeeld:
[as24ci_archive make="BMW" per_page="12"]Sortering
Wanneer het sorteerfilter is ingeschakeld, kunnen bezoekers voertuigen sorteren op:
- Nieuwste eerst (standaard: op import-/publicatiedatum, aflopend)
- Prijs: laag naar hoog
- Prijs: hoog naar laag
- Kilometerstand: laag naar hoog
- Bouwjaar: nieuwste eerst
- Bouwjaar: oudste eerst
Controleer de exacte sorteeropties die beschikbaar zijn in uw plugin-versie.
Archieffilters
De filter-zijbalk op de archiefpagina stelt bezoekers in staat om de voertuiglijst te verfijnen. Elk filter kan afzonderlijk worden in- of uitgeschakeld in ADP Car Market Hub → Lay-outbeheer.
Standaardfilters
| Filter | Beschrijving |
|---|---|
| Merk | Merk/fabrikant (gebruikt as24ci_brand taxonomie) |
| Model | Modelnaam (gebruikt as24ci_model taxonomie) |
| Carrosserie | Carrosserievorm (gebruikt as24ci_body_type taxonomie) |
| Brandstof | Brandstoftype (gebruikt as24ci_fuel_type taxonomie) |
| Transmissie | Type versnellingsbak (gebruikt as24ci_transmission taxonomie) |
| Aandrijving | Type aandrijving (gebruikt as24ci_drive taxonomie) |
| Conditie | Nieuw / Gebruikt / Overig (gebruikt as24ci_condition taxonomie) |
| Exterieurkleur | Lakkleur exterieur (gebruikt as24ci_ext_color taxonomie) |
| Prijsbereik | Minimale en maximale prijs (numeriek bereik) |
| Kilometerstand | Minimale en maximale kilometerstand (numeriek bereik) |
| Bouwjaar | Minimaal en maximaal jaar van eerste toelating |
| Zoeken op trefwoord | Tekstzoekopdracht in voertuigtitel en -beschrijving |
Geavanceerde filters
| Filter | Beschrijving |
|---|---|
| Interieurkleur | Interieurkleur (gebruikt as24ci_int_color taxonomie) |
| Energielabel | Energie-efficiëntielabel A–G (gebruikt as24ci_energy_label taxonomie) |
| Cilinderinhoud | Bereik van de cilinderinhoud in cc |
| Deuren | Minimaal en maximaal aantal deuren |
| Zitplaatsen | Minimaal en maximaal aantal zitplaatsen |
| Locatie | Filter voor dealerlocatie |
Filters toepassen
Filters worden toegepast via URL-queryparameters. Het selecteren van een filteroptie herlaadt of updatet het archief met de gefilterde resultaten. Meerdere filters kunnen worden gecombineerd. Het wissen van een filter verwijdert deze uit de query.
Voertuigdetailpagina
Een voertuigdetailpagina is de weergave van een afzonderlijk voertuig waarop de volledige informatie van de advertentie wordt getoond.
Inhoudssecties
| Sectie | Beschrijving |
|---|---|
| Fotogalerij | Raster- of slider-lay-out (configureerbaar). Ondersteunt lightbox indien ingeschakeld. |
| Broodkruimels | Navigatiepad dat de route naar het archief toont |
| Voertuigtitel en prijs | Prominent weergegeven; valuta geformatteerd volgens de lokale instellingen |
| Conditiebadge | Toont Nieuw / Gebruikt / Aanbieding / Topdeal |
| Specificatietabel | Alle gekoppelde voertuigkenmerken: kilometerstand, registratie, motor, vermogen, transmissie, brandstof, carrosserie, kleur, deuren, zitplaatsen, emissies en meer |
| Uitrustingslijst | Uitrusting en functies overgenomen uit de AutoScout24-advertentie |
| Beschrijving | Voertuigbeschrijvingstekst (geïmporteerd uit de API of gegenereerd door de AI Assistant) |
| Contact- / verkoperskaart | Het verkoopcontact van de dealer dat aan dit voertuig is gekoppeld (naam, foto, e-mail en telefoon), getoond wanneer een CMH Team-contact is geconfigureerd. Zie CMH Team hieronder. |
| Contactformulier | Ingebouwd aanvraagformulier (zie Contactformulier hieronder) |
| Financieringscalculator | Schatting van de maandelijkse betaling (indien ingeschakeld) |
| Proefritformulier | Boekingsformulier voor proefritten (indien ingeschakeld) |
| Social sharing-knoppen | Deellinks voor WhatsApp, Facebook, Instagram, X/Twitter, e-mail en link kopiëren (indien ingeschakeld) |
| PDF-datasheet-knop | Link om een voor printen geoptimaliseerde voertuigdatasheet te openen |
| Favorietenknop | Voeg het voertuig toe aan of verwijder het uit de favorietenlijst van de bezoeker |
| Vergelijkingsknop | Voeg het voertuig toe aan of verwijder het uit de vergelijkingsselectie |
De specifieke velden die in de specificatietabel worden weergegeven, worden beheerd via de instellingen op het tabblad Mapping, waar elk veld kan worden getoond of verborgen en het label kan worden aangepast.
Contactformulier
Het ingebouwde contactformulier wordt op elke voertuigdetailpagina weergegeven en stelt bezoekers in staat een aanvraag over het voertuig te sturen.
Velden
- Naam — verplicht.
- E-mail — verplicht. Moet een geldig e-mailadres zijn.
- Telefoon — optioneel (in- of uitschakelen in de Leads-instellingen).
- Bericht — optioneel (in- of uitschakelen in de Leads-instellingen).
- Toestemmingsvinkje — optioneel (inschakelen en configureren in de Leads-instellingen). Indien ingeschakeld, moet de bezoeker het vakje aanvinken alvorens te verzenden.
Spam en snelheidsbeperking
- Honeypot: er is een verborgen veld opgenomen in het formulier. Geautomatiseerde bots vullen dit meestal in; wanneer het is ingevuld, wordt de inzending geruisloos geweigerd zonder een lead aan te maken of een e-mail te sturen.
- Snelheidsbeperking (rate limiting): er worden maximaal 5 inzendingen per IP-adres per 5 minuten geaccepteerd. Inzendingen boven deze drempel ontvangen een foutmelding.
Na verzending
- De bezoeker wordt teruggestuurd naar het
#as24ci-contact-anker op de voertuigpagina met een succes- of foutmelding. - Een succesbericht bevestigt dat de aanvraag is ontvangen.
- Er wordt een foutmelding getoond als de verzending is mislukt (bijvoorbeeld als een verplicht veld ontbreekt of de snelheidslimiet is overschreden).
De succes- en foutmeldingen zijn configureerbaar in de Leads-instellingen.
CMH Team-contactkaart
Wanneer er een verkoopcontact van de dealer is geconfigureerd in CMH Team, toont de voertuigdetailpagina die persoon als contactpersoon voor de advertentie.
- De kaart toont de naam van het contact en (indien verstrekt) de foto, het e-mailadres en het telefoonnummer, met klik-om-te-mailen en klik-om-te-bellen links.
- Het getoonde contact is degene die is gekoppeld aan het specifieke voertuig: een contact dat rechtstreeks aan de auto is toegewezen heeft voorrang, daarna het contact dat is ingesteld voor de locatie van de auto, en vervolgens het wereldwijde standaardcontact.
- Als er geen CMH Team-contact van toepassing is, valt de pagina terug op de verkoperprofielgegevens van de auteur van het voertuig.
- Hetzelfde gekoppelde contact wordt ook gebruikt als de voorkeursontvanger voor aanvragen die via het contactformulier worden ingediend (zie Leadbeheer-werkstroom).
Beheerders beheren deze contacten onder het menu CMH Team; zie de Beheerdershandleiding.
Proefrit boeken
Wanneer de Proefrit-functie is ingeschakeld, is er een boekingsformulier voor proefritten beschikbaar op elke voertuigdetailpagina (vaak weergegeven als een tabblad naast het contactformulier).
Hoe het werkt
- De bezoeker selecteert een datum uit een datumkiezer. Data in het verleden en data die vallen op een dag die niet als beschikbaar is geconfigureerd, kunnen niet worden geselecteerd.
- Op basis van de geselecteerde datum worden de beschikbare tijdsloten dynamisch geladen. Sloten worden gegenereerd op basis van de geconfigureerde starttijd, eindtijd en duur van het slot (bijvoorbeeld 09:00–17:00 in intervallen van 30 minuten).
- De bezoeker selecteert een tijdslot en vult zijn naam, e-mailadres en optioneel telefoonnummer in.
- Bij verzending wordt een proefritaanvraag aangemaakt als een lead met
is_test_drive = 1en het veldappointment_dateingevuld. - De standaard e-mailnotificaties worden verzonden (waarbij "Proefritaanvraag" in het onderwerp en de tekst wordt aangegeven).
Configuratie (voor beheerders)
- Beschikbare weekdagen — op welke dagen van de week proefritten mogelijk zijn (maandag tot en met zondag).
- Starttijd / Eindtijd — het dagelijkse tijdsvenster voor tijdsloten (bijvoorbeeld 08:00–18:00).
- Duur tijdslot — lengte van elk tijdslot in minuten (minimaal 5 minuten).
- Uitsluitingsdata — specifieke data (ingevoerd als
YYYY-MM-DD, één per regel) waarop geen proefritten beschikbaar zijn, ongeacht de instelling voor de weekdagen.
Financieringscalculator
Wanneer de Financieringscalculator-functie is ingeschakeld, wordt er een interactieve schatting van de maandelijkse betaling getoond op de voertuigdetailpagina's.
De calculator maakt gebruik van:
- Voertuigprijs uit de geïmporteerde advertentie.
- Rentevoet — configureerbare standaardwaarde (tabblad Leningen in de Functies-instellingen).
- Looptijd lening — configureerbare standaardwaarde in maanden (12, 24, 36, 48, 60, 72 of 84 maanden).
- Aanbetaling — configureerbare standaardwaarde als percentage van de voertuigprijs.
Bezoekers kunnen de rente, looptijd en aanbetaling aanpassen om verschillende betalingsschattingen te zien. Het resultaat is een berekend maandelijks termijnbedrag dat op de pagina wordt weergegeven. Deze calculator is uitsluitend bedoeld ter illustratie; de werkelijke financieringsvoorwaarden zijn afhankelijk van de financiële aanbieder van de klant.
Favorieten (Verlanglijst)
Wanneer de functie Favorieten is ingeschakeld, kunnen bezoekers voertuigen opslaan in een persoonlijke verlanglijst.
Hoe het werkt
- Er verschijnt een knop met een hart-icoon op elke voertuigkaart in het archief en op de detailpagina van het voertuig.
- Door op het hartje te klikken, wordt het voertuig toegevoegd aan de favorieten van de bezoeker. Nogmaals klikken verwijdert het voertuig.
- Favorieten worden opgeslagen in de browser van de bezoeker (
localStorage). Er is geen login of account vereist. - Favorieten zijn apparaat- en browserspecifiek — ze worden niet gesynchroniseerd tussen apparaten of browsers en worden gewist als de bezoeker zijn browseropslag wist.
- Er kunnen maximaal 50 voertuigen tegelijk in de favorieten worden opgeslagen.
Favorietenpagina
Integreer de favorietenpagina op elke WordPress pagina met behulp van de shortcode:
[as24ci_favorites]De pagina haalt de voertuiggegevens voor de opgeslagen ID's op via een REST API-endpoint en rendert een lijst met de geconfigureerde velden. De zichtbare velden zijn configureerbaar in de Layout Manager (Favorietenzone).
Voertuigen vergelijken
Wanneer de vergelijkingsfunctie is ingeschakeld, kunnen bezoekers meerdere voertuigen selecteren voor een zij-aan-zij vergelijking.
Hoe het werkt
- Er verschijnt een Vergelijken-knop op de archiefkaarten en op de zwevende actiebalk van de detailpagina van het voertuig.
- Door op de knop te klikken, wordt het voertuig in of uit de vergelijkingsselectie geschakeld.
- De geselecteerde voertuigen worden opgeslagen in
localStorage. Er is geen login vereist. - Het maximale aantal voertuigen dat tegelijkertijd kan worden vergeleken is configureerbaar (standaard: 4). Wanneer het maximum is bereikt, wordt de bezoeker hiervan op de hoogte gesteld via een melding.
- Een zwevende balk of indicator toont doorgaans hoeveel voertuigen er zijn geselecteerd en biedt een link naar de vergelijkingspagina.
Vergelijkingspagina
De vergelijkingspagina wordt gerenderd door de shortcode:
[as24ci_compare]Deze pagina toont de geselecteerde voertuigen in een zij-aan-zij tabel om specificaties eenvoudig te kunnen vergelijken. Als er geen voertuigen zijn geselecteerd, wordt er een instructieve melding getoond.
Social sharing
Wanneer Social Sharing is ingeschakeld, verschijnt er een rij met deelknoppen op de detailpagina's van voertuigen. Er worden geen externe JavaScript SDK's geladen — alle knoppen zijn standaard links op basis van URL's.
Ondersteunde netwerken
- WhatsApp — opent het WhatsApp-deelscherm.
- Facebook — opent het Facebook-deelscherm.
- Instagram — Instagram ondersteunt geen direct delen via web-URL's; het gedrag van de knop voor Instagram kan variëren. Controleer dit in de huidige plugin-versie.
- X (voorheen Twitter) — opent het X/Twitter-opstelscherm met de voertuig-URL vooraf ingevuld.
- E-mail — opent de standaard e-mailclient van de bezoeker met een vooraf ingevuld onderwerp en bericht.
- Link kopiëren — kopieert de voertuig-URL naar het klembord van de bezoeker.
Individuele netwerken kunnen worden in- of uitgeschakeld in de Features-instellingen. De plaatsing (bijvoorbeeld boven of onder de beschrijving) is ook configureerbaar.
PDF datasheet
Wanneer de functie PDF Datasheet is ingeschakeld, kunnen bezoekers een voor printen geoptimaliseerde HTML-pagina voor elk voertuig openen en vervolgens de functie Afdrukken → Opslaan als PDF van hun browser gebruiken om een PDF-document te maken.
De datasheet-pagina is toegankelijk door de queryparameter ?as24ci_pdf={post_id} toe te voegen aan de voertuig-URL. Een knop of link om dit te activeren is doorgaans opgenomen op de detailpagina van het voertuig wanneer de functie is ingeschakeld.
Configureerbare velden
De volgende velden kunnen worden opgenomen of uitgesloten in de datasheet (configureerbaar door beheerders):
Voertuigtitel, prijs, kilometerstand, eerste registratie, brandstoftype, transmissie, vermogen, carrosserievorm, exterieurkleur, deuren, zitplaatsen, emissieklasse, CO2-waarden, energieverbruik, uitrustingslijst, beschrijving, locatie en contactgegevens.
Zoekalerts (Smart Stock Alerts)
Wanneer de functie Zoekalerts is ingeschakeld, kunnen bezoekers zich abonneren op een opgeslagen zoekopdracht en een e-mailmelding ontvangen wanneer er een passend voertuig wordt geïmporteerd.
Hoe het werkt voor bezoekers
- Op de archiefpagina wordt, na het toepassen van een of meer filters, een formulier Zoekopdracht opslaan / Abonneren op alerts getoond.
- De bezoeker vult zijn e-mailadres in en verzendt het formulier.
- Er wordt een AVG-conforme Double-Opt-In bevestigingsmail verzonden. Het abonnement heeft de status In afwachting totdat de bezoeker op de bevestigingslink in de e-mail klikt.
- Na bevestiging wordt het abonnement Actief. Vanaf dit moment ontvangt de bezoeker een e-mailmelding telkens wanneer er een voertuig wordt geïmporteerd dat voldoet aan de opgeslagen filtercriteria.
- Elke e-mailmelding bevat een afmeldlink. Door hierop te klikken, wordt het abonnement op Inactief (afgemeld) gezet.
Meldingstrigger
Meldingen worden automatisch verzonden via de as24ci_vehicle_imported actie-hook, die telkens wordt geactiveerd wanneer een voertuig wordt aangemaakt of bijgewerkt tijdens een importrun. De plugin controleert alle actieve abonnementen en verzendt e-mails naar overeenkomende abonnees.
Beheerdersweergave
Actieve, in afwachting zijnde, gepauzeerde en afgemelde abonnementen worden weergegeven in het tabblad Search Alerts in het beheerpaneel. Beheerders kunnen abonnementen filteren, bekijken en verwijderen.
Operationele opmerkingen
- Filters zijn geïmplementeerd als URL-queryparameters. Bezoekers kunnen gefilterde weergaven opslaan als bladwijzer of URL's met toegepaste filters delen.
- Favorieten en Vergelijken maken gebruik van browser localStorage. Bij het wissen van de browseropslag of het gebruik van een ander apparaat/browser gaat de opgeslagen selectie verloren.
- Het contactformulier stuurt gegevens terug naar de huidige pagina met een succes- of foutqueryparameter. JavaScript is niet vereist voor het verzenden van het formulier; het formulier werkt met standaard HTML POST.
- De financieringscalculator is uitsluitend ter illustratie. Resultaten worden in de browser berekend op basis van de geconfigureerde standaardwaarden. Ze vormen geen bindend kredietaanbod.
- De beschikbaarheid van proefritten wordt aan de serverzijde geëvalueerd. De beschikbare datums en tijdsloten worden afgeleid van de geconfigureerde instellingen op het moment dat de pagina wordt geladen.
- Social sharing-links zijn pure HTML-ankers. Er worden geen trackingcookies of scripts van derden geladen. Het bijhouden van doorkliks is niet ingebouwd.
- De PDF datasheet is een door de browser gerenderde printpagina, geen door de server gegenereerd PDF-bestand. De afdrukkwaliteit en lay-out zijn afhankelijk van de browser en het besturingssysteem van de bezoeker.
- Zoekalert-e-mails worden verzonden via WordPress
wp_mail(), die gebruikmaakt van de e-mailconfiguratie van de server. Als de e-mailbezorging onbetrouwbaar is, overweeg dan om SMTP te configureren.
Probleemoplossing
| Symptoom | Waarschijnlijke oorzaak | Controleer |
|---|---|---|
| Er verschijnen geen voertuigen op de archiefpagina | Geen gepubliceerde voertuigen, of archiefpagina is niet geconfigureerd | Voer een import uit; controleer de Standaard post-status in de Instellingen; controleer of de archiefpagina bestaat en de shortcode of CPT-archief-URL gebruikt |
| Filters tonen geen resultaten na selectie | De geselecteerde waarde komt niet overeen met een taxonomie-term van een geïmporteerd voertuig | Controleer of er voertuigen met het geselecteerde attribuut zijn geïmporteerd; controleer de slugs van de taxonomie-termen |
| Favorietenpagina is leeg | Er zijn geen favorieten opgeslagen in de browser van de bezoeker, of de pagina gebruikt de verkeerde shortcode | Controleer of [as24ci_favorites] in de pagina-inhoud staat; controleer of de functie Favorieten is ingeschakeld |
| Vergelijkingspagina toont "geen voertuigen geselecteerd" | Er bevinden zich geen voertuigen in de vergelijkingsselectie | Ga naar het archief en klik eerst op Vergelijken bij voertuigen |
| Contactformulier toont een foutmelding na verzenden | Een verplicht veld ontbreekt, de limiet voor aanvragen is overschreden of de honeypot is geactiveerd | Controleer of naam en e-mailadres zijn ingevuld; wacht 5 minuten en probeer het opnieuw |
| Proefritslots zijn leeg voor de geselecteerde datum | De datum valt op een niet-beschikbare weekdag of is een uitgesloten datum | Controleer de configuratie van de Proefrit in het tabblad Leads |
| Financieringscalculator toont 0 of geen prijs | Voertuig heeft geen prijs in de geïmporteerde gegevens | Controleer of het voertuig een prijs heeft in de AutoScout24 advertentie; controleer de import |
| Knoppen voor social sharing zijn niet zichtbaar | De functie Social Sharing is uitgeschakeld | Schakel Social Sharing in bij Features; configureer de gewenste netwerken |
| Bevestigingsmail voor zoekalert niet ontvangen | Probleem met e-mailbezorging, of de e-mail is in de spambox beland | Controleer de WordPress e-mailbezorging; controleer de spambox; overweeg een SMTP-plugin |