User:Reset_Password_Form Tag

This tag is used to to set a new password after a user has received the reset link from the "forgot my password" form.

Overview

After a user has put their email address into the user:forgot_password_form, they’ll arrive here to reset their password. This is the form used to create a new password. That’s really all there is to it.

Example

{{ user:reset_password_form }}

    {{ if success }}

        <p class="alert alert-success">Password has been reset.</p>

    {{ elseif url_invalid }}

        <p class="alert alert-danger">This reset URL is invalid.</p>

    {{ else }}

        {{ if errors }}
            <div class="alert alert-danger">
                {{ errors }}
                    {{ value }}<br>
                {{ /errors }}
            </div>
        {{ /if }}

        <label>E-Mail</label>
        <input type="email" name="email" />

        <label>Password</label>
        <input type="password" name="password" />

        <label>Password Confirmation</label>
        <input type="password" name="password_confirmation" />

        <button>Submit</button>

    {{ /if }}

{{ /user:reset_password_form }}

Arriving at this URL

Visiting the URL containing this form directly will set a url_invalid invalid variable you can use to check if they’ve actually come from the form in their previous request.

This URL needs to have the appropriate user and code query parameters (e.g. /some/url?user=username&code=“abc123”`

These can be created automatically using a user:forgot_password_form.

Parameters

redirect string

The URL the user will be taken after the form is successfully submitted. Leaving this blank will keep the user on the same page.

Variables

Variable Type Description

success

boolean

This will be true if the form has been submitted successfully. If you don't use the redirect parameter, you can keep your users on the same page and show a success message.

url_invalid

boolean

This will be true if the code query parameter is missing/incorrect, or if the user query parameter is invalid.

errors

array

An array of validation errors.

Betterify this page on Github!