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 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? | 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 | intger | Der Verifikations-Link wird ungültig nach X Tagen | 2 |
| deleteMode | integer | 1: setze delete-Flag; 2: lösche endgültig | 1 |
| 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 | |
| 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 |
| 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 |
| overrideFlexformSettingsIfEmpty | string | Leere Flexforms sollen durch TypoScript überschrieben werden | alle uids… |
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.
Beispiele¶
Sprachen¶
Man kann die Texte für andere Sprachen so überschreiben:
[globalVar = GP:L = 1]
plugin.tx_fpnewsletter_pi1.settings.company = Your company
[end]
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.