Project

General

Profile

Paste
Download (4.43 KB) Statistics
| Branch: | Revision:

root / drupal7 / sites / all / modules / recovery_pass / README.txt @ 7dbec6b0

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.