mbr_password_send
Usage
This shortcode returns a HTML form through which the visitor can request a lost password email.
By default when the form is submitted the standard WordPress password reset email will be sent to the email provided. The email is sent by/from WordPress. ActiveMember360 does not have any control over the content of that email.
The only exception to the above is when the parameter automation_id is used with the shortcode. Then no email is automatically sent from WordPress. Instead an ActiveCampaign automation is triggered. You then have the option to send either of the following from the automation:
- An ActiveCampaign email that includes the password stored as plain text within ActiveCampaign using the ActiveCampaign perstag %PASSWORD% within the email content.
- A standard WordPress reset password email by using the webhook detailed within Contact Password Reset.
A benefit of using the parameter automation_id is that you have an audit trail within ActiveCampaign of when the shortcode [mbr_password_send] has been used.
This shortcode only sends emails to:
Contacts who exist in ActiveCampaign with the submitted email address and who also satisfy the requirements to access the site as detailed within WordPress Login. If the contact does not already exist as a WordPress user for the site they will be automatically created by this shortcode with a username and email address the same as that of the ActiveCampaign contact. The other WordPress user settings will be as detailed within Default WordPress User Settings when using ActiveMember360. However if a new WordPress user is created no WordPress new user login details email is sent from WordPress.
Any administrator or local WordPress users.
Parameters
| Parameters | Description |
|---|---|
| automation_id | The ActiveCampaign automation ID to add the logged in user to after successful submission of the password send. The available automations can be found in ActiveMember360, Utilities, Automations. This allows the reminder email to be sent from ActiveCampaign rather than WordPress giving a full audit trial. Default: none. Required: no. |
| label | The field label position. Permissible Values: top, left, placeholder Default: top Required: no. |
| button_text | The text to display on the submit button. Default: Send Password Required: no. |
| button_image | The URL of the image to use for the submit button. Default: none. Required: no. |
| button_style | The CSS style to apply to the submit button. Default: none. Required: no. |
| before_submit_button | The text or HTML placed before the submit button. Default: none. Required: no. |
| after_submit_button | The text or HTML placed after the submit button. Default: none. Required: no. |
| class_submit_button | The CSS class to apply for the submit button. Default: mbr-submit Required: no. |
| id_submit_button | The HTML id attribute to apply for the submit button. Default: mbr-submit Required: no. |
| The label/placeholder for the email input field. Default: Email Required: no. | |
| size_email | The size for the email input field. Default: 20 Required: no. |
| maxlength_email | The maximum input length for the email input field. Default: none. Required: no. |
| before_email | The text or HTML that should be displayed before the email label and input field. Default: none. Required: no. |
| after_email | The text or HTML that should be displayed after the email input field. Default: none. Required: no. |
| style_email | The CSS style to apply to the email input field. Default: none. Required: no. |
| class_email | The CSS class to apply to the email input field. Default: none. Required: no. |
Validity
This shortcode is only processed for visitors as detailed in Usage, Important.
Conditional Branching
This shortcode does NOT support conditional branching with [ELSE_password_send].
Nesting
Shortcode nesting is NOT supported.
Examples
- Example 1
- Example 2
- Example 3
- Example 4
Generates a password send form with the submit button labelled 'Reset my password' using default values for the remaining parameters. Upon submission a standard WordPress reset password email will be sent from WordPress:
[mbr_password_send button_text='Reset my password']
Generates a password send form with the submit button using an image from the URL https://yoursite.com/my_button.png:
[mbr_password_send button_image='https://yoursite.com/my_button.png']
Generates a password send form with the submit button labelled 'Send reminder'. Use a placeholder for the email input field set to 'Your secure email address':
[mbr_password_send button_text='Send reminder' email='Your secure email address' label='placeholder']
Generates a password send form with the submit button labelled 'Send reminder'. Use a placeholder for the email input field set to 'Your secure email address'. After a successful password send submission add the contact to the ActiveCampaign automation with ID 1:
[mbr_password_send button_text='Send reminder' email='Your secure email address' label='placeholder' automation_id='1']
API
There is currently no ActiveMember360 API function equivalent for this shortcode.