Konfiguration

Hier sieht man, welche TypoScript-Einstellungen vorgenommen werden können. Es gibt mehr TypoScript-Einstellungen als FlexForm-Einstellungen, was bedeutet, dass man nicht alles per FlexForms einstellen kann.

TypoScript Referenz

Konfiguration via TypoScript (und FlexForms).

Settings-Einstellungen

Feld	Typ	Beschreibung	Standard-Wert
table	string	Bisher nur tt_address oder keine Tabelle (leerer Wert) möglich	tt_address
optionalFields	string	Optionale Werte: siehe weiter unten	gender,firstname,lastname
optionalFieldsRequired	string	Optionale erforderliche* Werte: siehe weiter unten
doubleOptOut	boolean	Double opt out Abmeldung einschalten?	1
disableErrorMsg	boolean	Manche Fehlermeldungen ignorieren (z.B. bereits/nicht angemeldet)?	0
enableUnsubscribeForm	boolean	Abmeldeformular auf der Anmeldeseite mit ausgeben?**	0
enableUnsubscribeGdprAsHidden	boolean	DSGVO-Checkbox beim Abmeldeformular verbergen?	0
subscribeUid	integer	Seite für die Anmeldung	1
subscribeMessageUid	integer	Optionale Seite für einen Redirect nach der Anmeldung
subscribeVerifyUid	integer	Seite für die Anmelde-Verifikation
subscribeVerifyMessageUid	integer	Optionale Seite für den Redirect nach der Anmelde-Verifikation
unsubscribeUid	integer	Seite für die Abmeldung	1
unsubscribeMessageUid	integer	Optionale Seite für den Redirect nach der Abmeldung
unsubscribeVerifyUid	integer	Seite für die Abmelde-Verifikation (demnächst)
unsubscribeVerifyMessageUid	integer	Optionale Seite für den Redirect nach der Abmelde-Verifikation***
gdprUid	integer	Seite mit den DSGVO-Texten	1
daysExpire	integer	Der Verifikations-Link wird ungültig nach X Tagen	2
searchPidMode	integer	Suche in tt_address: 0: nur im 1. Ordner; 1: in allen Ordners°	0
deleteMode	integer	1: setze delete-Flag; 2: lösche endgültig	1
languageMode	integer	0: setzt -1 wenn L>0; 1: benutzte die sys_language_uid von pages	0
module_sys_dmail_html	integer	0: nur TEXT; 1: TEXT und HTML; -1: ignoriere dieses Feld	1
module_sys_dmail_category	string	Komma separierte Liste von Kategorien (uid) aus sys_dmail_category
reCAPTCHA_site_key	string	Websiteschlüssel für Google reCaptcha v3. curl wird benötigt!
reCAPTCHA_secret_key	string	Geheimer Schlüssel für Google reCaptcha v3
mathCAPTCHA	integer	Zeige ein mathematisches Captcha? 0: nein; 1, 2: ja, mit 1-2 Ziffern	0
honeypot	boolean	Einen Honigtopf (honeypot) gegen Spam einschalten?	0
company	string	Name der Firma	Ihre Firma
gender.please	string	Text für die Anrede-Auswahl	Bitte auswählen
gender.mr	string	Text für Herr	Herr
gender.mrs	string	Text für Frau	Frau
parameters.active	string	Parameter für Anmeldung aus externer Extension (POST-Parameter)
parameters.email	string	Parameter für die E-Mail externer Herkunft (GET/POST-Parameter)
email.senderMail	string	E-Mail-Adresse des Absenders	beispiel@test.de
email.senderName	string	Absender-Name	Absender-Name
email.subscribeVerifySubject	string	Betreff der Verifikations-E-Mail (Anmeldung)	Bitte verifizieren ...
email.unsubscribeVerifySubject	string	Betreff der Verifikations-E-Mail (Abmeldung)	Bitte verifizieren ...
email.adminMail	string	Admin E-Mail-Adresse - wenn nicht leer: der Admin wird informiert
email.adminName	string	Admin-Name	Admin
email.adminSubscribeSubject	string	Betreff der Admin-E-Mail (Anmeldung)	Neue Newsletter-Anmeldung
email.adminUnsubscribeSubject	string	Betreff der Admin-E-Mail (Abmeldung)	Neue Newsletter-Abmeldung
email.adminMailBeforeVerification	boolean	0: sende die E-Mail nach der Verifikation; 1: vor der Verifikation	0
email.subscribedSubject	string	Betreff der Bestätigungsmail (Anmeldung)	Bestätigung Newsletter-Anmeldung
email.unsubscribedSubject	string	Betreff der Bestätigungsmail (Abmeldung)	Bestätigung Newsletter-Abmeldung
email.enableConfirmationMails	boolean	Sende eine Bestätigungs-E-Mail an den Benutzer? 0: nein; 1: ja	0
email.dontAppendL	boolean	Hänge die Sprach-UID an Templates an, wenn L>0? 0: ja; 1: nein	0
overrideFlexformSettingsIfEmpty	string	Leere Flexforms sollen durch TypoScript überschrieben werden	alle uid-Variablen

Achtung*: die optional erforderlichen Werte werden nur per Browser geprüft.

Achtung**: man braucht eine eigene Seite für die Abmeldung. unsubscribeUid muss also angebenen werden.

Achtung***: diese Seite wird auch dann benutzt, wenn doubleOptOut=0. unsubscribeMessageUid wird dann nicht benutzt.

Achtung°: dies funktioniert nur bei der Abmeldung.

Beispiele

Sprachen

Man kann die Texte für andere Sprachen so überschreiben:

[siteLanguage("languageId") == "1"]
plugin.tx_fpnewsletter_pi1.settings.company = Your company
[END]

Achtung: wenn man andere Sprachen in den Emails verwenden will, sollte man das Kapitel "Administrator-Handbuch" lesen.

Externe Felder

Man kann auch eine Default-E-Mail-Adresse aus den Parametern auslesen und übernehmen. Wenn man z.B. im Footer ein Formular mit einem E-Mail-Feld hat, welches nlemail heißt, kann man den abgesendeten Wert wie folgt auslesen lassen:

plugin.tx_fpnewsletter.settings.parameters.email = nlemail

Man kann die Anmeldung auch über ein externes Formular durchführen lassen. Wenn man z.B. einen Shop hat, wo man sich zum Schluß bei einer Bestellung auch zum Newsletter anmelden können soll, dann muss man diese Extension unter die Shop-Extension einfügen und das Template "Anmeldung über externe Extension" auswählen. Zudem muss man die POST-Parameter angeben, die ausgewertet werden sollen:

plugin.tx_fpnewsletter.settings.parameters.active = tx_myshop_pi1|newBestellung|newsletter
plugin.tx_fpnewsletter.settings.parameters.email = tx_myshop_pi1|newBestellung|email

Es können an dieser Stelle nur Parameter von anderen Extensions mit dem selben Format ausgewertet werden. Wenn beide Parameter gesetzt sind, wird zur Action create weitergeleitet.

Captchas

Man kann 2 verschiedene Captchas benutzen. Wenn man das Google reCaptcha v3 benutzen will, muss man nur den website key und den secret key angeben. Wenn man stattdessen ein mathematisches Captcha benutzen will, kann man 1 oder 2 Ziffern verwenden. Der maximale Wert bei 2 Ziffern ist 19. Beispiel:

plugin.tx_fpnewsletter.settings.mathCAPTCHA = 2

Optionale und erforderliche Felder

Nur email und gdpr sind erforderliche Felder im Modell. Wenn man mehr erforderliche Felder haben will, kann man sie nur via TypoScript und Templates als erforderlich markieren. Folgende optionalen Felder sind möglich/stehen zur Verfügung: gender, title, firstname, lastname, address, zip, city, region, country, phone, mobile, fax, www, position, company. Man kann alle diese Felder auch als erforderlich markieren. Hier ein Beispiel für das Anmeldeformular via TypoScript Setup:

plugin.tx_fpnewsletter_pi1.settings.optionalFields = gender,title,firstname,lastname,www,position,company
plugin.tx_fpnewsletter_pi1.settings.optionalFieldsRequired = firstname,lastname,company

Benutzung von Kategorien

Die Tabelle module_sys_dmail_category enthält Kategorien für direct_mail. Diese Extension benutzt diese Kategorien und nicht die von sys_category. Wenn man sie so benutzt:

plugin.tx_fpnewsletter_pi1.settings.module_sys_dmail_category = 1,3

dann tut diese Extension das selbe wie auch direct_mail_subscription. Sie wird 2 Einträge in sys_dmail_ttaddress_category_mm machen und sie wird module_sys_dmail_category in tt_address setzen (nach der Verifikation). Gibt es diesbezüglich etwa andere Erwartungen?

Die Kategorien werden als hidden-Feld ins Template eingefügt. Wenn man eine flexiblere Lösung will, könnte man z.B. Checkboxes per jQuery auswerten und die angeklicken Kategorien ins hidden-Feld kopieren.

Ändern der Labels

Wie in jeder Extension auch, kann man die Labels via TypoScript ändern. Hier 2 Beispiele:

plugin.tx_fpnewsletter._LOCAL_LANG.de.tx_fpnewsletter_domain_model_log.email = Email
plugin.tx_fpnewsletter._LOCAL_LANG.de.tx_fpnewsletter_domain_model_log.gdpr_desc2 = Ich bin damit einverstanden, dass die von mir angegebenen Daten elektronisch erhoben und gespeichert werden.

Man findet die Bezeichnungen in den Templates bei f:translate key.