contaobayern / contao-ertl-bundle
email registration + token login for Contao CMS
Installs: 4
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 5
Forks: 0
Type:contao-bundle
Requires
- php: ^7.4 || ^8.0
- contao/core-bundle: ^4.9
- ramsey/uuid: ^3.8
- terminal42/notification_center: ^1.5
This package is auto-updated.
Last update: 2024-09-17 13:06:49 UTC
README
E-Mail Registration + Token Login
Anforderungen nach Installation des Bundles
Parameter in config/parameters.yml ergänzen
In der Datei config/parameters.yml
die Parameter ergänzen, die das Bundle benötigt
parameters:
# Parameter aus der Contao Installation
database_host: ...
database_port: ...
database_user: ...
database_password: ...
database_name: ...
secret: ...
# Parameter für das Bundle (Beispiele)
ertl_assign_groups.example.com: [1,2,3]
ertl_assign_groups.example.org: [1,4]
# Optionale Parameter:
# Gültigkeitsdauer eines Tokens (im Bsp.: 14 Tage; Default wäre 7 Tage).
ertl_token_lifetime: 1209600
# E-Mails-Adressen bestimmter Domains nicht akzeptieren
# (es erscheint eine entsprechenden Fehlermeldung im Registrierungsformular)
ertl_rejected_domains:
- t-online.de
- web.de
- gmail.com
Fehlerseiten anlegen
Bei einem gescheiterten Loginversuch mit einem ungültigen Token wird je nach Situation auf eine
entsprechende Fehlerseite weitergeleitet. Dafür sollten 401
"not authenticated",
403
"access denied" und 404
"not found" Seiten im Seitenbaum existieren.
Formular
Das Formular muss mindestens ein Eingabefeld "E-Mail-Adresse" haben, das email
heißen muss!
Weitere Felder werden beim Anlegen des Mitglieds, das eingelogt werden soll übernommen, sofern
ihr Name einer Spalte in der Mitgliedertabelle tl_member
entspricht. Bsp.: (firstname
, lastname
)
Zur Identifikation des Formulars muss ein verstecktes Formularfeld angelegt werden, das
den Namen ertl_login
und den Wert 9uetwrg7K83z7
hat.
Die Weiterleitungsseite für den Tokenlogin wird über den Loginlink gesteuert:
https://example.com/_login/<token>/<id der Seite zu der weitergeleitet werden soll>
Die <id der Seite zu der weitergeleitet werden soll>
wird mittels eines verstecken
Formular Felds festgelegt, das redirecttopagewithid
heißen muss. Der zugehörige Wert
ist die ID der gewünschten Seite. Ist dieses Feld nicht vorhanden, so wird zur Startseite
weitergeleitet. Tip: Soll auf die Seite weitergeleitet werden, auf der sich das Formular befindet, so
kann der Insert Tag {{page::id}}
verwendet werden.
Notifications
Damit User einen Loginlink zugeschickt bekommen, muss im Notification Center eine Notification vom Typ
"ER+TL Registrierung" angelegt werden. In dieser kann über Simple Tokens auf die Formulardaten zugegriffen
werden (insbes. ##form_email##
für den Empfänger der E-Mail).
Der Loginlink steht über das Simple Token ##loginlink##
zur Verfügung.
Ein Beispiel für den Text der E-Mail:
Hallo ##form_firstname## ##form_lastname##
Dein Loginlink für ##domain## lautet
##loginlink##
Features
- Beim Löschen eines Members werden die zugehörigen
tl_member_login_token
-Records gelöscht - Wird ein Member im Backend deaktiviert, so ist der Login unterbunden (bei Verwendung des
zugehörigen Loginlinks erhalten User einen Fehler
403
)
TODOs
Cron Jobs
tl_member
undtl_member_token
"purgen" via noch zu erstellendercontao-console
Commands