Probefahrt-Anfragen

Dieses Dokument beschreibt die Probefahrt-Buchungsfunktion 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 Sie dieses Dokument verwenden sollten

Lesen Sie dieses Dokument, wenn Sie die Probefahrt-Buchungsfunktion zum ersten Mal einrichten, verfügbare Tage und Zeitfenster konfigurieren oder einem Besucher helfen möchten zu verstehen, wie er eine Probefahrt anfragen kann.

Übersicht

Die Probefahrt-Funktion erweitert das Fahrzeug-Kontaktformular auf den einzelnen Fahrzeugdetailseiten um eine optionale Probefahrt-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 Probefahrt-Anfrage ist in der Anfrage-E-Mail enthalten, die an die Garage gesendet wird.

Das Plugin enthält kein separates Buchungsverwaltungssystem. Probefahrt-Anfragen werden als Teil der E-Mail des Kontaktformulars zugestellt. Die Verwaltung und Bestätigung von Terminen liegt in der Verantwortung der Garage ausserhalb des Plugins.

Anforderungen oder Voraussetzungen

• Die Probefahrt-Funktion muss in den Plugin-Einstellungen (TEST_DRIVE_ENABLED) aktiviert sein. Sie ist standardmässig deaktiviert.
• Das Kontaktformular muss auf der Fahrzeugdetailseite sichtbar sein. Der Kontaktformular-Block muss im Layout Manager für die einzelne 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

Probefahrt-Funktion aktivieren und konfigurieren

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

Die Probefahrt-Felder werden automatisch im Kontaktformular auf allen veröffentlichten Fahrzeugdetailseiten angezeigt.

Besucher: Eine Probefahrt anfragen

1. Öffnen Sie eine beliebige Fahrzeugdetailseite.
2. Scrollen Sie zum Bereich des Kontaktformulars.
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 gefüllt. Wenn das ausgewählte Datum heute ist, werden nur zukünftige Slots angezeigt. Wenn keine Slots verfügbar 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 Probefahrt-Anfrage ist in der Anfrage-Benachrichtigung enthalten, die an die Garage gesendet wird.

Konfigurationsreferenz

Probefahrt-Einstellungen

Verfügbare Tage

Tage werden als ISO-Wochentagsnummern angegeben:

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

Generierung von Zeitfenstern

Das Plugin berechnet die verfügbaren 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 bei oder nach der aktuellen Uhrzeit liegt.
5. Daten in der Vergangenheit geben immer keine verfügbaren Slots zurück.

Integration in das Kontaktformular

Der Probefahrt-Bereich 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 gefü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 geliefert, wenn der Besucher ein Datum auswählt. Das Plugin verwendet die Zeitzone der WordPress-Website (current_time()) für alle Zeitvergleiche.
• Wenn die Slot-Dauer auf weniger als 1 Minute konfiguriert ist, verwendet das Plugin standardmässig 30-Minuten-Slots.
• Wenn die Startzeit in der Konfiguration gleich oder grösser als die Endzeit ist, werden für kein Datum Slots generiert.
• Die Probefahrt-Funktion verhindert keine Doppelbuchungen. Mehrere Besucher können dasselbe Zeitfenster anfragen. Die Terminverwaltung wird von der Garage manuell durchgeführt.
• Sperrtage können als durch Zeilenumbruch oder Komma getrennte Liste von Daten im Format Y-m-d eingegeben werden (z. B. 2025-12-25). Ungültige Datumseinträge werden stillschweigend ignoriert.

Fehlerbehebung

Das Probefahrt-Kontrollkästchen erscheint nicht im Kontaktformular.

• Überprüfen Sie, ob der Hauptschalter für die Probefahrt in den Plugin-Einstellungen aktiviert ist.
• Vergewissern Sie sich, dass der Kontaktformular-Block im Layout Manager auf der einzelnen Fahrzeugseite aktiviert ist.

Nach der 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, gibt es möglicherweise keine verbleibenden Slots mehr.
• Überprüfen Sie die Konfiguration des Zeitfensters: Die Startzeit muss vor der Endzeit liegen.

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

• 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

• Fahrzeugdetailseiten