wpmem_login_form

Description

Filters the login form defaults for heading, action, button text, redirect_to (if used), and the field elements (such as label text).

Introduced in 3.3.0, it replaces wpmem_inc_login_inputs and wpmem_inc_login_args, both of which should be considered deprecated.

Parameters

$args (array)

/*
@param array $args {
    @type string $heading      The form heading
    @type string $action       The form action (do not change unless you know what you are doing)
    @type string $button_text  The form submit button text
    @type string $redirect_to  The $redirect_to parameter
    @type array  $inputs {
        An array of inputs, there will be one array element for each form input, keyed starting with [0].
    
        @type string $name   The field label
        @type string $type   The field type
        @type string $tag    The field meta tag
        @type string $class  The CSS class
        @type string $div
    }
}
*/

Usage

// An example of changing a single major element.
add_filter( 'wpmem_login_form_defaults', function( $args ) {
    $args['heading'] = "Log in here";
    return $args;
});

// An example of changing a single field input element.
add_filter( 'wpmem_login_form_defaults', function( $args ) {
    $args['inputs'][0]['name'] = "Email";
    return $args;
});

// An example of changing multiple elements.
add_filter( 'wpmem_login_form_defaults', function( $args ) {
    $args['heading'] = "Log in here";
    $args['button_text'] = "Click to log in";
    $args['inputs'][0]['name'] = "Email";
    return $args;
});

Notes

The “inputs” are a subarray in the overall array. It is a numerically keyed array starting at 0. Each input is in the array in display order. For example, in the default login form, the username/email input is [0] and the password is [1], in the password change form, password is [0] and confirm password is [1], etc.

Changelog

Introduced in version 3.3.0

Source

wpmem_login_form_defaults is located in /includes/class-wp-members-forms.php