Documentazione · Guida del frontend

Richieste di test drive

Questo documento copre la funzionalità di prenotazione dei test drive del plugin ADP Car Market Hub WordPress: come si integra con il modulo di contatto, come vengono calcolati gli slot orari e come viene configurata la funzionalità.

Quando utilizzare questo documento

Leggi questo documento se stai configurando la funzionalità di prenotazione dei test drive per la prima volta, se stai configurando i giorni e gli slot orari disponibili o se stai aiutando un visitatore a capire come richiedere un test drive.

Panoramica

La funzionalità di test drive estende il modulo di contatto del veicolo sulle singole pagine di dettaglio del veicolo con una richiesta di test drive opzionale. Quando è abilitata, il modulo di contatto include una casella di controllo con l'etichetta "Interessato a un test drive?". Quando un visitatore la seleziona, appaiono i campi di inserimento per data e ora. Il visitatore seleziona una data; gli slot orari disponibili per quella data vengono caricati dinamicamente in base al calendario configurato. Il visitatore seleziona quindi uno slot orario e invia il modulo. La richiesta di test drive viene inclusa nell'e-mail di richiesta inviata al concessionario.

Nel plugin non è incluso alcun sistema di gestione delle prenotazioni separato. Le richieste di test drive vengono recapitate come parte dell'e-mail del modulo di contatto. La gestione e la conferma degli appuntamenti sono responsabilità del concessionario al di fuori del plugin.

Requisiti o prerequisiti

  • La funzionalità di test drive deve essere abilitata nelle impostazioni del plugin (TEST_DRIVE_ENABLED). È disabilitata per impostazione predefinita.
  • Il modulo di contatto deve essere visibile sulla pagina di dettaglio del veicolo. Il blocco del modulo di contatto deve essere attivo nel Layout Manager per la pagina del singolo veicolo.
  • Il sito WordPress deve essere in grado di inviare e-mail.
  • È necessario configurare almeno un giorno feriale disponibile e una finestra temporale valida affinché vengano generati gli slot orari.

Istruzioni passo-passo

Abilitare e configurare la funzionalità di test drive

  1. Nell'amministrazione di WordPress, apri le impostazioni del plugin.
  2. Naviga fino alla sezione di configurazione Test Drive.
  3. Abilita l'interruttore principale per le prenotazioni dei test drive.
  4. Configura i giorni disponibili, la finestra temporale, la durata dello slot ed eventuali date di esclusione (vedi il Riferimento di configurazione di seguito).
  5. Salva le impostazioni.

I campi del test drive appariranno automaticamente nel modulo di contatto su tutte le pagine di dettaglio dei veicoli pubblicate.

Visitatore: richiedere un test drive

  1. Apri una qualsiasi pagina di dettaglio del veicolo.
  2. Scorri fino alla sezione del modulo di contatto.
  3. Seleziona la casella di controllo "Interessato a un test drive?".
  4. Sotto la casella di controllo appaiono un campo data e un campo ora.
  5. Seleziona una data dall'inserimento della data. Le date nel passato non sono selezionabili.
  6. Dopo aver selezionato una data, il menu a discesa dell'ora viene popolato con gli slot disponibili per quella data. Se la data selezionata è oggi, vengono mostrati solo gli slot futuri. Se non ci sono slot disponibili (il giorno non è un giorno lavorativo configurato, o tutti gli slot sono passati per oggi, o la data è una data di esclusione), il menu a discesa dell'ora non mostrerà opzioni selezionabili.
  7. Seleziona uno slot orario.
  8. Compila i restanti campi del modulo di contatto (nome, e-mail, messaggio) come richiesto.
  9. Invia il modulo.

La richiesta di test drive viene inclusa nella notifica di richiesta inviata al concessionario.

Riferimento di configurazione

Impostazioni del test drive

ImpostazioneChiave opzionePredefinitoDescrizione
Interruttore principaleas24ci_test_drive_enabledDisattivato (0)Abilita o disabilita la funzionalità di test drive a livello globale
Giorni disponibilias24ci_test_drive_available_daysVuoto (tutti i giorni)Numeri dei giorni della settimana ISO (1=Lun … 7=Dom) in cui sono consentiti i test drive
Ora inizio slotas24ci_test_drive_start_time08:00Slot orario più anticipato nel formato 24 ore HH:MM
Ora fine slotas24ci_test_drive_end_time18:00Limite dello slot orario più tardivo nel formato 24 ore HH:MM
Durata slotas24ci_test_drive_slot_duration30 (minuti)Durata di ciascuno slot orario in minuti
Date di esclusioneas24ci_test_drive_blackout_datesVuotoDate (formato Y-m-d) in cui non sono disponibili test drive, una per riga

Giorni disponibili

I giorni sono specificati come numeri dei giorni della settimana ISO:

NumeroGiorno
1Lunedì
2Martedì
3Mercoledì
4Giovedì
5Venerdì
6Sabato
7Domenica

Se non viene configurato alcun giorno (l'impostazione è vuota), tutti i giorni vengono trattati come disponibili.

Generazione degli slot orari

Il plugin calcola dinamicamente gli slot orari disponibili quando un visitatore seleziona una data. Le regole applicate sono:

  1. Il giorno della settimana della data selezionata deve essere presente nell'elenco dei giorni disponibili configurati (oppure l'elenco deve essere vuoto).
  2. La data selezionata non deve essere presente nell'elenco delle date di esclusione.
  3. Gli slot vengono generati dall'ora di inizio all'ora di fine in incrementi della durata dello slot. L'ultimo slot inizia entro o prima di end_time − slot_duration. Ad esempio, con un inizio alle 08:00, una fine alle 18:00 e una durata di 30, gli slot sono 08:00, 08:30, 09:00, … 17:30.
  4. Quando la data selezionata è oggi (utilizzando il fuso orario WordPress del sito), vengono restituiti solo gli slot la cui ora di inizio è pari o successiva all'ora corrente.
  5. Le date nel passato non restituiscono mai slot disponibili.

Integrazione del modulo di contatto

La sezione del test drive è composta da:

  • Una casella di controllo: "Interessato a un test drive?"
  • Un campo di inserimento data (type="date")
  • Un menu a discesa per la selezione dell'ora (disabilitato finché non viene selezionata una data; popolato tramite JavaScript quando la data cambia)

I valori di data e ora vengono inviati come campi modulo nascosti (as24ci_contact[td_date] e as24ci_contact[td_time]) insieme al resto dei dati del modulo di contatto.

Note operative

  • La disponibilità degli slot orari viene calcolata lato server e recapitata al browser tramite un endpoint REST o AJAX quando il visitatore seleziona una data. Il plugin utilizza il fuso orario del sito WordPress (current_time()) per tutti i confronti temporali.
  • Se la durata dello slot è configurata come inferiore a 1 minuto, il plugin imposta per impostazione predefinita slot di 30 minuti.
  • Se nella configurazione l'ora di inizio è uguale o superiore all'ora di fine, non viene generato alcuno slot per nessuna data.
  • La funzionalità di test drive non impedisce le doppie prenotazioni. Più visitatori possono richiedere lo stesso slot orario. La gestione degli appuntamenti viene gestita manualmente dal concessionario.
  • Le date di esclusione possono essere inserite come elenco separato da una nuova riga o elenco separato da virgole di date nel formato Y-m-d (ad es. 2025-12-25). Le voci di data non valide vengono ignorate silenziosamente.

Risoluzione dei problemi

La casella di controllo del test drive non appare nel modulo di contatto.

  • Verifica che l'interruttore principale per il test drive sia abilitato nelle impostazioni del plugin.
  • Conferma che il blocco del modulo di contatto sia abilitato sulla pagina del singolo veicolo nel Layout Manager.

Dopo aver selezionato una data, il menu a discesa dell'ora non mostra slot disponibili.

  • Verifica che la data selezionata sia un giorno lavorativo configurato. Se l'impostazione dei giorni disponibili non è vuota, solo i giorni elencati avranno slot.
  • Verifica che la data non sia presente nell'elenco delle date di esclusione.
  • Se la data selezionata è oggi, tutti gli slot precedenti vengono rimossi. Se è tardi nella giornata, potrebbero non esserci slot rimanenti.
  • Verifica la configurazione della finestra temporale: l'ora di inizio deve essere precedente all'ora di fine.

I dettagli del test drive non appaiono nell'e-mail di notifica del concessionario.

  • La data e l'ora del test drive sono incluse nell'invio del modulo di contatto. Se mancano dall'e-mail di notifica, verifica che il modulo di contatto invii correttamente i campi td_date e td_time. Verifica la presenza di errori JavaScript nella console del browser.

Documenti correlati