INSTALL.txt 2.5 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162
  1. *******************************************************
  2. INSTALL.txt for logintoboggan.module for Drupal
  3. *******************************************************
  4. INSTALLATION:
  5. Place entire loggintoboggan module folder into
  6. (a) your sites/all/modules directory
  7. (b) your sites/[my site]/modules directory.
  8. Enable the module at Administration » Modules
  9. Configure logintoboggan settings at
  10. Administration » Configuration » System » LoginToboggan
  11. The module changes the functionality of the login block AND provides a new
  12. LoginToboggan logged in block'.
  13. Configure each block at Administration » Structure » Blocks as follows...
  14. 1. Configure the 'User login' block for LoginToboggan functionality:
  15. Change title if required; using <none> can make for a very neat login system,
  16. when combined with the javascript functionality: clicking upon "Login/register"
  17. reveals the login form in sliding fashion. To select this functionality, select
  18. 'Collapsible form' under "Block type". Selecting 'Link' under "Block type"
  19. sends user to a login form, returning them to original page after successful
  20. login.
  21. 2. Configure 'LoginToboggan logged in block'
  22. Tip: by leaving the title blank, the 'LoginToboggan logged in block' is slim
  23. and neat.
  24. Done!
  25. CAVEATS:
  26. 1. Use the 'Delete unvalidated users after' feature with extreme caution!
  27. This feature can be handy, but if misconfigured can cause unexpected damage
  28. to your user data -- specifically deleting users! Two things to guard
  29. against:
  30. a. Be very careful when editing the 'Non-authenticated role' setting.
  31. If you set it to anything other than the 'authenticated user' role,
  32. LoginToboggan will happily start deleting any users you have in that
  33. role that were created prior to the purge interval. If you want to
  34. avoid problems, it's best to never change that setting after you've
  35. initially set it up.
  36. b. LoginToboggan has mechanisms in place that prevent a user from being
  37. re-added to the Non-authenticated role after a user has been validated.
  38. Note that these protections are only present in core's interface -- if
  39. you have another module enabled which does any role manipulation
  40. (either via the user interface or programatically), you must find your
  41. own way to ensure that it doesn't add any users back into the
  42. Non-authenticated role.
  43. Also note that the feature is only enabled if the 'Set password' option is
  44. also enabled.