Inhaltsverzeichnis
Mit dem Formbuilder gestalten Sie die Anfrage- und Kontaktformulare von WPCarSync direkt im WordPress Backend. Sie passen die automatisch eingesetzten Systemformulare an und erstellen beliebig viele eigene Formulare, die Sie per Shortcode auf jeder Seite einbinden.
Gehen Sie zu WPCarSync -> Module -> Kontaktformulare.
INFO! Diese Seite behandelt Anfrage- und Kontaktformulare. Die Suchmasken der Fahrzeugbörse finden Sie unter Filterformulare.
Formularliste und Editor
Die Liste zeigt alle Formulare mit der Spalte „Shortcode“, aus der Sie den Shortcode kopieren können. Über „anlegen“ erstellen Sie ein neues Formular.
Der Editor eines Formulars besteht aus folgenden Bereichen:
- Titel des Formulars, darunter eine Box mit dem Shortcode
- Box „Formularfelder“ im Hauptbereich
- Box „Einstellungen“ in der Seitenleiste: Layout, Empfänger, Betreff, Button und Kopie an den Kunden
- Box „Export / Import“ in der Seitenleiste
- mit dem AddOn WPCS Lead Importer zusätzlich eine Box für den XML-Export
Einstellungen, die für alle Formulare gelten (Spam-Schutz, Danke-Nachricht, Datenschutz), finden Sie unter Admin Settings.
Systemformulare und eigene Formulare
Systemformulare
WPCarSync legt sieben Systemformulare an und setzt sie automatisch auf der passenden Seite ein:
- Fahrzeuganfrage: Fahrzeug-Einzelansicht
- Angebotsanfrage: Angebots-Einzelseite
- Serviceanfrage: Service-Einzelseite
- Modellanfrage: Modell-Einzelseite
- Standortanfrage: Standortseite
- Anfrage zur Marke: Markenseite
- Allgemeine Anfrage: alle übrigen Stellen, an denen der Shortcode [WPCS_form] ohne Parameter steht, z.B. bei Stellenangeboten
Systemformulare bearbeiten Sie wie eigene Formulare: Felder, Reihenfolge, Gruppen, Bedingungen, Layout, Empfänger und Kopie an den Kunden. Dabei gilt:
- Die „Standortauswahl“ lässt sich nicht entfernen (Schloss-Symbol), weil die Zustellung der Anfrage daran hängt.
- In der Formularliste steht als Shortcode [WPCS_form] mit dem Vermerk „System-Formular“.
- Systemformulare lassen sich nicht exportieren.
- Bei Plugin-Updates und bei erneuter Aktivierung legt WPCarSync nur fehlende Systemformulare an. Ihre Anpassungen bleiben erhalten.
Felder ab Werk
Die Systemformulare enthalten ab Werk folgende Felder:
- Fahrzeuganfrage und Modellanfrage: Basisfelder, „Interessiert an“, Gruppe „Leasinginfos“, Gruppe „Finanzierungsinfo“, „Thema der Anfrage“, „Standortauswahl“
- Angebotsanfrage und Anfrage zur Marke: Basisfelder, „Thema der Anfrage“, „Standortauswahl“
- Serviceanfrage: Basisfelder, „Wunschtermin & Uhrzeit“, „Thema der Anfrage“, „Standortauswahl“
- Standortanfrage: Basisfelder (der Standort ergibt sich aus der Seite)
- Allgemeine Anfrage: Basisfelder, „Standortauswahl“
Basisfelder sind Anrede (Herr/Frau/Divers), Name (Pflicht), E-Mail (Pflicht), Firma, Telefon und Nachricht.
„Interessiert an“ bietet die Checkboxen Fahrzeugangebot, Probefahrt, Rückruf, Finanzierungsangebot, Leasingangebot und Versicherungsangebot.
Die Gruppe „Leasinginfos“ erscheint nur, wenn „Leasingangebot“ angehakt ist, die Gruppe „Finanzierungsinfo“ nur bei „Finanzierungsangebot“. Beide enthalten die Felder Wunschlaufzeit in Monaten (12, 24, 36, 48, 60), Wunschlaufleistung pro Jahr in km (5000 bis 25000 in 5000er-Schritten) und Wunschanzahlung.
Der Button heißt bei der Angebotsanfrage „Angebot anfragen“, bei allen anderen Systemformularen „Anfrage senden“.
Eigene Formulare
Sie können beliebig viele eigene Formulare anlegen. Ein neues Formular startet leer, Sie stellen es aus Standardfeldern und eigenen Feldern zusammen. Eingebunden wird es per Shortcode mit der ID des Formulars, siehe Formular einbinden.
Felder hinzufügen und anordnen
Alle Felder eines Formulars stehen in der Box „Formularfelder“ im Abschnitt „Aktive Felder“. Ziehen Sie Felder per Drag & Drop in die gewünschte Reihenfolge. Ein Klick auf ein Feld klappt es zum Bearbeiten auf. Jede Zeile zeigt:
- Bezeichnung und Feldschlüssel
- einen Stern bei Pflichtfeldern und den Feldtyp
- die Herkunft: „Standard“, „Eigenes Feld“, „Gruppe“, „Kontext“ oder „System“
- ein Augen-Symbol, wenn eine Bedingung gesetzt ist
Standardfelder
Über „Standardfelder hinzufügen“ fügen Sie folgende Felder je einmal pro Formular ein: Anrede, Name, E-Mail, Firma, Telefon, Nachricht, Interessiert an und Wunschtermin & Uhrzeit.
Bezeichnung, Auswahlwerte und Pflicht-Status der Standardfelder sind fest. Name und E-Mail sind immer Pflichtfelder, die übrigen nie. Die E-Mail-Adresse wird auf ein gültiges Format geprüft. Einstellen können Sie Position, Breite und Bedingung.
Eigene Felder
Über „Eigenes Feld erstellen“ öffnet sich der Bereich „Neues eigenes Feld“. Für alle Feldtypen gibt es diese Einstellungen:
- „Feldname (Schlüssel)“: nur Kleinbuchstaben, Zahlen und Unterstrich. Der Schlüssel muss im Formular eindeutig sein und ist nach dem Speichern nicht mehr änderbar. Sie verwenden ihn z.B. als Platzhalter im Betreff.
- „Bezeichnung“: das Label im Formular
- „Feldtyp“
- „Pflichtfeld“ (außer beim Feldtyp Hidden)
INFO! Eigene Felder haben keine Formatprüfung. Eine Eingabe in einem Textfeld wird z.B. nicht als Telefonnummer oder E-Mail-Adresse geprüft.
Feldtyp Text
Einzeiliges Eingabefeld. Einstellung: „Pflichtfeld“.
Feldtyp Textarea
Mehrzeiliges Eingabefeld. Einstellung: „Pflichtfeld“.
Feldtyp Dropdown
Auswahlliste mit den Einstellungen „Auswahloptionen“, „Platzhalter“, „Pflichtfeld“ und „In E-Mail/XML anzeigen“.
Der Platzhalter, z.B. „- Bitte wählen -„, gilt bei Pflichtfeldern nicht als Auswahl.
„Auswahloptionen“: eine Option pro Zeile, entweder als Wert und Beschriftung getrennt durch einen senkrechten Strich oder nur als Beschriftung:
pkw|PKW
transporter|Transporter
Wohnmobil
„In E-Mail/XML anzeigen“: „Wert (value)“ oder „Beschriftung (label)“. Damit steuern Sie, ob in der E-Mail bzw. im Lead-System der technische Wert (pkw) oder der lesbare Text (PKW) ankommt.
Feldtyp Checkbox (Mehrfachauswahl)
Mehrere Optionen zum Anhaken. Einstellungen: „Auswahloptionen“ (wie beim Dropdown), „Pflichtfeld“ (mindestens ein Haken) und „In E-Mail/XML anzeigen“.
Feldtyp Datum
Datumsfeld mit dem Datumswähler des Browsers. Einstellungen: „Frühestes auswählbares Datum“, „Spätestes auswählbares Datum“ und „Pflichtfeld“.
Mögliche Werte für die Grenzen:
todayfür den heutigen Tag- relativ, z.B.
+7 daysoder+30 days - fest, z.B.
31.12.2026 - leer für keine Grenze
Feldtyp Zeit
Uhrzeit-Auswahl mit eigenem Auswähler. Einstellungen: „Startuhrzeit“, „Enduhrzeit“, „Zeitintervall (Minuten)“ mit 1, 5, 10, 15, 30 oder 60 Minuten, „Platzhalter“ und „Pflichtfeld“.
Beispiel: Startuhrzeit 07:30, Enduhrzeit 17:00, Zeitintervall 15 Minuten.
Feldtyp Datum & Uhrzeit
Kombiniertes Feld mit dem Wähler des Browsers, ohne Grenzen. Einstellung: „Pflichtfeld“.
Feldtyp Hidden (versteckt)
Unsichtbares Feld mit der Einstellung „Standardwert“. Der Wert wird mit jeder Anfrage übertragen und erscheint in E-Mail und Lead, z.B. als Kampagnen-Kennung auf einer Aktions-Landingpage.
Feldtyp Datei-Upload
Einstellungen: „Erlaubte Dateitypen“ (PDF und/oder Bilder JPG, PNG, WebP), „Max. Anzahl Dateien“ (1 bis 20, Standard 5) und „Pflichtfeld“. Details unter Datei-Upload.
Bedingte Sichtbarkeit
An jedem Feld finden Sie den Bereich „Bedingte Sichtbarkeit“. Wählen Sie unter „Nur anzeigen wenn“ das auslösende Feld und unter „den Wert hat“ den passenden Wert.
- Über „Weitere Bedingung (ODER)“ ergänzen Sie weitere Bedingungen. Das Feld erscheint, sobald eine davon erfüllt ist.
- Auslöser können Dropdown- und Checkbox-Felder des Formulars sein, Standardfelder oder eigene Felder, sofern sie nicht in einer Gruppe liegen.
- Möglich ist nur „hat den Wert“ mit ODER-Verknüpfung. Eine Bedingung „ist nicht“ oder eine UND-Verknüpfung gibt es nicht, Textfelder können keine Bedingung auslösen.
- Felder werden live im Browser ein- und ausgeblendet, ohne dass die Seite neu lädt.
- Ausgeblendete Felder werden nicht geprüft, auch Pflichtfelder nicht. Sie werden nicht übertragen und erscheinen weder in der E-Mail noch im Lead.
INFO! Bedingungen an Feldern innerhalb einer Feldgruppe werden derzeit nicht ausgewertet. Steuern Sie die Sichtbarkeit dort über die Bedingung der Gruppe.
Feldgruppen
Über „Feldgruppe erstellen“ legen Sie eine Gruppe an. Der „Gruppen-Titel“ erscheint als Überschrift im Formular und als Abschnittsüberschrift in der E-Mail. Ziehen Sie die gewünschten Felder per Drag & Drop in die Gruppe.
Unter „Wann soll diese Gruppe sichtbar sein?“ setzen Sie eine Bedingung für die ganze Gruppe, ebenfalls mit ODER-Verknüpfung. Die Gruppe wird dann vollständig ein- oder ausgeblendet.
Beispiel ab Werk: In der Fahrzeuganfrage erscheint die Gruppe „Leasinginfos“ nur, wenn unter „Interessiert an“ die Option „Leasingangebot“ angehakt ist.
Layout
In der Box „Einstellungen“ wählen Sie den „Layout Modus“:
- „Grid (Spalten)“: Die Felder werden in 1 bis 4 Spalten angeordnet.
- „Flex (individuelle Breiten)“: Jedes Feld und jede Gruppe erhält eine eigene Breite von 25, 33, 50, 66, 75 oder 100 %. So stehen z.B. PLZ (25 %) und Ort (75 %) in einer Zeile.
Unter „Abstand (Gap)“ legen Sie den Abstand zwischen den Feldern in Pixeln fest, Standard ist 25.
Die Feldliste im Editor ordnet sich bereits in der gewählten Spaltenzahl bzw. den gewählten Breiten an. Eine Vorschau des fertigen Formulars gibt es im Editor nicht. Prüfen Sie das Ergebnis im Frontend.
Darstellung auf kleineren Bildschirmen
Das Formular passt sich in beiden Designvarianten (Legacy und Modern) automatisch an:
- 4 Spalten werden unter 1400 px Breite zu 3 Spalten.
- 3 und 4 Spalten werden unter 998 px Breite zu 2 Spalten.
- Ab 768 px Breite und darunter stehen alle Felder untereinander, auch im Flex-Modus.
INFO! Farben und Schriften des Formulars stellen Sie nicht im Formbuilder ein. Das Aussehen kommt aus den Design-Einstellungen bzw. aus Layout V4.
Thema der Anfrage und Standortauswahl
Thema der Anfrage
Das Element „Thema der Anfrage“ im Bereich „Formular-Kontext“ zeigt im Formular, worauf sich die Anfrage bezieht. Sie können es frei positionieren oder entfernen. Es wirkt nur in Systemformularen, weil nur dort ein Bezug zu Fahrzeug, Angebot usw. besteht.
Standortauswahl
Mit der „Standortauswahl“ wählt der Interessent unter „Anfrage an folgenden Standort senden *“ den Standort, an den die E-Mail geht. Unterstandorte werden berücksichtigt. Die Auswahl wird automatisch ausgeblendet, wenn die Seite den Standort vorgibt oder nur ein Standort wählbar ist.
Was die Seite beisteuert
- Fahrzeug: „Thema der Anfrage“ zeigt Fahrzeugbild, Hersteller, Modell und interne Nummer. Die Standortauswahl entfällt, der Standort des Fahrzeugs ist vorgegeben.
- Angebot: Angebotsbild und Titel. Zur Auswahl stehen nur Standorte der Marke des Angebots.
- Modell: Modellbild und Titel. Zur Auswahl stehen nur Standorte der Marke.
- Service: Bild und Titel des Services. Zur Auswahl stehen nur Standorte, die den Service anbieten.
- Marke: Markenlogo und Name. Zur Auswahl stehen nur Standorte der Marke.
- Standort: Die Standortauswahl entfällt, die Anfrage geht an den Standort der Seite.
E-Mail-Empfänger
In der Box „Einstellungen“ legen Sie unter „E-Mail Empfänger Modus“ fest, wohin die Anfrage geht:
- „Standard (alle Standorte)“: Alle Standorte stehen zur Auswahl, die E-Mail geht an den gewählten Standort.
- „Bestimmte Standorte“: Per Checkbox-Liste legen Sie fest, welche Standorte überhaupt zur Auswahl stehen.
- „Eigene E-Mail-Adresse“: Die E-Mail geht unabhängig vom Standort an eine feste Adresse oder an mehrere, durch Komma getrennt.
„Zusätzliche E-Mail-Empfänger“: Diese Adressen erhalten jede Anfrage zusätzlich, unabhängig vom Modus. Mehrere Adressen trennen Sie durch Komma, jeder Empfänger bekommt eine eigene E-Mail.
„E-Mail-Typ für Standort“: „Standard (aus WPCarSync-Einstellungen)“, „Lead-E-Mail des Standorts“ oder „Standard-E-Mail des Standorts“. So kann z.B. ein Formular an die Lead-Adresse eines Standorts gehen und ein anderes an dessen allgemeine Adresse.
Hat ein Formular weder eine Standortauswahl noch eine eigene E-Mail-Adresse, zeigt der Editor einen Warnhinweis („Achtung: Dieses Formular hat keine Standortauswahl …“).
Antwort-Adresse der E-Mail an den Händler ist der Interessent. „Antworten“ im Mailprogramm schreibt also direkt an ihn. Einen festen Standort für ein Formular geben Sie mit dem Shortcode-Parameter location vor, siehe Formular einbinden.
Betreff, Button-Text und Platzhalter
„E-Mail Betreff“: Bleibt das Feld leer, lautet der Betreff „Name der Website – Formulartitel“. Das gilt auch für Systemformulare, z.B. „Autohaus Muster – Fahrzeuganfrage“.
Platzhalter: Im Betreff können Sie Eingaben aus dem Formular verwenden. Schreiben Sie dazu den Feldschlüssel in doppelte geschweifte Klammern, z.B.:
Probefahrt-Anfrage von {{name}}
Aktion {{kampagne}}: Anfrage von {{name}}
Ankauf: {{marke}} {{modell}}
- Platzhalter funktionieren im Betreff an den Händler und im Betreff an den Kunden.
- Bei Mehrfachauswahlen werden die gewählten Werte mit Komma verbunden.
- Unbekannte Platzhalter fallen weg.
„Button Text“: die Beschriftung des Absende-Buttons, einstellbar pro Formular.
Inhalt der E-Mail an den Händler
- Formulartitel als Überschrift
- alle ausgefüllten Felder in der Reihenfolge des Formulars, leere Felder fallen weg
- Feldgruppen als eigene Abschnitte mit dem Gruppen-Titel
- der gewählte Standort
- „Seite:“ mit dem Link zur Seite, von der das Formular abgeschickt wurde. Das gilt für jedes Formular, auch für eigene.
- hochgeladene Dateien als Anhang
Bei der Fahrzeuganfrage enthält die E-Mail zusätzlich Hersteller, Modell, den Link zum Fahrzeug und die Händler-Fahrzeugnummer.
INFO! Eigene Formulare kennen das Fahrzeug nicht. „Thema der Anfrage“ und die Fahrzeugdaten gibt es nur bei den Systemformularen. Bei eigenen Formularen zeigt der Link unter „Seite:“, woher die Anfrage kam.
Kopie an den Kunden
In der Box „Einstellungen“ aktivieren Sie unter „E-Mail Kopie an Kunden“ die Option „Kunde erhält eine Kopie der Anfrage“. Danach stehen folgende Felder zur Verfügung:
- „Betreff für Kunden-E-Mail“: Bleibt das Feld leer, wird der Betreff an den Händler übernommen. Platzhalter funktionieren auch hier.
- „Nachricht an Kunden“: Ihr persönlicher Text. Einfaches HTML wie Fettdruck ist erlaubt, Zeilenumbrüche bleiben erhalten. Ohne eigenen Text gilt: „Vielen Dank! Wir haben Ihre Nachricht erhalten. Unten finden Sie eine Kopie Ihrer Anfrage:“
- „E-Mail-Signatur (HTML)“: Fügen Sie hier eine HTML-Signatur ein, z.B. aus Ihrem Newsletter- oder Mailprogramm. Sie wird unverändert an das Ende der E-Mail gehängt. Bilder müssen über eine öffentliche URL eingebunden sein.
Die E-Mail an den Kunden besteht aus der persönlichen Nachricht, einer Trennlinie, der Kopie der Anfrage und der Signatur. Sie enthält keine Dateianhänge. Antwort-Adresse ist die E-Mail-Adresse des Standorts.
Alternativ können Sie die Kopie an den Kunden global für alle Formulare aktivieren („Mail cc an Kunde“, siehe Admin Settings).
Datei-Upload
Mit einem Feld vom Typ Datei-Upload hängen Interessenten eine oder mehrere Dateien an. Hochgeladene Dateien werden unter dem Feld aufgelistet und lassen sich vor dem Absenden wieder entfernen.
- Erlaubte Dateitypen: PDF, JPG, PNG und WebP
- Der Server prüft den tatsächlichen Dateityp, nicht nur die Dateiendung.
- höchstens 10 MB je Datei, die Anzahl je Feld ist einstellbar (1 bis 20)
Die Dateien gehen als Anhang an den Hauptempfänger und werden danach beim Lead gespeichert. Die Kopie an den Kunden und die zusätzlichen E-Mail-Empfänger erhalten derzeit keine Anhänge.
Anfragen als Lead
Jede Absendung wird als Lead in WordPress gespeichert, egal ob aus einem Systemformular oder einem eigenen Formular. Sie finden die Leads unter WPCarSync -> Module -> Leads, gemeinsam mit Leads aus Suchaufträgen und Reservierungen.
- Der Lead enthält alle übertragenen Felder.
- Am Lead wird der Mailversand protokolliert: „Mailversand erfolgt“ bzw. „Mailversand fehlgeschlagen“.
- Hochgeladene Dateien liegen beim Lead.
Formular einbinden
Shortcode [WPCS_form]
Ohne Parameter erkennt der Shortcode anhand der Seite, welches Systemformular passt: Fahrzeug, Angebot, Modell, Service, Standort oder Marke, sonst die Allgemeine Anfrage. Der Shortcode funktioniert überall, wo WordPress Shortcodes ausführt (Elementor, Gutenberg, klassischer Editor), auch mehrfach auf einer Seite.
Parameter: id
Werte: Formular-ID
Zeigt ein eigenes Formular an. Die ID steht in der Formularliste.
Parameter: location
Werte: Standort-ID
Gibt den Standort fest vor, die Standortauswahl entfällt. Geeignet z.B. für eine Standort-Landingpage.
Parameter: context
Werte: general, vehicle, wpcs_offer, wpcs_model, wpcs_service, wpcs_brand, wpcs_location
Erzwingt ein bestimmtes Systemformular.
Parameter: object_id
Werte: ID des Fahrzeugs, Angebots, Modells usw.
Zusammen mit context: das Systemformular für ein bestimmtes Objekt.
Parameter: template
Werte: Name des Templates
Verwendet ein eigenes Formular-Template, siehe Templates in WPCarSync.
Parameter: mail_address
Werte: E-Mail-Adresse
Wirkt nur bei Formularen mit dem Empfänger Modus „Eigene E-Mail-Adresse“ und ersetzt dann die eingestellte Adresse.
Beispiele:
[WPCS_form]
[WPCS_form id="123"]
[WPCS_form id="123" location="45"]
[WPCS_form context="wpcs_offer" object_id="456"]
Das letzte Beispiel zeigt die Angebotsanfrage zum Angebot mit der ID 456 auf einer beliebigen Landingpage.
INFO! Die Parameter grid, gap und layout_mode haben keine Wirkung mehr. Das Layout kommt aus den Einstellungen des Formulars.
Export und Import
In der Box „Export / Import“ übertragen Sie Formulare auf andere Websites:
- „Formular exportieren (.json)“: speichert das Formular als JSON-Datei. Das geht nur bei eigenen Formularen.
- „Importieren“: legt aus einer JSON-Datei ein neues Formular mit dem Titel „Titel (Import)“ an.
Übernommen werden Felder, Reihenfolge, Gruppen, Bedingungen, Breiten, alle Einstellungen (Layout, Empfänger, Betreff, Button, Kopie an den Kunden, Signatur) und die XML-Konfiguration.
Weitergabe an Lead-Systeme (XML)
Mit dem AddOn WPCS Lead Importer erscheint im Editor jedes Formulars eine zusätzliche Box für den XML-Export. Darin legen Sie fest, wie die Anfrage in Ihrem Lead-System ankommt:
- „XML Export aktivieren“
- „XML Modus“: „Standard-Mapping (Felder einzeln zuordnen)“ oder „Eigenes XML-Template (komplett eigene Struktur)“
- „XML Standardwerte“: Subject, Lead Type, Lead Source 2, Lead Channel, Campaign Name und Marketing Campaign, jeweils aus einem Formularfeld oder als fester Text
- „XML-Zuordnungen“: Formularfeld, Gruppe (z.B. lead, potentialBuyer, vehicle, form_fields, add_fields, message) und Tag-Name. Ein Feld kann mehrfach zugeordnet werden.
- Eigenes Template: XML-Struktur mit Platzhaltern im Format {{feldname}}. Über den Button „Catch Lead Vorlage laden“ fügen Sie eine Vorlage ein.
Beispiel: Auf einer Aktions-Landingpage füllen Sie „Campaign Name“ aus einem Hidden-Feld kampagne.
Für Entwickler
Die bestehenden Filter des Kontaktformulars finden Sie unter Anpassbarkeit / Hooks, die Template-Funktionen unter Template Funktionen. Für den Formbuilder sind zusätzlich folgende Hooks relevant.
Hooks
wpcs_contactform_field_values
Parameter: $values, $key, $field, $context
Füllt die Auswahloptionen von Dropdown- und Checkbox-Feldern dynamisch, z.B. mit aktuellen Modellen oder Filialen. Wirkt auch auf die Umwandlung von Wert in Beschriftung in der E-Mail.
wpcs_contactform_field_values_<feldschluessel>
Parameter: $values, $field, $context
Wie oben, aber nur für das Feld mit dem angegebenen Schlüssel.
add_filter('wpcs_contactform_field_values_filiale', function($values, $field, $context){
// Auswahloptionen des Feldes "filiale" per Code festlegen (Wert => Beschriftung)
$values = array(
'nord' => 'Filiale Nord',
'sued' => 'Filiale Süd',
);
return $values;
}, 10, 3);
DXIM_FILTER_FORM_DEALER_MAIL (dxim_filter_form_dealer_mail)
Parameter: $to, $context, $post
Zugriff auf die Empfänger-Adresse des Autohauses. Der Filter erhält inzwischen drei Parameter.
dxim_filter_form_from_mail
Zugriff auf die Absender-Adresse.
dxim_filter_form_message_client
Parameter: $msg_client, $msg, $post, $context
Zugriff auf den Inhalt der E-Mail an den Kunden.
dxim_allow_form_client_cc
Parameter: $allow, $context
Erlaubt oder unterbindet die Kopie an den Kunden.
dxim_filter_contactform_custom_context
Eigene Formular-Kontexte ergänzen.
dxim_filter_contactform_location_html
Zugriff auf das HTML der Standortauswahl.
dxim_filter_contactform_before_close_form
Eigenes HTML vor dem schließenden form-Tag ausgeben.
dxim_lead_created (Action)
Parameter: $lead_id
Wird nach dem Speichern jedes Leads ausgeführt.
add_action('dxim_lead_created', function($lead_id){
// z.B. den Lead an ein externes System übergeben
}, 10, 1);
Für AddOns stehen die Action wpcs_contactform_xml_metabox_register sowie die Filter wpcs_contactform_xml_groups und wpcs_contactform_xml_template_button zur Verfügung.
Template-Funktionen
Für eigene Formular-Templates stehen folgende Funktionen zur Verfügung:
- wpcs_contactform_draw_fields()
- wpcs_contactform_draw_conditional_fields($grid, $layout_mode, $gap)
- wpcs_contactform_draw_context()
- wpcs_contactform_draw_location()
- wpcs_contactform_has_location_field()
- wpcs_contactform_draw_field($key)
- wpcs_contactform_draw_captcha()
- wpcs_contactform_draw_privacy()
- wpcs_contactform_draw_submit()
INFO! Die Funktion wpcs_contactform_draw_vehicle() gibt es nicht mehr. Ein Aufruf in einem eigenen Template erzeugt einen PHP-Fehler.
Templates
- Formular: contactform/form.php
- E-Mails: contactform/mail_<kontext>.php, also mail_vehicle, mail_wpcs_offer, mail_wpcs_service, mail_wpcs_model, mail_wpcs_location, mail_wpcs_brand, mail_general und für eigene Formulare mail_wpcs_contactform
Die Plugin-Templates liegen unter tpl/legacy/ bzw. tpl/modern/. Wie Sie Templates überschreiben, lesen Sie unter Templates in WPCarSync.
Datenspeicherung
- Formulare sind Beiträge vom Typ wpcs_contactform.
- Die Konfiguration liegt in Post-Meta: _wpcs_contactform_field_order, _custom_fields, _field_conditions, _field_groups, _field_widths und _settings sowie die Schlüssel der XML-Konfiguration.
- Systemformulare tragen zusätzlich _wpcs_system_form und _wpcs_system_context.
- Anfragen werden als Leads gespeichert, hochgeladene Dateien im Lead-Verzeichnis.
Admin Settings
Gehen Sie zu WPCarSync -> Einstellungen -> Kontaktformular. Diese Einstellungen gelten für alle Formulare:
- Spam-Schutz: deaktiviert, Rechenaufgabe (z.B. „drei + 7“, der Platzhalter-Text ist einstellbar) oder Google reCAPTCHA v3 mit Public und Private Key. Ist die reCAPTCHA-API bereits anderweitig eingebunden, können Sie das Laden durch WPCarSync abschalten.
- „Danke Nachricht“: Text nach erfolgreichem Versand. Standard: „Vielen Dank, wir haben Ihre Nachricht erhalten.“
- „Weiterleitung“: Weiterleitung auf eine Danke-Seite nach dem Versand, z.B. für die Conversion-Messung
- „Mail cc an Kunde“: Kopie an den Kunden für alle Formulare
- Datenschutzseite: Ist eine Seite gewählt, erscheint in jedem Formular die Pflicht-Checkbox „Ich habe die Datenschutzbestimmungen gelesen und akzeptiere diese.“ mit Link.
Das Absenden läuft per AJAX, ohne dass die Seite neu lädt. Nicht ausgefüllte Pflichtfelder werden markiert.
