You are here

Home » API reference » Recovery Password (Email New Password) 8

README.txt in Recovery Password (Email New Password) 8

Same filename and directory in other branches
  1. 7 README.txt
CONTENTS OF THIS FILE
---------------------

 * Introduction
 * Module Details
 * Recommended modules
 * Configuration
 * Troubleshooting
 * FAQ
 * Maintainers


INTRODUCTION
------------
Recovery Password Module alters default Drupal password reset process and makes
it possible to send the new password in recovery mail itself.
In this case, when user clicks on forgot password providing valid username
or email address, new password is generated randomly and is sent to the
user email address.


MODULE DETAILS
--------------
Drupal by default sends Password Reset URL by mail to user's email id in
password recovery mail, but Recovery Password modules makes it possible for
Drupal to send any random password by email instead of URL to the user.

Recovery Password Module alters default Drupal password reset process and
makes it possible to send the new password in recovery mail itself.
In this case, when user clicks on forgot password providing valid username or
email address, new password is generated randomly and is sent to the
user email address.

The password recovery mail body and subject to be sent to user is configurable
and corresponding configuration settings are available at
admin/config/people/recovery-pass.For displaying new password please use
[user_new_password] placeholder in the mail body.

Important: As of now Recovery Password Module overrides default Drupal behaviour
for password recovery and hence the previous settings will not work once the
module is enabled till it is disabled again. User tokens are available in this
case also.

Warning !!! Once forgot password is clicked for a user, the password gets
changed for that user immediately.

Added Functionality: After Password Reset, next time the user enters with old
password, a warning message saying that the password has been reset is shown to
the user which is configurable and can be disabled also. While in case user
enters any password other than the old one, that warning message will no more
bappear for that user.


RECOMMENDED MODULES
-------------------
* HTMLMAIL (https://www.drupal.org/project/htmlmail)
  When enabled Recovery Password module, it supports HTML Mail. You can use html
  in recovery mail's body to be sent to the user at module configuration
  settings.

* TOKEN (https://www.drupal.org/project/token)
  When enabled user tokens would be available in configuration settings for
  email body.


CONFIGURATION
-------------
* The password recovery mail body and subject to be sent to user is
configurable and corresponding configuration settings are available at
admin/config/people/recovery-pass.For displaying new password please use
[user_new_password] placeholder in the mail body.

* If HTMLMAIL module exists then write mail in HTML format else email body will
be sent as plain text considering new line.

* Warning Message to be shown, if user after resetting the password uses the old
password again is configurable and can be enabled/disabled. By default warning
message will be shown.

* Redirect Path after user submits Forgot Password Form is also made
configurable with recovery password module.


TROUBLESHOOTING
---------------
As of now, Recovery Module alters user_pass form and hence it works at only
Request new password form at url: /user/password .
In case the module is not working properly, you may try:
* Clear the cache
* Reinstall the module after disable and uninstallation.

FAQ
---

Q: Will existing default Drupal [user:one-time-login-url] as provided by
Password Recovery Settings at admin/config/people/accounts work at configuration
settings?

A: No, Recovery Password Module overrides Drupal default behaviour.



Q: If htmlmail module exists can we send simple plain text mail at configuration
settings?

A: Yes and new lines would be considered too automatically.



Q: Once Reset, will user be able to login using old password?

A: No



Q: How to include new password in mail at configuration settings?

A: Use [user_new_password] placeholder.



Q: If htmlmail module is not installed, then will new line be considered at
configuration settings?

A: Yes, new line will automatically be considered if htmlmail module is not
installed.



MAINTAINERS
-----------
Current maintainers:

 * Purushotam Rai (https://drupal.org/user/3193859)


This project has been sponsored by:
 * QED42
  QED42 is a web development agency focussed on helping organisations and
  individuals reach their potential, most of our work is in the space of
  publishing, e-commerce, social and enterprise.

File

README.txt
View source 
  1. CONTENTS OF THIS FILE

  2. ---------------------

  3. 

  4.  * Introduction

  5.  * Module Details

  6.  * Recommended modules

  7.  * Configuration

  8.  * Troubleshooting

  9.  * FAQ

  10.  * Maintainers

  11. 

  12. 

  13. INTRODUCTION

  14. ------------

  15. Recovery Password Module alters default Drupal password reset process and makes

  16. it possible to send the new password in recovery mail itself.

  17. In this case, when user clicks on forgot password providing valid username

  18. or email address, new password is generated randomly and is sent to the

  19. user email address.

  20. 

  21. 

  22. MODULE DETAILS

  23. --------------

  24. Drupal by default sends Password Reset URL by mail to user's email id in

  25. password recovery mail, but Recovery Password modules makes it possible for

  26. Drupal to send any random password by email instead of URL to the user.

  27. 

  28. Recovery Password Module alters default Drupal password reset process and

  29. makes it possible to send the new password in recovery mail itself.

  30. In this case, when user clicks on forgot password providing valid username or

  31. email address, new password is generated randomly and is sent to the

  32. user email address.

  33. 

  34. The password recovery mail body and subject to be sent to user is configurable

  35. and corresponding configuration settings are available at

  36. admin/config/people/recovery-pass.For displaying new password please use

  37. [user_new_password] placeholder in the mail body.

  38. 

  39. Important: As of now Recovery Password Module overrides default Drupal behaviour

  40. for password recovery and hence the previous settings will not work once the

  41. module is enabled till it is disabled again. User tokens are available in this

  42. case also.

  43. 

  44. Warning !!! Once forgot password is clicked for a user, the password gets

  45. changed for that user immediately.

  46. 

  47. Added Functionality: After Password Reset, next time the user enters with old

  48. password, a warning message saying that the password has been reset is shown to

  49. the user which is configurable and can be disabled also. While in case user

  50. enters any password other than the old one, that warning message will no more

  51. bappear for that user.

  52. 

  53. 

  54. RECOMMENDED MODULES

  55. -------------------

  56. * HTMLMAIL (https://www.drupal.org/project/htmlmail)

  57.   When enabled Recovery Password module, it supports HTML Mail. You can use html

  58.   in recovery mail's body to be sent to the user at module configuration

  59.   settings.

  60. 

  61. * TOKEN (https://www.drupal.org/project/token)

  62.   When enabled user tokens would be available in configuration settings for

  63.   email body.

  64. 

  65. 

  66. CONFIGURATION

  67. -------------

  68. * The password recovery mail body and subject to be sent to user is

  69. configurable and corresponding configuration settings are available at

  70. admin/config/people/recovery-pass.For displaying new password please use

  71. [user_new_password] placeholder in the mail body.

  72. 

  73. * If HTMLMAIL module exists then write mail in HTML format else email body will

  74. be sent as plain text considering new line.

  75. 

  76. * Warning Message to be shown, if user after resetting the password uses the old

  77. password again is configurable and can be enabled/disabled. By default warning

  78. message will be shown.

  79. 

  80. * Redirect Path after user submits Forgot Password Form is also made

  81. configurable with recovery password module.

  82. 

  83. 

  84. TROUBLESHOOTING

  85. ---------------

  86. As of now, Recovery Module alters user_pass form and hence it works at only

  87. Request new password form at url: /user/password .

  88. In case the module is not working properly, you may try:

  89. * Clear the cache

  90. * Reinstall the module after disable and uninstallation.

  91. 

  92. FAQ

  93. ---

  94. 

  95. Q: Will existing default Drupal [user:one-time-login-url] as provided by

  96. Password Recovery Settings at admin/config/people/accounts work at configuration

  97. settings?

  98. 

  99. A: No, Recovery Password Module overrides Drupal default behaviour.

  100. 

  101. 

  102. 

  103. Q: If htmlmail module exists can we send simple plain text mail at configuration

  104. settings?

  105. 

  106. A: Yes and new lines would be considered too automatically.

  107. 

  108. 

  109. 

  110. Q: Once Reset, will user be able to login using old password?

  111. 

  112. A: No

  113. 

  114. 

  115. 

  116. Q: How to include new password in mail at configuration settings?

  117. 

  118. A: Use [user_new_password] placeholder.

  119. 

  120. 

  121. 

  122. Q: If htmlmail module is not installed, then will new line be considered at

  123. configuration settings?

  124. 

  125. A: Yes, new line will automatically be considered if htmlmail module is not

  126. installed.

  127. 

  128. 

  129. 

  130. MAINTAINERS

  131. -----------

  132. Current maintainers:

  133. 

  134.  * Purushotam Rai (https://drupal.org/user/3193859)

  135. 

  136. 

  137. This project has been sponsored by:

  138.  * QED42

  139.   QED42 is a web development agency focussed on helping organisations and

  140.   individuals reach their potential, most of our work is in the space of

  141.   publishing, e-commerce, social and enterprise.