TWT Contact Bar
Funktionsweise
Basics
Die Extension registriert drei Plugins: Newsletter, Callback und Social Media.
Diese Plugins werden in der setup.txt in die COA lib.twtcontactbar.desktop und lib.twtcontactbar.mobile geschrieben, welche an den entsprechenden Stellen im Template gerendert werden. In der setup.txt werden die Plugins mit den entsprechenden Settings ausgestattet.
Controller
Die Controller der Plugins erweitern den AbstractContactBarController welcher das ContactBarControllerInterface implementiert.
Dadurch muss in den einzelnen Controllern lediglich die submitAction implementiert werden, welche die speziellen Anforderungen erfüllt (Mailversand, Newsletterregistrierung, etc.).
Formulare
Die Formular-Klassen implementieren das ContactBarFormInterface, wodurch sie die $formAnchorName Property bereitstellen. Diese wird genutzt, um die doppelte Ausführung der submitAction zu verhindern (die Plugins sind einzeln für Mobile und Desktop eingebunden). Einzelheiten siehe AbstractContactBarController::initializeSubmitAction.
Konfiguration
Um das durch TypoScript geladene Plugin durch den Redakteur konfigurierbar zu machen, wird die Konfiguration durch Datensätze vorgenommen. Hauptdatensatz ist die ContactBarConfiguration, welches die anderen Konfig-Datensätze enthält (IRRE). Die ContactBarConfiguration beinhaltet den CountryCode, welcher mit dem im TypoScript des Mandanten übereinstimmen muss (twt_customer.countryCode, vgl. Configuration/TypoScript/setup.txt:10). Wenn kein Konfig-Datensatz (für einen Controller) gefunden wird, wird (dieser Controller) durch die StopActionException gestoppt - der Tab in der ContactBar wird nicht gerendert.
Besonderheiten
Der Redakteur kann festlegen, ob er einen Confirmation-Text innerhalb der Contact Bar anzeigen oder auf eine Bestätigungsseite weiterleiten will. Die Angabe einer Sprungmarke ist möglich.
