Documentation · Guide du Frontend

Demandes d'essai routier

Ce document couvre la fonctionnalité de réservation d'essai routier de l'extension ADP Car Market Hub WordPress : comment elle s'intègre au formulaire de contact, comment les créneaux horaires sont calculés et comment la fonctionnalité est configurée.

Quand utiliser ce document

Lisez ce document si vous configurez la fonctionnalité de réservation d'essai routier pour la première fois, si vous configurez les jours et créneaux horaires disponibles, ou si vous aidez un visiteur à comprendre comment demander un essai routier.

Aperçu

La fonctionnalité d'essai routier enrichit le formulaire de contact du véhicule sur les pages de détails de véhicule individuelles avec une demande d'essai routier facultative. Lorsqu'elle est activée, le formulaire de contact comprend une case à cocher intitulée « Intéressé par un essai routier ? ». Lorsqu'un visiteur la coche, des champs de saisie de date et d'heure apparaissent. Le visiteur sélectionne une date ; les créneaux horaires disponibles pour cette date sont chargés dynamiquement en fonction du calendrier configuré. Le visiteur sélectionne ensuite un créneau horaire et soumet le formulaire. La demande d'essai routier est incluse dans l'e-mail de demande envoyé au concessionnaire.

Aucun système de gestion des réservations distinct n'est inclus dans l'extension. Les demandes d'essai routier sont transmises dans le cadre de l'e-mail du formulaire de contact. La gestion et la confirmation des rendez-vous relèvent de la responsabilité du concessionnaire, en dehors de l'extension.

Configuration requise ou prérequis

La fonctionnalité d'essai routier doit être activée dans les réglages de l'extension (TEST_DRIVE_ENABLED). Elle est désactivée par défaut.
Le formulaire de contact doit être visible sur la page de détails du véhicule. Le bloc de formulaire de contact doit être actif dans le Layout Manager pour la page de véhicule individuelle.
Le site WordPress doit être capable d'envoyer des e-mails.
Au moins un jour de la semaine disponible et une plage horaire valide doivent être configurés pour que les créneaux horaires soient générés.

Instructions étape par étape

Activer et configurer la fonctionnalité d'essai routier

Dans l'administration WordPress, ouvrez les réglages de l'extension.
Accédez à la section de configuration Test Drive.
Activez le commutateur principal pour les réservations d'essais routiers.
Configurez les jours disponibles, la plage horaire, la durée des créneaux et toutes les dates d'exclusion (voir la Référence de configuration ci-dessous).
Enregistrez les réglages.

Les champs d'essai routier apparaîtront automatiquement dans le formulaire de contact sur toutes les pages de détails de véhicule publiées.

Visiteur : demander un essai routier

Ouvrez n'importe quelle page de détails de véhicule.
Faites défiler jusqu'à la section du formulaire de contact.
Cochez la case « Intéressé par un essai routier ? ».
Un champ de date et un champ d'heure apparaissent sous la case à cocher.
Sélectionnez une date dans le champ de saisie de date. Les dates passées ne peuvent pas être sélectionnées.
Une fois la date sélectionnée, la liste déroulante des heures est alimentée avec les créneaux disponibles pour cette date. Si la date sélectionnée est aujourd'hui, seuls les créneaux futurs sont affichés. S'il n'y a pas de créneaux disponibles (le jour n'est pas un jour ouvrable configuré, ou tous les créneaux sont passés pour aujourd'hui, ou la date est une date d'exclusion), la liste déroulante des heures n'affichera aucune option sélectionnable.
Sélectionnez un créneau horaire.
Remplissez les autres champs du formulaire de contact (nom, e-mail, message) selon les besoins.
Soumettez le formulaire.

La demande d'essai routier est incluse dans la notification de demande envoyée au concessionnaire.

Référence de configuration

Réglages de l'essai routier

Réglage	Clé d'option	Par défaut	Description
Commutateur principal	`as24ci_test_drive_enabled`	Désactivé (0)	Active ou désactive la fonctionnalité d'essai routier globalement
Jours disponibles	`as24ci_test_drive_available_days`	Vide (tous les jours)	Numéros de jours de la semaine ISO (1=Lun … 7=Dim) où les essais routiers sont autorisés
Heure de début du créneau	`as24ci_test_drive_start_time`	`08:00`	Créneau horaire le plus précoce au format 24 heures HH:MM
Heure de fin du créneau	`as24ci_test_drive_end_time`	`18:00`	Limite du dernier créneau horaire au format 24 heures HH:MM
Durée du créneau	`as24ci_test_drive_slot_duration`	`30` (minutes)	Durée de chaque créneau horaire en minutes
Dates d'exclusion	`as24ci_test_drive_blackout_dates`	Vide	Dates (format Y-m-d) auxquelles aucun essai routier n'est disponible, une par ligne

Jours disponibles

Les jours sont spécifiés sous forme de numéros de jours de la semaine ISO :

Numéro	Jour
1	Lundi
2	Mardi
3	Mercredi
4	Jeudi
5	Vendredi
6	Samedi
7	Dimanche

Si aucun jour n'est configuré (le réglage est vide), tous les jours sont traités comme disponibles.

Génération des créneaux horaires

L'extension calcule dynamiquement les créneaux horaires disponibles lorsqu'un visiteur sélectionne une date. Les règles appliquées sont :

Le jour de la semaine de la date sélectionnée doit figurer dans la liste des jours disponibles configurés (ou la liste doit être vide).
La date sélectionnée ne doit pas figurer dans la liste des dates d'exclusion.
Les créneaux sont générés de l'heure de début à l'heure de fin par incréments de la durée du créneau. Le dernier créneau commence au plus tard à end_time − slot_duration. Par exemple, avec un début à 08:00, une fin à 18:00 et une durée de 30, les créneaux sont 08:00, 08:30, 09:00, … 17:30.
Lorsque la date sélectionnée est aujourd'hui (en utilisant le fuseau horaire WordPress du site), seuls les créneaux dont l'heure de début est égale ou supérieure à l'heure actuelle sont renvoyés.
Les dates passées ne renvoient jamais de créneaux disponibles.

Intégration du formulaire de contact

La section d'essai routier se compose de :

Une case à cocher : « Intéressé par un essai routier ? »
Un champ de saisie de date (type="date")
Une liste déroulante de sélection de l'heure (désactivée jusqu'à ce qu'une date soit sélectionnée ; alimentée via JavaScript lorsque la date change)

Les valeurs de date et d'heure sont soumises en tant que champs de formulaire masqués (as24ci_contact[td_date] et as24ci_contact[td_time]) aux côtés des autres données du formulaire de contact.

Notes opérationnelles

La disponibilité des créneaux horaires est calculée côté serveur et transmise au navigateur via un point de terminaison REST ou AJAX lorsque le visiteur sélectionne une date. L'extension utilise le fuseau horaire du site WordPress (current_time()) pour toutes les comparaisons d'heures.
Si la durée du créneau est configurée pour être inférieure à 1 minute, l'extension utilise par défaut des créneaux de 30 minutes.
Si l'heure de début est égale ou supérieure à l'heure de fin dans la configuration, aucun créneau n'est généré pour aucune date.
La fonctionnalité d'essai routier n'empêche pas les doubles réservations. Plusieurs visiteurs peuvent demander le même créneau horaire. La gestion des rendez-vous est gérée manuellement par le concessionnaire.
Les dates d'exclusion peuvent être saisies sous forme de liste séparée par des retours à la ligne ou de liste séparée par des virgules de dates au format Y-m-d (par exemple, 2025-12-25). Les entrées de date invalides sont ignorées silencieusement.

Dépannage

La case à cocher d'essai routier n'apparaît pas sur le formulaire de contact.

Vérifiez que le commutateur principal pour l'essai routier est activé dans les réglages de l'extension.
Confirmez que le bloc de formulaire de contact est activé sur la page de véhicule individuelle dans le Layout Manager.

Après avoir sélectionné une date, la liste déroulante des heures n'affiche aucun créneau disponible.

Vérifiez que la date sélectionnée est un jour ouvrable configuré. Si le réglage des jours disponibles n'est pas vide, seuls les jours répertoriés auront des créneaux.
Vérifiez que la date ne figure pas dans la liste des dates d'exclusion.
Si la date sélectionnée est aujourd'hui, tous les créneaux antérieurs sont supprimés. S'il est tard dans la journée, il se peut qu'il ne reste plus de créneaux.
Vérifiez la configuration de la plage horaire : l'heure de début doit être antérieure à l'heure de fin.

Les détails de l'essai routier n'apparaissent pas dans l'e-mail de notification du concessionnaire.

La date et l'heure de l'essai routier sont incluses dans la soumission du formulaire de contact. S'ils sont absents de l'e-mail de notification, vérifiez que le formulaire de contact soumet correctement les champs td_date et td_time. Recherchez d'éventuelles erreurs JavaScript dans la console du navigateur.

Documents connexes

Pages de détails de véhicule