Documentación · Guía del Frontend
Solicitudes de prueba de conducción
Este documento cubre la función de reserva de pruebas de conducción del plugin ADP Car Market Hub WordPress: cómo se integra con el formulario de contacto, cómo se calculan las franjas horarias y cómo se configura la función.
Cuándo utilizar este documento
Lea este documento si está configurando la función de reserva de pruebas de conducción por primera vez, configurando los días y franjas horarias disponibles, o ayudando a un visitante a comprender cómo solicitar una prueba de conducción.
Descripción general
La función de prueba de conducción amplía el formulario de contacto del vehículo en las páginas de detalles de un solo vehículo con una solicitud de prueba de conducción opcional. Cuando está habilitada, el formulario de contacto incluye una casilla de verificación con la etiqueta "¿Interesado en una prueba de conducción?". Cuando un visitante la marca, aparecen los campos de entrada de fecha y hora. El visitante selecciona una fecha; las franjas horarias disponibles para esa fecha se cargan dinámicamente en función del horario configurado. A continuación, el visitante selecciona una franja horaria y envía el formulario. La solicitud de prueba de conducción se incluye en el correo electrónico de consulta enviado al concesionario.
El plugin no incluye ningún sistema de gestión de reservas independiente. Las solicitudes de prueba de conducción se entregan como parte del correo electrónico del formulario de contacto. La gestión y confirmación de las citas es responsabilidad del concesionario fuera del plugin.
Requisitos o prerrequisitos
- La función de prueba de conducción debe estar habilitada en los ajustes del plugin (
TEST_DRIVE_ENABLED). Está desactivada por defecto. - El formulario de contacto debe ser visible en la página de detalles del vehículo. El bloque del formulario de contacto debe estar activo en el Layout Manager para la página de un solo vehículo.
- El sitio WordPress debe poder enviar correos electrónicos.
- Se debe configurar al menos un día de la semana disponible y una ventana de tiempo válida para que se generen las franjas horarias.
Instrucciones paso a paso
Habilitar y configurar la función de prueba de conducción
- En el administrador de WordPress, abra los ajustes del plugin.
- Navegue hasta la sección de configuración de Test Drive.
- Habilite el interruptor principal para las reservas de pruebas de conducción.
- Configure los días disponibles, la ventana de tiempo, la duración de la franja y cualquier fecha de exclusión (consulte la Referencia de configuración a continuación).
- Guarde los ajustes.
Los campos de la prueba de conducción aparecerán automáticamente en el formulario de contacto en todas las páginas de detalles de vehículos publicadas.
Visitante: solicitar una prueba de conducción
- Abra cualquier página de detalles de un vehículo.
- Desplácese hasta la sección del formulario de contacto.
- Marque la casilla de verificación "¿Interesado en una prueba de conducción?".
- Aparecerán un campo de fecha y un campo de hora debajo de la casilla de verificación.
- Seleccione una fecha en el campo de entrada de fecha. Las fechas pasadas no se pueden seleccionar.
- Una vez seleccionada una fecha, el menú desplegable de hora se completa con las franjas disponibles para esa fecha. Si la fecha seleccionada es hoy, solo se muestran las franjas futuras. Si no hay franjas disponibles (el día no es un día laborable configurado, o todas las franjas ya han pasado para hoy, o la fecha es una fecha de exclusión), el menú desplegable de hora no mostrará opciones seleccionables.
- Seleccione una franja horaria.
- Complete los campos restantes del formulario de contacto (nombre, correo electrónico, mensaje) según sea necesario.
- Envíe el formulario.
La solicitud de prueba de conducción se incluye en la notificación de consulta enviada al concesionario.
Referencia de configuración
Ajustes de la prueba de conducción
| Ajuste | Clave de opción | Por defecto | Descripción |
|---|---|---|---|
| Interruptor principal | as24ci_test_drive_enabled | Desactivado (0) | Habilita o deshabilita la función de prueba de conducción de forma global |
| Días disponibles | as24ci_test_drive_available_days | Vacío (todos los días) | Números de día de la semana ISO (1=Lun … 7=Dom) en los que se permiten pruebas de conducción |
| Hora de inicio de franja | as24ci_test_drive_start_time | 08:00 | Franja horaria más temprana en formato de 24 horas HH:MM |
| Hora de fin de franja | as24ci_test_drive_end_time | 18:00 | Límite de la franja horaria más tardía en formato de 24 horas HH:MM |
| Duración de franja | as24ci_test_drive_slot_duration | 30 (minutos) | Duración de cada franja horaria en minutos |
| Fechas de exclusión | as24ci_test_drive_blackout_dates | Vacío | Fechas (formato Y-m-d) en las que no hay pruebas de conducción disponibles, una por línea |
Días disponibles
Los días se especifican como números de día de la semana ISO:
| Número | Día |
|---|---|
| 1 | Lunes |
| 2 | Martes |
| 3 | Miércoles |
| 4 | Jueves |
| 5 | Viernes |
| 6 | Sábado |
| 7 | Domingo |
Si no se configuran días (el ajuste está vacío), todos los días se tratan como disponibles.
Generación de franjas horarias
El plugin calcula las franjas horarias disponibles de forma dinámica cuando un visitante selecciona una fecha. Las reglas aplicadas son:
- El día de la semana de la fecha seleccionada debe estar en la lista de días disponibles configurada (o la lista debe estar vacía).
- La fecha seleccionada no debe estar en la lista de fechas de exclusión.
- Las franjas se generan desde la hora de inicio hasta la hora de fin en incrementos de la duración de la franja. La última franja comienza en o antes de
end_time − slot_duration. Por ejemplo, con un inicio de08:00, fin de18:00y duración de30, las franjas son08:00,08:30,09:00, …17:30. - Cuando la fecha seleccionada es hoy (utilizando la zona horaria WordPress del sitio), solo se devuelven las franjas cuya hora de inicio sea igual o posterior a la hora actual.
- Las fechas en el pasado siempre devuelven cero franjas disponibles.
Integración con el formulario de contacto
La sección de prueba de conducción consta de:
- Una casilla de verificación: "¿Interesado en una prueba de conducción?"
- Una entrada de fecha (
type="date") - Un menú desplegable de selección de hora (desactivado hasta que se selecciona una fecha; se completa a través de JavaScript cuando cambia la fecha)
Los valores de fecha y hora se envían como campos de formulario ocultos (as24ci_contact[td_date] y as24ci_contact[td_time]) junto con el resto de los datos del formulario de contacto.
Notas operativas
- La disponibilidad de las franjas horarias se calcula en el lado del servidor y se entrega al navegador a través de un endpoint REST o AJAX cuando el visitante selecciona una fecha. El plugin utiliza la zona horaria del sitio WordPress (
current_time()) para todas las comparaciones de hora. - Si la duración de la franja se configura en menos de 1 minuto, el plugin utiliza por defecto franjas de 30 minutos.
- Si la hora de inicio es igual o superior a la hora de fin en la configuración, no se generarán franjas para ninguna fecha.
- La función de prueba de conducción no evita las reservas duplicadas. Varios visitantes pueden solicitar la misma franja horaria. La gestión de las citas la realiza manualmente el concesionario.
- Las fechas de exclusión se pueden introducir como una lista separada por saltos de línea o una lista separada por comas de fechas en formato
Y-m-d(por ejemplo,2025-12-25). Las entradas de fecha no válidas se ignoran silenciosamente.
Resolución de problemas
La casilla de verificación de la prueba de conducción no aparece en el formulario de contacto.
- Verifique que el interruptor principal para la prueba de conducción esté habilitado en los ajustes del plugin.
- Confirme que el bloque del formulario de contacto esté habilitado en la página de un solo vehículo en el Layout Manager.
Después de seleccionar una fecha, el menú desplegable de hora no muestra franjas disponibles.
- Compruebe que la fecha seleccionada sea un día laborable configurado. Si el ajuste de días disponibles no está vacío, solo los días enumerados tendrán franjas.
- Compruebe que la fecha no esté en la lista de fechas de exclusión.
- Si la fecha seleccionada es hoy, se eliminan todas las franjas anteriores. Si es tarde en el día, es posible que no queden franjas.
- Verifique la configuración de la ventana de tiempo: la hora de inicio debe ser anterior a la hora de fin.
Los detalles de la prueba de conducción no aparecen en el correo electrónico de notificación del concesionario.
- La fecha y la hora de la prueba de conducción se incluyen en el envío del formulario de contacto. Si faltan en el correo electrónico de notificación, verifique que el formulario de contacto esté enviando los campos
td_dateytd_timecorrectamente. Compruebe si hay errores de JavaScript en la consola del navegador.