Felogin, la newloginbox intégrée à TYPO3
1. Introduction
Felogin remplace l'extension newloginbox et offre la possibilité d'offrir une boite de connexion pour protéger l'accès à certaines pages.
L'extension felogin sera livrée par défaut avec la version 4.2 de TYPO3. Vous pouvez désormais l'installer depuis la beta 1. En fait, il s'agit d'une implémentation d'une extension déjà existante que l'on ne devrait plus retrouver sur le TER ; enfin, elle ne devrait plus être mise à jour. Il s'agit de newloginbox. Cette extension newloginbox a donc été rebaptisée en felogin et elle remplace l'élément de contenu login qui on doit l'avouer, n'est pas suffisant lorsque l'on souhaite rajouter une boite de login pour une section sécurisée/privée sur un site.
2. Installation
Voici notre arborescence. Il s'agit d'un site test.
Nous allons créer une page standard appelée "Connexion".
Si vous êtes débutant sous TYPO3, il faut bien comprendre la logique de l'application. Nous avons une page de connexion sur laquelle nous allons disposer une boite de login. Cette boite sera reliée à un dossier système contenant les groupes et utilisateurs enregistrés sur le site. Ensuite, une fois un utilisateur connecté, ce dernier aura accès à une page accessible uniquement aux utilisateurs identifiés ; il s'agit de la page "Ma zone".
En essayant de créer un nouvel élément de contenu, on se rend compte immédiatement que nous disposons toujours de l'ancienne login box.
Il faut donc installer la nouvelle boite de login depuis le gestionnaire d'extensions, menu "install extension".
Comme vous le voyez, il s'agit de "Frontend Login for Website Users", clé d'extension "felogin".
Lors de l'installation, le système va nous demander si nous acceptons d'étendre les tables fe_groups et fe_users. Cliquez sur "make updates".
L'extension est désormais installée !
Dans les éléments de contenu, nous avons toujours le même module de connexion. Cependant, si vous cliquez dessus, vous devriez
voir apparaitre de nouvelles options.
3. Configuration via le flexform
Il y a 3 onglets à configurer pour faire fonctionner felogin correctement.
Onglet Général
Afficher le lien "Mot de passe oublié ? : fait apparaitre un "lien mot de passe oublié" sous la boite de connexion si l'utilisateur a oublié son mot de passe.
Show "Stay logged in" checkbox (if switched on for the installation): option "permalogin" activée, ce qui signifie que l'utilisateur restera connecté si il ferme la fenêtre de son navigateur.
Point d'entrée : à faire pointer vers le dossier système des utilisateurs.
Récursion : pas utile
Template file : si l'on souhaite utiliser un autre template que celui qui sera utilisé par défaut. Pour information, le template utilisé est situé à cette adresse : typo3/sysext/felogin/template.html
Le template comporte plusieurs marqueurs et ces derniers seront remplacés par du texte dynamiquement généré par felogin. Une description de tous les marqueurs est indiquée dans le fichier template. Nous utiliserons dans notre exemple le gabarit par défaut.
Onglet Redirect options
Nous allons définir les options de redirection.
Redirect Mode (you have to choose the options, without defined Mode there is no redirect)
Les options à retenir ici sont "defined by Usergroup Record" et "defined by User Record". Ces deux options signifie que felogin va identifier la page indiquée dans les options du groupe de l'utilisateur qui se connecter ou bien de l'utilisateur lui-même. La première option sera prioritaire dans la colonne selected et ainsi de suite si l'option "Use the first mode found" est cochée.
Ainsi, si je sélectionne defined by Usergroup Record puis defined by User Record (voir capture ci-dessous), TYPO3 ira chercher la page de redirection dans les options du groupe et si cette option n'est pas renseignée, il ira la chercher directement dans le profil de l'utilisateur.
Pour définir la redirection au niveau d'un groupe ou d'un utilisateur, il faut modifier la propriété "Redirect at Login to Page (felogin)"
After login with error redirect to page : page de redirection si une erreur est détectée.
After logout redirect to page : page de redirection de l'utilisateur lors de la déconnexion.
Note : la documentation est à ce jour incomplète. Je vous recommande donc de choisir l'option defined by Usergroup Record et de cocher "Disable redirect". Sans cette option cochée, la page de redirection était incorrecte.
Onglet Messages
Cet onglet contient tous les messages lorsque par exemple la connexion est réussie, lorsque le mot de passe est erroné, etc.
Voici le plugin posé dans le backend de TYPO3 :
Et voici l'apparence du plugin en frontend :
L'utilisateur est connecté :
4. Configuration via typoscript
Il est toujours possible de ne pas passer par un flexform pour configurer felogin. Il suffit alors de mettre dans le setup de votre gabarit TS le code suivant :
plugin.tx_felogin_pi1 {
// Page de stockage des utilisateurs et groupes
storagePid=
// Fichier template utilisé
templateFile =
// Affichage dans la source du div de la class CSS tx-felogin-pi1
// 1 = oui, 0 = non
wrapContentInBaseClass =
// Lien mot de passe oublié
showForgotPasswordLink =
// Permalogin
showPermaLogin =
...
}
Je passe volontairement toutes les options TS car vous pouvez les retrouver dans le fichier ext_typoscript_setup.txt à la racine de felogin.
Je rajoute enfin que vous pouvez modifier les traductions à votre convenance. Le fichier XML est situé ici : typo3/sysext/felogin/pi1/locallang.xml
TEAM17
Les derniers articles à consulter :
TYPO3 et le e-Commerce (1ère partie)
Quelle extension utiliser pour faire du e-Commerce avec TYPO3 ?
Felogin, la newloginbox intégrée (TYPO3 v 4.2)
Felogin remplace l'extension newloginbox et offre la possibilité d'offrir une boite de connexion pour protéger l'accès à certaines pages.
Créer un Google sitemap (plan du site XML)
Comment créer un plan du site XML ou plus communément un Google sitemap pour améliorer l'indexation de son site par Google.