Dokumentation · Frontend-Handbuch

Probefahrten-Anfragen

Dieses Dokument behandelt die Buchungsfunktion für Probefahrten des ADP Car Market Hub WordPress Plugins: wie sie in das Kontaktformular integriert ist, wie Zeitfenster berechnet werden und wie die Funktion konfiguriert wird.

Wann dieses Dokument zu verwenden ist

Lesen Sie dieses Dokument, wenn Sie die Buchungsfunktion für Probefahrten zum ersten Mal einrichten, verfügbare Tage und Zeitfenster konfigurieren oder einem Besucher helfen möchten zu verstehen, wie eine Probefahrt angefragt wird.

Übersicht

Die Probefahrten-Funktion erweitert das Fahrzeug-Kontaktformular auf den einzelnen Fahrzeugdetailseiten um eine optionale Probefahrten-Anfrage. Wenn diese aktiviert ist, enthält das Kontaktformular ein Kontrollkästchen mit der Beschriftung „Interesse an einer Probefahrt?“. Wenn ein Besucher dieses aktiviert, erscheinen Eingabefelder für Datum und Uhrzeit. Der Besucher wählt ein Datum aus; die verfügbaren Zeitfenster für dieses Datum werden basierend auf dem konfigurierten Zeitplan dynamisch geladen. Der Besucher wählt dann ein Zeitfenster aus und sendet das Formular ab. Die Probefahrten-Anfrage ist in der E-Mail-Anfrage enthalten, die an das Autohaus gesendet wird.

Das Plugin enthält kein separates Buchungsverwaltungssystem. Probefahrten-Anfragen werden als Teil der E-Mail des Kontaktformulars zugestellt. Die Verwaltung und Bestätigung von Terminen liegt in der Verantwortung des Autohauses außerhalb des Plugins.

Anforderungen oder Voraussetzungen

  • Die Probefahrten-Funktion muss in den Plugin-Einstellungen (TEST_DRIVE_ENABLED) aktiviert sein. Sie ist standardmäßig deaktiviert.
  • Das Kontaktformular muss auf der Fahrzeugdetailseite sichtbar sein. Der Kontaktformular-Block muss im Layout-Manager für die Einzel-Fahrzeugseite aktiv sein.
  • Die WordPress-Website muss in der Lage sein, E-Mails zu versenden.
  • Es muss mindestens ein verfügbarer Wochentag und ein gültiges Zeitfenster konfiguriert sein, damit Zeitfenster generiert werden können.

Schritt-für-Schritt-Anleitung

Probefahrten-Funktion aktivieren und konfigurieren

  1. Öffnen Sie im WordPress-Adminbereich die Plugin-Einstellungen.
  2. Navigieren Sie zum Konfigurationsabschnitt Probefahrt.
  3. Aktivieren Sie den Hauptschalter für Probefahrten-Buchungen.
  4. Konfigurieren Sie die verfügbaren Tage, das Zeitfenster, die Slot-Dauer und eventuelle Sperrtage (siehe Konfigurationsreferenz unten).
  5. Speichern Sie die Einstellungen.

Die Probefahrten-Felder erscheinen automatisch im Kontaktformular auf allen veröffentlichten Fahrzeugdetailseiten.

Besucher: Eine Probefahrt anfragen

  1. Öffnen Sie eine beliebige Fahrzeugdetailseite.
  2. Scrollen Sie zum Abschnitt mit dem Kontaktformular.
  3. Aktivieren Sie das Kontrollkästchen „Interesse an einer Probefahrt?“.
  4. Unter dem Kontrollkästchen erscheinen ein Datumsfeld und ein Zeitfeld.
  5. Wählen Sie ein Datum aus der Datumseingabe. Daten in der Vergangenheit können nicht ausgewählt werden.
  6. Nachdem ein Datum ausgewählt wurde, wird das Dropdown-Menü für die Uhrzeit mit den verfügbaren Slots für dieses Datum befüllt. Wenn das ausgewählte Datum heute ist, werden nur zukünftige Slots angezeigt. Wenn keine verfügbaren Slots vorhanden sind (der Tag ist kein konfigurierter Arbeitstag, alle Slots für heute sind bereits vergangen oder das Datum ist ein Sperrtag), zeigt das Dropdown-Menü für die Uhrzeit keine auswählbaren Optionen an.
  7. Wählen Sie ein Zeitfenster aus.
  8. Füllen Sie die verbleibenden Felder des Kontaktformulars (Name, E-Mail, Nachricht) wie erforderlich aus.
  9. Senden Sie das Formular ab.

Die Probefahrten-Anfrage ist in der Anfrage-Benachrichtigung enthalten, die an das Autohaus gesendet wird.

Konfigurationsreferenz

Probefahrten-Einstellungen

EinstellungOptionsschlüsselStandardBeschreibung
Hauptschalteras24ci_test_drive_enabledAus (0)Aktiviert oder deaktiviert die Probefahrten-Funktion global
Verfügbare Tageas24ci_test_drive_available_daysLeer (alle Tage)ISO-Wochentagsnummern (1=Mo … 7=So), an denen Probefahrten erlaubt sind
Slot-Startzeitas24ci_test_drive_start_time08:00Frühestes Zeitfenster im 24-Stunden-Format HH:MM
Slot-Endzeitas24ci_test_drive_end_time18:00Späteste Zeitfenster-Grenze im 24-Stunden-Format HH:MM
Slot-Daueras24ci_test_drive_slot_duration30 (Minuten)Länge jedes Zeitfensters in Minuten
Sperrtageas24ci_test_drive_blackout_datesLeerDaten (Format Y-m-d), an denen keine Probefahrten verfügbar sind, eines pro Zeile

Verfügbare Tage

Tage werden als ISO-Wochentagsnummern angegeben:

NummerTag
1Montag
2Dienstag
3Mittwoch
4Donnerstag
5Freitag
6Samstag
7Sonntag

Wenn keine Tage konfiguriert sind (die Einstellung leer ist), werden alle Tage als verfügbar behandelt.

Generierung von Zeitfenstern

Das Plugin berechnet verfügbare Zeitfenster dynamisch, wenn ein Besucher ein Datum auswählt. Es gelten folgende Regeln:

  1. Der Wochentag des ausgewählten Datums muss in der Liste der konfigurierten verfügbaren Tage enthalten sein (oder die Liste muss leer sein).
  2. Das ausgewählte Datum darf nicht in der Liste der Sperrtage enthalten sein.
  3. Slots werden von der Startzeit bis zur Endzeit in Schritten der Slot-Dauer generiert. Der letzte Slot beginnt bei oder vor end_time − slot_duration. Beispielsweise werden bei einem Start um 08:00, einem Ende um 18:00 und einer Dauer von 30 die Slots 08:00, 08:30, 09:00, … 17:30 generiert.
  4. Wenn das ausgewählte Datum heute ist (unter Verwendung der WordPress-Zeitzone der Website), werden nur Slots zurückgegeben, deren Startzeit der aktuellen Uhrzeit entspricht oder danach liegt.
  5. Bei Daten in der Vergangenheit werden immer keine verfügbaren Slots zurückgegeben.

Integration in das Kontaktformular

Der Probefahrten-Abschnitt besteht aus:

  • Einem Kontrollkästchen: „Interesse an einer Probefahrt?“
  • Einer Datumseingabe (type="date")
  • Einem Dropdown-Menü zur Zeitauswahl (deaktiviert, bis ein Datum ausgewählt wird; wird über JavaScript befüllt, wenn sich das Datum ändert)

Die Datums- und Uhrzeitwerte werden als versteckte Formularfelder (as24ci_contact[td_date] und as24ci_contact[td_time]) zusammen mit den restlichen Daten des Kontaktformulars übermittelt.

Betriebliche Hinweise

  • Die Verfügbarkeit von Zeitfenstern wird serverseitig berechnet und über einen REST- oder AJAX-Endpunkt an den Browser übermittelt, wenn der Besucher ein Datum auswählt. Das Plugin verwendet für alle Zeitvergleiche die Zeitzone der WordPress-Website (current_time()).
  • Wenn die Slot-Dauer auf weniger als 1 Minute konfiguriert ist, verwendet das Plugin standardmäßig 30-Minuten-Slots.
  • Wenn die Startzeit in der Konfiguration der Endzeit entspricht oder diese überschreitet, werden für kein Datum Slots generiert.
  • Die Probefahrten-Funktion verhindert keine Doppelbuchungen. Mehrere Besucher können dasselbe Zeitfenster anfragen. Die Terminverwaltung wird vom Autohaus manuell durchgeführt.
  • Sperrtage können als durch Zeilenumbruch getrennte Liste oder als kommagetrennte Liste von Daten im Format Y-m-d eingegeben werden (z. B. 2025-12-25). Ungültige Datumseinträge werden stillschweigend ignoriert.

Fehlerbehebung

Das Kontrollkästchen für die Probefahrt erscheint nicht im Kontaktformular.

  • Überprüfen Sie, ob der Hauptschalter für Probefahrten in den Plugin-Einstellungen aktiviert ist.
  • Bestätigen Sie, dass der Kontaktformular-Block auf der Einzel-Fahrzeugseite im Layout-Manager aktiviert ist.

Nach Auswahl eines Datums zeigt das Dropdown-Menü für die Uhrzeit keine verfügbaren Slots an.

  • Überprüfen Sie, ob das ausgewählte Datum ein konfigurierter Arbeitstag ist. Wenn die Einstellung für verfügbare Tage nicht leer ist, haben nur die aufgelisteten Tage Slots.
  • Überprüfen Sie, ob das Datum nicht in der Liste der Sperrtage enthalten ist.
  • Wenn das ausgewählte Datum heute ist, werden alle früheren Slots entfernt. Wenn es bereits spät am Tag ist, sind möglicherweise keine Slots mehr übrig.
  • Überprüfen Sie die Konfiguration des Zeitfensters: Die Startzeit muss vor der Endzeit liegen.

Details zur Probefahrt erscheinen nicht in der Benachrichtigungs-E-Mail des Autohauses.

  • Das Datum und die Uhrzeit der Probefahrt sind in der Übermittlung des Kontaktformulars enthalten. Wenn sie in der Benachrichtigungs-E-Mail fehlen, überprüfen Sie, ob das Kontaktformular die Felder td_date und td_time korrekt übermittelt. Suchen Sie in der Browser-Konsole nach JavaScript-Fehlern.

Verwandte Dokumente