Kontaktformular

In brandbox ist ein einfaches Kontaktformular integriert welches Besuchern eine Möglichkeit bietet mit dem Betreiber in Kontakt zu treten.

Aufbau des Plugins

Eine Kontaktanfrage wird dem Ersteller der Anfrage nach dem Absender per E-Mail zugesandt und zusätzlich in einer Datenbanktabelle innerhalb von brandbox gespeichert. Diese Datenbanktabelle befindet sich in der Kachel "Kontakt-Formular" welche der Kachel-Gruppe "cms" zugeordnet ist. Als Vorlage für die Informationsemail an den Ersteller der Anfrage wird die E-Mail-Vorlage mit dem Schlüssel contactForm genutzt.

Konfiguration

Neben den Standardfeldern des Formulars können zusätzliche Felder über die Datenmodellierung ergänzt werden. Damit über die Datenmodellierung ergänzte Felder im Kontaktformular sichtbar sind müssen diese über die Feldkonfiguration für das Kontaktformular freigegeben werden. Dies geschieht durch den Konfigurationsparameter whitelist. Dieser muss den Wert contact beinhalten.

Beispielhafte Feldkonfiguration

whitelist:
  - contact

Die entsprechende Formularmaske aus der Modelling muss der Datenbanktabelle "Kontaktanfragen" zugeordnet werden. Es können keine Feldgruppen genutzt werden.

Verwendung

Über die Shop-Einrichtung wird bereits eine entsprechende Seite mit einem platzierten Kontaktformular erstellt. An diesem Objekt können verschiedene Einstellungen durchgeführt werden. Zudem besteht bei den Objekteinstellungen die Möglichkeit Übersetzungen für den Bestätigungstext sowie den Absenden-Button zu hinterlegen.

Events

Interface: \brandbox\cms\viewContact\lib\event\viewContactEventInterface

Methoden	Beschreibung

Methoden	Beschreibung
`onPopulateFormEntity`	Kann verwendet werden um das `$form` und dessen Inhalt zu erweitern oder zu verändern
`onRequestIgnoreViolations`	Kann verwendet werden um Felder aus der Validierung nach dem Absenden des Formulars raus zu nehmen