Difference between revisions of "NATS4 Password Retrieval"
| (9 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
{{NATS4 Manual | {{NATS4 Manual | ||
| show_skins_and_templates_admin_section = true | | show_skins_and_templates_admin_section = true | ||
| + | | show_members_admin_section = true | ||
}} | }} | ||
| − | [[NATS]] has the ability to send lost passwords to your members. The password retrieval script you will be using will ask for their email address, as well as a NATS [[ID Numbers|member I.D. number]]. It will then retrieve the user's email from the NATS database and email them their lost password. | + | [[NATS]] has the ability to send lost or forgotten passwords to your members. The password retrieval script you will be using will ask for their email address, as well as a NATS [[ID Numbers|member I.D. number]]. It will then retrieve the user's email from the NATS database and email them their lost password. |
| − | If | + | If a member forgot their password, you can either post directly to the forgotten password script, or enable the password retrieval form template. |
| + | |||
| + | [[NATS]] also has the ability to allow a member to update their password to a new password, provided the member has their current password, config "MEMBER_PASSWORD_UPDATE" is enabled & the parameter update=1 is passed into password.php | ||
== Automated Password Retrieval == | == Automated Password Retrieval == | ||
| − | You can use either of the following methods to retrieve a member's | + | You can use either of the following methods to retrieve a member's forgotten password with your own script. |
=== Retrieving Passwords by Username and Email === | === Retrieving Passwords by Username and Email === | ||
| − | If you would like to retrieve the member's password by using their username and email address, you can sent | + | If you would like to retrieve the member's password by using their username and email address, you can sent an HTTP GET to the following URL: |
| − | <pre>http://linkdomain/signup/password.php?siteid=~siteid~&username=~username~&email=~email_address~</pre> | + | <pre>http://linkdomain/signup/password.php?siteid=~siteid~&username=~username~&email=~email_address~&submit=1</pre> |
Make the following replacements in the above URL to set the variables: | Make the following replacements in the above URL to set the variables: | ||
| Line 27: | Line 30: | ||
=== Retrieving Passwords by Member I.D. === | === Retrieving Passwords by Member I.D. === | ||
| − | If you want to retrieve the member's password by using their member I.D., as opposed to their username and password, you can send a HTTP | + | If you want to retrieve the member's password by using their member I.D., as opposed to their username and password, you can send a HTTP GET to the following URL: |
| − | <pre>http://linkdomain/signup/password.php?siteid=~siteid~&memberid=~memberid~</pre> | + | <pre>http://linkdomain/signup/password.php?siteid=~siteid~&memberid=~memberid~&submit=1</pre> |
Make the following replacements in the above URL to set the variables: | Make the following replacements in the above URL to set the variables: | ||
| Line 36: | Line 39: | ||
* Replace ''~siteid~'' with your site's I.D. number | * Replace ''~siteid~'' with your site's I.D. number | ||
* Replace ''~memberid~'' with the member's I.D. number | * Replace ''~memberid~'' with the member's I.D. number | ||
| + | |||
| + | === Retrieving Username and Password by Email === | ||
| + | If you want to retrieve the member's username and password by using their email, you will need to turn off the configuration "RETRIEVAL_REQUIRE_USERNAME". | ||
| + | This configuration can be found under the following section: | ||
| + | * "Misc" section of the Configuration admin. <!-- (NATS 5.0.3.X & under) | ||
| + | * "Surfer" section of the Configuration admin. (NATS 5.0.3.X & above) --> <!-- NATS-1069 --> | ||
| + | <br>Once this is turned off, you can send an HTTP GET to the following URL: | ||
| + | |||
| + | <pre>http://linkdomain/signup/password.php?siteid=~siteid~&email=~email_address~&submit=1</pre> | ||
| + | |||
| + | Make the following replacements in the above URL to set the variables: | ||
| + | |||
| + | * Replace ''linkdomain'' with your [[Link Domain|linkdomain]] | ||
| + | * Replace ''~siteid~'' with your site's I.D. number | ||
| + | * Replace ''~email_address~'' with the member's email address | ||
== Retrieving Passwords through the Built-in Template == | == Retrieving Passwords through the Built-in Template == | ||
| Line 51: | Line 69: | ||
*''mail_member_password'' -- This is the body of the reminder email. | *''mail_member_password'' -- This is the body of the reminder email. | ||
[[File:Mail member password.PNG|450px|Mail Member Password Template]] | [[File:Mail member password.PNG|450px|Mail Member Password Template]] | ||
| + | |||
| + | == Updating Member Password == | ||
| + | If you would like to allow the member to update their password to a new password, you can automate by sending a HTTP GET to the following URL: | ||
| + | <pre>http://linkdomain/signup/password.php?&update=1&siteid=~siteid~&username=~username~&email=~email_address~&old_password=~old_password~&new_password=~new_password~&submit=1</pre> | ||
| + | |||
| + | To update their password to a new password the following needs to be enabled: | ||
| + | * The config "MEMBER_PASSWORD_UPDATE" needs to be enabled | ||
| + | * The parameter update=1 is passed into /signup/password.php script | ||
| + | * By default, member must have their current password, username, email in order to update password | ||
== See Also == | == See Also == | ||
Latest revision as of 17:46, 26 October 2021
NATS has the ability to send lost or forgotten passwords to your members. The password retrieval script you will be using will ask for their email address, as well as a NATS member I.D. number. It will then retrieve the user's email from the NATS database and email them their lost password.
If a member forgot their password, you can either post directly to the forgotten password script, or enable the password retrieval form template.
NATS also has the ability to allow a member to update their password to a new password, provided the member has their current password, config "MEMBER_PASSWORD_UPDATE" is enabled & the parameter update=1 is passed into password.php
Automated Password Retrieval
You can use either of the following methods to retrieve a member's forgotten password with your own script.
Retrieving Passwords by Username and Email
If you would like to retrieve the member's password by using their username and email address, you can sent an HTTP GET to the following URL:
http://linkdomain/signup/password.php?siteid=~siteid~&username=~username~&email=~email_address~&submit=1
Make the following replacements in the above URL to set the variables:
- Replace linkdomain with your linkdomain
- Replace ~siteid~ with your site's I.D. number.
- Replace ~username~ with the member's username
- Replace ~email_address~ with the member's email address
Optional: Instead of siteid=~siteid~, you can use siteids=~siteids~:
- If you use this, replace ~siteids~ with a comma-seperated list of siteids you wish to search. NATS will use the first siteid found on this list in order to determine which member it sends the reminder email to.
Retrieving Passwords by Member I.D.
If you want to retrieve the member's password by using their member I.D., as opposed to their username and password, you can send a HTTP GET to the following URL:
http://linkdomain/signup/password.php?siteid=~siteid~&memberid=~memberid~&submit=1
Make the following replacements in the above URL to set the variables:
- Replace linkdomain with your linkdomain
- Replace ~siteid~ with your site's I.D. number
- Replace ~memberid~ with the member's I.D. number
Retrieving Username and Password by Email
If you want to retrieve the member's username and password by using their email, you will need to turn off the configuration "RETRIEVAL_REQUIRE_USERNAME". This configuration can be found under the following section:
- "Misc" section of the Configuration admin.
Once this is turned off, you can send an HTTP GET to the following URL:
http://linkdomain/signup/password.php?siteid=~siteid~&email=~email_address~&submit=1
Make the following replacements in the above URL to set the variables:
- Replace linkdomain with your linkdomain
- Replace ~siteid~ with your site's I.D. number
- Replace ~email_address~ with the member's email address
Retrieving Passwords through the Built-in Template
If you do not want to use automated password retrieval scripts, you can instead have surfers submit their information to the password retrieval template in NATS. NATS will then check the information in their submission, and send the member a lost password email if the credentials are correct. To direct your members to this form, send them the following URL:
http://linkdomain/signup/password.php?siteid=~siteid~
Simply replace linkdomain with your linkdomain and ~siteid~ with the actual site id in NATS.
Three templates found in your Sites Admin are associated with this password retrieval feature. To access these templates, select the site you wish to affect and click the "Edit Site Templates" icon.
- member_password -- Members enter their username and email on this template, and NATS redisplays this page if there was an error on submission.
- member_password_sent -- Members see this template after the reminder mail is sent.
- mail_member_password -- This is the body of the reminder email.
Updating Member Password
If you would like to allow the member to update their password to a new password, you can automate by sending a HTTP GET to the following URL:
http://linkdomain/signup/password.php?&update=1&siteid=~siteid~&username=~username~&email=~email_address~&old_password=~old_password~&new_password=~new_password~&submit=1
To update their password to a new password the following needs to be enabled:
- The config "MEMBER_PASSWORD_UPDATE" needs to be enabled
- The parameter update=1 is passed into /signup/password.php script
- By default, member must have their current password, username, email in order to update password
