ForgotPassword
Last updated Mar 6th, 2021 | Page history | Improve this page | Report an issue
Support the team building MODX with a monthly donation.
The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.
Backers
Budget
$311 per month—let's make that $500!
Learn moreWhat is ForgotPassword?¶
ForgotPassword is a simple Snippet that handles the form when a User has forgotten their password and needs to retrieve it.
Usage¶
To use the password retrieval functionality, first create the Resource the user will log into when they click on the confirmation email, and put the ResetPassword snippet in. Tell it what Resource the Login snippet is in - or where you'd like it to provide a link back to:
[[!ResetPassword? &loginResourceId=`72`]]
Then create another resource with the ForgotPassword snippet, and tell it what Resource the Reset snippet is in:
[[!ForgotPassword? &resetResourceId=`123`]]
ForgotPassword Properties¶
ForgotPassword comes with some default properties you can override. They are:
Name | Description | Default |
---|---|---|
tpl | The reset password message tpl. May be the type specified by the tplType property. | lgnForgotPassTpl |
tplType | The type of tpl being provided by tpl | modChunk |
errTpl | The error message tpl. May be the type specified by the errTplType property. | lgnErrTpl |
errTplType | The type of tpls being provided by errTpl | modChunk |
emailTpl | The confirmation email message tpl. | lgnForgotPassEmail |
emailTplAlt | alternate confirmation email message tpl - for multi-part email with text alternative. | |
emailSubject | The subject of the email message | Password Retrieval Email |
emailTplType | The type of tpl being provided by emailTpl | modChunk |
sentTpl | The message tpl to show when an email was successfully sent. | lgnForgotPassSentTpl |
sentTplType | The type of tpl being provided by sentTpl | modChunk |
loginResourceId | The resource to direct users to on successful confirmation. | 1 |
resetResourceId | The resource that contains the Login.ResetPassword Snippet. | 1 |
tplType Options¶
The tplType property takes a different options. They can be:
- modChunk - The tpl provided must be the name of a chunk.
- file - Must be an absolute path to the tpl file.
- inline - The content of the tpl will be directly in the tpl property itself.
- embedded - The tpl is already in the page; just make the error properties be placeholders.