Last updated December 17, 2012. Created by steveparks on September 23, 2011.
Edited by jasom, dooug, Ogredude, mikewink. Log in to edit this page.
LoginToboggan is one of the top 50 modules for Drupal by usage. It offers many frequently requested modifications to the standard Drupal registration and login functionality.
To view the list of features the module provides, visit the project page at http://drupal.org/project/logintoboggan
Installation
Place the entire logintoboggan module folder into either:
(a) your sites/all/modules directory; or
(b) your sites/[my site]/modules directory.
Enable the module at:
Drupal 6: admin > build > modules
Drupal 7: admin > modules
Configuration
To configure LoginToboggan, go to:
Drupal 6: admin > user > logintoboggan
Drupal 7: admin > config > system > logintoboggan
You can then step through the configuration as follows:
Configure Login
You can enable the 'login with email address' feature. This does not prevent users from logging in as usual with their username, it simply adds the extra functionality that the user can choose to log in using their email address instead. For many users this is easier to remember and can provide a much better user experience.
Configure Registration
LoginToboggan provides many improvements to the user registration process.
Use two email fields on registration form
Set this to enabled to ask the user to enter their email address twice when registering with the site. This can help prevent problems caused by users typing their email address wrongly. Logintoboggan will verify that both fields are the same, and prompt the user to correct it. Set this to disabled for the default Drupal behaviour.
Set password
Ticking this will allow users to enter their desired password when they set up their user account. Leaving it unticked will use the default Drupal behaviour, which is to email the user a link they must click, which returns them to the site and asks them to set their password. If you enable this feature you're advised to edit the text of the 'Welcome, no approval required' email at:
Drupal 6: admin > user > settings
Drupal 7: admin > config > people > accounts
The confirmation link in this email will now have the effect of confirming the user as an 'authenticated user' on the site. Previously to this they will just have the role defined by the next step on this configuration form.
Note that this setting mirrors the 'require email verification when a vistor creates an account' setting at:
Drupal 6: admin > user > settings
Drupal 7: admin > config > people > accounts
So ticking this setting, will untick that setting, and vice versa.
Non-authenticated role
If you enable the 'Set Password' feature, it's highly recommended that you setup a role expressly for users who have registered an account on your site, but not yet verified their email address by clicking on the link in the welcome email.
To do this:
- Go to admin > user > roles and setup a new role, such as 'Unverified user' or 'New user'.
- Go to the LoginToboggan settings and enable "Set password" and set your new role as the unverified role, and save the settings. LoginToboggan prevents the pre-authorized role from automatically inheriting the authorized role permissions. You may wish to create a pre-authorized role with the exact same permissions as the anonymous user if you wish the newly created user to only have anonymous permissions.
- Set up suitable permissions for this role at:
Drupal 6: admin > user > permissions
Drupal 7: admin > people >permissionsFor example, you may not want unverified users to be able to create new content.
- Return to this Logintoboggan configuration screen and select this new role from the dropdown box labelled 'Non-authenticated role'.
More details coming soon.
Configure Other Settings
Authenticate link in e-mail template "Welcome (no approval required)"
For authenticate link, not password reset link, you need to change "Welcome (no approval required)" e-mail template. You can find it at admin/config/people/accounts e-mail tabs. Change token from [user:one-time-login-url] to [user:validate-url]. Also, don't forget change e-mail body text to have it more sense now.
More coming soon.
Configuring Blocks
Configure each block at:
Drupal 6: admin >build > block
Drupal 7: admin > structure > block
as follows...
Configure the 'User login' block for LoginToboggan functionality
Change title if required; using can make for a very neat login system,
when combined with the javascript functionality: clicking upon "Login/register"
reveals the login form in sliding fashion. To select this functionality, select
'Collapsible form' under "Block type". Selecting 'Link' under "Block type"
sends user to a login form, returning them to original page after successful
login.
Configure 'LoginToboggan logged in block'
Tip: by leaving the title blank, the 'LoginToboggan logged in block' is slim
and neat.