Zur Navigation springen Zum Inhalt springen

Standort:
Das nierentischförmige Emblem der TYPO3 Stammtisch Ruhr-Website

Weiter zu Marginalien

Kurztutorial für die Extension Frontend User Registration (sr_feuser_register)

Vorbereitung

Mit der Erweiterung Frontend User Registration (sr_feuser_register) wollen wir Website-Besuchern die Möglichkeit geben, sich zu passwortgeschützten Bereichen einer Website selbst anzumelden. Nach der erfolgten Anmeldung erhält der Nutzer eine E-Mail mit Bestätigungslink.

 

technische Voraussetzungen

  • FE BE Library (fh_library) – um Flexforms nutzen zu können
  • Static Info Tables (static_info_tables) – die aktuelle Version setzt diese Extension nicht mehr voraus
  • MD5 FE Password (kb_md5fepw) – falls MD5-Verschlüsselung erwünscht ist
  • New front end login box (newloginbox)


In diesem Handbuch beschreiben wir nur die Installation der sr_feuser_register.

 

Die Installation

Einfach die Erweiterung sr_feuser_register aus dem TER laden und im Extension-Manager installieren: Extension Manager > Import Extensions > „sr_feuser_register“ in die Eingabeaufforderung schreiben und „Look Up“ klicken, dann die Extension installieren indem man einfach auf das „-“-Zeichen klickt. Wenn alle technischen Voraussetzungen erfüllt sind, sollte die Extension installiert und ein Update der Datenbanktabellen vorgenommen werden.

Screenshot des Extension Managers kurz nach der Installation der Extension „sr_feuser_register“
Screenshot des Extension-Managers kurz nach der Installation der Extension „sr_feuser_register“
 

Einbinden der Extension

  1. Nachdem die Extension erfolgreich installiert ist, können wir die „sr_feuser_register“ in unsere Seite einbinden. Dafür bestehen mehrere Möglichkeiten, wir werden hier erklären, wie die Extension als Template einzubinden ist. Dafür erstellen wir ein Template und werden unser TS-Template „plugin.feuser“ nennen.
  2. Dieses „plugin.feuser“-Template wird in unser Haupttemplate (Master/MainConfig) im Bereich „Include basis template“ eingebunden. Zusätzlich muss unter „Include static (from extensions)“ „FE User Registration CSS-Styled (sr_feuser_register)“ eingebunden werden.
  3. Nun können wir die neue Funktion in unsere Seite als Inhaltselement einbinden.
 

Vorbereitung der Seitenstruktur

  1. Falls noch nicht vorhanden, muss erstmal einen Sys-Ordner erstellt werden, in dem die FE-Userdaten gespeichert werden. Die ID dieses Ordners werden wir später für das TS-Setup eintragen. In der Regel sollte der FE-User-Sys-Ordner bereits durch die Konfiguration der newloginbox vorhanden sein.
  2. Es werden zwei Usergroups gebraucht (die UIDs der Gruppen benötigen wir später).
  3. „bestätigt“ (E-Mail-Link wurde durch FE-User bestätigt) und „nichtbestätigt“ (E-Mail-Link noch nicht bestätigt)
  4. Wir müssen überlegen, wo wir die Seite für Anmeldung, Neu-Anmeldung und Bearbeitung von Frontend-User-Daten erstellen. In unserem Beispiel:
  • Log in (Seite für die Anmeldung)
  • Neu Anmelden (Formular)
  • Editieren
  • Frontendusers (Sys-Ordner)
  • bestätigt
  • nichtbestätigt

 

Anpassung und Konfiguration der Extension

  1. Nachdem wir die Seiten erstellt haben, müssen die Constants für unsere Seite definiert werden, d. h. wir werden die Seiten-IDs für FEUSER und FE-Gruppen „bestätigt“ und „nichtbestätigt“ eintragen.
  2. Wir können in der Constants viele Einstellungen vornehmen. Für mehr Informationen siehe: typo3conf / ext / sr_feuser_register / static / cssstyled / constants.txt und setup.txt. Durch diese zwei Dateien kann man die Einstellungen herausfinden.
  3. Wir brauchen:
  • plugin.tx_srfeuserregister_pi1.pid = FrontendUser Ordner ID (7)
  • plugin.tx_srfeuserregister_pi1.loginPID = Seite für Anmeldung (Log in) (3)
  • plugin.tx_srfeuserregister_pi1.registerPID = Seite für Registration (5)
  • plugin.tx_srfeuserregister_pi1.userGroupAfterConfirmation = Group ID Bestätigt (1)
  • plugin.tx_srfeuserregister_pi1.userGroupUponRegistration = Group ID
  • nichtbestätigt (2)
  • plugin.tx_srfeuserregister_pi1.enableEmailConfirmation = 1 E-Mail-Information aktivieren
 

Das TypoScript

# Frontend User Registration-Parameter setzen
plugin.tx_srfeuserregister_pi1 {
    file.templateFile = fileadmin/template-stammtisch/feuser.html
    enableAdminNotifyConfirmation = 1
    enableEmailOnDelete = 1
    enableAdminNotifyOnApprove = 1
    enableAdminNotifyOnRefuse = 1
    enableAdminNotifyOnRegister = 1
    enablePreviewEdit = 1
    enableEmailConfirmation = 1
    enableEmailOnApprove = 1
    useShortUrls = 0
    enableAutoLoginOnConfirmation = 0
    enablePreviewRegister = 1
    email = myemail@mysite.com
    siteName = TYPO3 Ruhr
    # Constant für sys ordner mit FE-User
    pid = ID FEUSER SYS Ordner
    registerPID = ID Register-Seite
    editPID = ID Bearbeitung-Seite
    loginPID =ID Login Seite
    pidTitleOverride = TYPO3 Stammtisch Ruhr
    userGroupUponRegistration = ID Benutzergruppe noch nicht bestätigt
    userGroupAfterConfirmation = ID Benutzergruppe bestätigt.
    useMd5Password = 0
}

 

Die Anpassung des HTML-Templates wird hier nicht behandelt. Es ist aber auf Grund vorhandener Marker sehr flexibel auf die eigenen Bedürfnisse anpassbar. Die HTML-Template-Vorlage liegt in folgendem Ordner:

typo3conf / ext / sr_feuser_register / pi1 / tx_srfeuserregister_pi1_css_tmpl.html

Ein Eigenes kann über ein TypoScript-Setup eingebunden werden:

plugin.tx_srfeuserregister_pi1 {
    file.templateFile = fileadmin/meineTemplates/template_fuer_feuser.html
}

CSS-Anpassungen

Die CSS-Anpassungen wurden entnommen aus der Extension „tut_sr_feuser_register (tut_sr_feuser_register)“:

.tx-srfeuserregister-pi1 p {
    margin-top: .5em;
    margin-bottom: 0;
    padding: 0 .3em;
    text-indent: 0;
}
.tx-srfeuserregister-pi1 h4 {
    margin-top: 0;
    padding-left: .3em;
}
.tx-srfeuserregister-pi1 legend {
    padding: 0 .5em;
    font-weight: bold;
}
.tx-srfeuserregister-pi1 .tx-srfeuserregister-pi1-notice {
    font-style: italic; margin-bottom: 1em;
}
.tx-srfeuserregister-pi1 .tx-srfeuserregister-pi1-trash {
    margin-bottom: 2em;
}
.tx-srfeuserregister-pi1 a {
    padding-left: 14px;
    background-color: transparent;
    text-decoration:none;
    margin: 0px;
    text-align: left;
    margin-left: 1px;
    padding: 0px;
    color: #FE6F00;
    font-family: 'Trebuchet MS','Lucida Grande', Verdana, Arial, sans-serif;
    font-size: 12px;
    text-decoration: underline;
    font-weight: bold;
}
.tx-srfeuserregister-pi1 label {
    margin: 0;
    padding: 0;
}
.tx-srfeuserregister-pi1 label span {
    color: #ff0000;
}
.tx-srfeuserregister-pi1 .tx-srfeuserregister-pi1-error {
    color: #ff0000;
}
.tx-srfeuserregister-pi1 input {
    margin: 0;
    padding: 0 .5em 0 0;
}
.tx-srfeuserregister-pi1 input[type=password] {
    margin-right: 1em;
}
* html .tx-srfeuserregister-pi1 input.tx-srfeuserregister-pi1-password {
    margin-right: 1em;
}
.tx-srfeuserregister-pi1 input[type=radio], .tx-srfeuserregister-pi1 input[type=checkbox] {
    background-color: transparent;
}
* html .tx-srfeuserregister-pi1 input.tx-srfeuserregister-pi1-radio, * html .tx-srfeuserregister-pi1 input.tx-srfeuserregister-pi1-checkbox {
    background-color: transparent;
}       
.tx-srfeuserregister-pi1 .tx-srfeuserregister-pi1-delete-icon {
    margin-left: 1em;
    background-color: transparent;
}
.tx-srfeuserregister-pi1 .tx-srfeuserregister-pi1-delete-icon:hover {
    cursor: pointer;
}
.tx-srfeuserregister-pi1 a.tx-srfeuserregister-pi1-file-view {
    padding-left: 15px;
    background-image: url("../typo3conf/ext/sr_feuser_register/pi1/internal_link_new_window.gif");
    background-color: transparent;
    background-repeat: no-repeat;
    font-size: .8em;
    margin-left: 1em;
}
.tx-srfeuserregister-pi1 ul {
    margin: 0;
    padding: 0;
    list-style-position: inside;
}
.tx-srfeuserregister-pi1 ul.tx-srfeuserregister-multiple-checkboxes {
    list-style-type: none;
}
.tx-srfeuserregister-pi1 ul.tx-srfeuserregister-multiple-checkboxes li {
    margin: 0 0 .3em 0;
    padding: 0;
}
.tx-srfeuserregister-pi1 ul.tx-srfeuserregister-multiple-checkboxes li label {
    margin: 0;
    padding: 0 0 0 .5em;
}
.tx-srfeuserregister-pi1 ul.tx-srfeuserregister-multiple-checked-values li {
    float: left;
    padding: 0 2em 0 0;
    margin: 0;
}
.tx-srfeuserregister-pi1 dl {
    margin: 0;
    padding: 1em 0 0 0;
}
.tx-srfeuserregister-pi1 dt, .tx-srfeuserregister-pi1 dd {
    margin: 0;
    padding: 0 0 .5em 0;
    float: left;
}
.tx-srfeuserregister-pi1 dt {
    clear: both;
    width: 25%;
    text-align: right;
    padding-right: 1em;
}
.tx-srfeuserregister-pi1 dd {
    text-align: left;
    width: 50%;
}
.tx-srfeuserregister-pi1 .tx-srfeuserregister-pi1-multiple-checkboxes dt {
    width: auto;
    padding-right: 0;
}
.tx-srfeuserregister-pi1 .tx-srfeuserregister-pi1-multiple-checkboxes dd {
    width: auto;
}
* html .tx-srfeuserregister-pi1 dd {
float: none;
}
.tx-srfeuserregister-pi1 dd p {
    margin-top: 0;
    margin-bottom: .5em;
    padding: 0;
}
.tx-srfeuserregister-pi1 dd label {
    padding: 0 1em 0 .5em;
}

 

Die Werte, die wir im Plugin ändern wollen, können wir auch über den Constants-Editor in den Constants-Bereich schreiben. Als alternativen Weg kann man auch unter Web Module > menu Template und dann per Klick auf Template-Ordner auf das TypoScript zugreifen.

 

Für die Sprach-, Länder- und Bundesland-Voreinstellungen der Front End User Registration Form muss Folgendes in das Haupttemplate eintragen werden:

plugin.tx_staticinfotables_pi1 {
    languageCode = DE
    countryCode = DEU
    countryZoneCode = NRW
}

Weiter im Inhalt

 
 
 

„TYPO3“ ist © 2005 – 2011 TYPO3 Association.