Documentatie · Frontend-handleiding

Proefritaanvragen

Dit document behandelt de proefritboekingsfunctie van de ADP Car Market Hub WordPress Plugin: hoe deze integreert met het contactformulier, hoe tijdsloten worden berekend en hoe de functie wordt geconfigureerd.

Wanneer u dit document moet gebruiken

Lees dit document als u de proefritboekingsfunctie voor het eerst instelt, beschikbare dagen en tijdsloten configureert, of een bezoeker helpt begrijpen hoe hij een proefrit kan aanvragen.

Overzicht

De proefritfunctie breidt het contactformulier op de detailpagina van een enkel voertuig uit met een optionele proefritaanvraag. Wanneer deze is ingeschakeld, bevat het contactformulier een selectievakje met het label "Interesse in een proefrit?". Wanneer een bezoeker dit aanvinkt, verschijnen er invoervelden voor datum en tijd. De bezoeker selecteert een datum; beschikbare tijdsloten voor die datum worden dynamisch geladen op basis van het geconfigureerde schema. De bezoeker selecteert vervolgens een tijdslot en verzendt het formulier. De proefritaanvraag wordt opgenomen in de e-mail met de aanvraag die naar de dealer wordt verzonden.

Er is geen afzonderlijk boekingsbeheersysteem in de plugin opgenomen. Proefritaanvragen worden geleverd als onderdeel van de e-mail van het contactformulier. Het beheren en bevestigen van afspraken is de verantwoordelijkheid van de dealer buiten de plugin om.

Vereisten of randvoorwaarden

De proefritfunctie moet zijn ingeschakeld in de plugin-instellingen (TEST_DRIVE_ENABLED). Deze is standaard uitgeschakeld.
Het contactformulier moet zichtbaar zijn op de detailpagina van het voertuig. Het contactformulierblok moet actief zijn in de Layout Manager voor de pagina van het enkele voertuig.
De WordPress site moet e-mail kunnen verzenden.
Er moet ten minste één beschikbare weekdag en een geldig tijdvenster zijn geconfigureerd om tijdsloten te kunnen genereren.

Stapsgewijze instructies

De proefritfunctie inschakelen en configureren

Open de plugin-instellingen in de WordPress admin.
Navigeer naar de configuratiesectie Proefrit.
Schakel de hoofdschakelaar voor proefritboekingen in.
Configureer beschikbare dagen, tijdvenster, slotduur en eventuele uitsluitingsdata (zie de Configuratiereferentie hieronder).
Sla de instellingen op.

De proefritvelden verschijnen automatisch in het contactformulier op alle gepubliceerde detailpagina's van voertuigen.

Bezoeker: een proefrit aanvragen

Open een willekeurige detailpagina van een voertuig.
Scrol naar de sectie met het contactformulier.
Vink het selectievakje "Interesse in een proefrit?" aan.
Er verschijnen een datumveld en een tijdveld onder het selectievakje.
Selecteer een datum in de datuminvoer. Datums in het verleden kunnen niet worden geselecteerd.
Nadat een datum is geselecteerd, wordt de vervolgkeuzelijst voor de tijd gevuld met beschikbare sloten voor die datum. Als de geselecteerde datum vandaag is, worden alleen toekomstige sloten getoond. Als er geen beschikbare sloten zijn (de dag is geen geconfigureerde werkdag, of alle sloten voor vandaag zijn al verstreken, of de datum is een uitsluitingsdatum), toont de vervolgkeuzelijst voor de tijd geen selecteerbare opties.
Selecteer een tijdslot.
Vul de overige velden van het contactformulier (naam, e-mailadres, bericht) naar wens in.
Verzend het formulier.

De proefritaanvraag wordt opgenomen in de aanvraagmelding die naar de dealer wordt verzonden.

Configuratiereferentie

Proefritinstellingen

Instelling	Optiesleutel	Standaard	Beschrijving
Hoofdschakelaar	`as24ci_test_drive_enabled`	Uit (0)	Schakelt de proefritfunctie wereldwijd in of uit
Beschikbare dagen	`as24ci_test_drive_available_days`	Leeg (alle dagen)	ISO-weekdagnummers (1=ma … 7=zo) waarop proefritten zijn toegestaan
Starttijd slot	`as24ci_test_drive_start_time`	`08:00`	Vroegste tijdslot in HH:MM 24-uurs indeling
Eindtijd slot	`as24ci_test_drive_end_time`	`18:00`	Laatste grens van het tijdslot in HH:MM 24-uurs indeling
Duur slot	`as24ci_test_drive_slot_duration`	`30` (minuten)	Lengte van elk tijdslot in minuten
Uitsluitingsdata	`as24ci_test_drive_blackout_dates`	Leeg	Datums (Y-m-d indeling) waarop geen proefritten beschikbaar zijn, één per regel

Beschikbare dagen

Dagen worden gespecificeerd als ISO-weekdagnummers:

Nummer	Dag
1	Maandag
2	Dinsdag
3	Woensdag
4	Donderdag
5	Vrijdag
6	Zaterdag
7	Zondag

Als er geen dagen zijn geconfigureerd (de instelling is leeg), worden alle dagen als beschikbaar behandeld.

Genereren van tijdsloten

De plugin berekent dynamisch beschikbare tijdsloten wanneer een bezoeker een datum selecteert. De toegepaste regels zijn:

De weekdag van de geselecteerde datum moet voorkomen in de geconfigureerde lijst met beschikbare dagen (of de lijst moet leeg zijn).
De geselecteerde datum mag niet voorkomen in de lijst met uitsluitingsdata.
Sloten worden gegenereerd vanaf de starttijd tot de eindtijd in stappen van de slotduur. Het laatste slot begint op of voor end_time − slot_duration. Bijvoorbeeld, met een start van 08:00, eind van 18:00 en duur van 30, zijn de sloten 08:00, 08:30, 09:00, … 17:30.
Wanneer de geselecteerde datum vandaag is (met gebruik van de WordPress tijdzone van de site), worden alleen sloten geretourneerd waarvan de starttijd op of na de huidige tijd ligt.
Datums in het verleden retourneren altijd geen beschikbare sloten.

Integratie met contactformulier

De proefritsectie bestaat uit:

Een selectievakje: "Interesse in een proefrit?"
Een datuminvoer (type="date")
Een vervolgkeuzelijst voor tijdselectie (uitgeschakeld totdat een datum is geselecteerd; gevuld via JavaScript wanneer de datum verandert)

De datum- en tijdwaarden worden verzonden als verborgen formuliervelden (as24ci_contact[td_date] en as24ci_contact[td_time]) samen met de rest van de gegevens van het contactformulier.

Operationele opmerkingen

De beschikbaarheid van tijdsloten wordt aan de serverzijde berekend en aan de browser geleverd via een REST- of AJAX-endpoint wanneer de bezoeker een datum selecteert. De plugin gebruikt de WordPress tijdzone van de site (current_time()) voor alle tijdsvergelijkingen.
Als de slotduur is geconfigureerd als korter dan 1 minuut, valt de plugin terug op sloten van 30 minuten.
Als de starttijd in de configuratie gelijk is aan of groter is dan de eindtijd, worden er voor geen enkele datum sloten gegenereerd.
De proefritfunctie voorkomt geen dubbele boekingen. Meerdere bezoekers kunnen hetzelfde tijdslot aanvragen. Afsprakenbeheer wordt handmatig door de dealer afgehandeld.
Uitsluitingsdata kunnen worden ingevoerd als een door regeleinden gescheiden lijst of een door komma's gescheiden lijst van datums in Y-m-d-indeling (bijv. 2025-12-25). Ongeldige datuminvoeren worden stilzwijgend genegeerd.

Problemen oplossen

Het selectievakje voor de proefrit verschijnt niet op het contactformulier.

Controleer of de hoofdschakelaar voor de proefrit is ingeschakeld in de plugin-instellingen.
Controleer of het contactformulierblok is ingeschakeld op de pagina van het enkele voertuig in de Layout Manager.

Na het selecteren van een datum toont de vervolgkeuzelijst voor de tijd geen beschikbare sloten.

Controleer of de geselecteerde datum een geconfigureerde werkdag is. Als de instelling voor beschikbare dagen niet leeg is, hebben alleen de vermelde dagen sloten.
Controleer of de datum niet in de lijst met uitsluitingsdata staat.
Als de geselecteerde datum vandaag is, worden alle eerdere sloten verwijderd. Als het laat op de dag is, zijn er mogelijk geen sloten meer over.
Controleer de configuratie van het tijdvenster: de starttijd moet eerder zijn dan de eindtijd.

Proefritgegevens verschijnen niet in de e-mail met de melding voor de dealer.

De datum en tijd van de proefrit zijn opgenomen in de inzending van het contactformulier. Als ze ontbreken in de e-mail met de melding, controleer dan of het contactformulier de velden td_date en td_time correct verzendt. Controleer op JavaScript-fouten in de browserconsole.

Gerelateerde documenten

Voertuigdetailpagina's