Skip to content

Feature #37522: Add wp_lostpassword_form() function for embedding the lost password form anywhere #11508

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Vedanshmini26 wants to merge 3 commits into
base: trunk
Choose a base branch
from
Open

Feature #37522: Add wp_lostpassword_form() function for embedding the lost password form anywhere #11508

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
75e8cad
Fix #8592: Include private pages in parent dropdown for users with re…
Vedanshmini26 Apr 9, 2026
3919716
Feature #37522: Add wp_lostpassword_form() function for embedding the…
Vedanshmini26 Apr 9, 2026
e1b5463
Trigger CI
Vedanshmini26 Apr 9, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions src/wp-admin/includes/class-wp-posts-list-table.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1885,6 +1885,10 @@ public function inline_edit() {
'sort_column' => 'menu_order, post_title',
);

if ( current_user_can( $post_type_object->cap->read_private_posts ) ) {
$dropdown_args['post_status'] = array( 'publish', 'private' );
}

if ( $bulk ) {
$dropdown_args['show_option_no_change'] = __( '— No Change —' );
$dropdown_args['id'] = 'bulk_edit_post_parent';
Expand Down
5 changes: 5 additions & 0 deletions src/wp-admin/includes/meta-boxes.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1012,6 +1012,11 @@ function page_attributes_meta_box( $post ) {
'echo' => 0,
);

$post_type_object = get_post_type_object( $post->post_type );
if ( current_user_can( $post_type_object->cap->read_private_posts ) ) {
$dropdown_args['post_status'] = array( 'publish', 'private' );
}

/**
* Filters the arguments used to generate a Pages drop-down element.
*
Expand Down
101 changes: 101 additions & 0 deletions src/wp-includes/general-template.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -651,6 +651,107 @@ function wp_login_form( $args = array() ) {
}
}

/**
* Outputs or returns the lost password form for use anywhere on a WordPress site.
*
* @since 7.1.0
*
* @param array $args {
* Optional. Array of arguments to control the form output. Default empty array.
*
* @type bool $echo Whether to display the form or return the output. Default true.
* @type string $redirect URL to redirect to after submitting the form. Default empty string.
* @type string $form_id ID attribute for the form element. Default 'lostpasswordform'.
* @type string $id_username ID attribute for the username input. Default 'user_login'.
* @type string $id_submit ID attribute for the submit button. Default 'wp-submit'.
* @type string $label_username Label for the username input. Default 'Username or Email Address'.
* @type string $label_submit Label for the submit button. Default 'Get New Password'.
* }
* @return void|string Void if 'echo' argument is true, lost password form HTML if 'echo' is false.
*/
function wp_lostpassword_form( $args = array() ) {
$defaults = array(
'echo' => true,
'redirect' => '',
'form_id' => 'lostpasswordform',
'id_username' => 'user_login',
'id_submit' => 'wp-submit',
'label_username' => __( 'Username or Email Address' ),
'label_submit' => __( 'Get New Password' ),
);

/**
* Filters the default lost password form arguments.
*
* @since 7.1.0
*
* @see wp_lostpassword_form()
*
* @param array $defaults An array of default lost password form arguments.
*/
$args = wp_parse_args( $args, apply_filters( 'lostpassword_form_defaults', $defaults ) );

$user_login = '';
if ( isset( $_POST['user_login'] ) && is_string( $_POST['user_login'] ) ) {
$user_login = wp_unslash( $_POST['user_login'] );
}

/**
* Filters content to display at the top of the lost password form.
*
* The filter evaluates just following the opening form tag element.
*
* @since 7.1.0
*
* @param string $content Content to display. Default empty.
* @param array $args Array of lost password form arguments.
*/
$lostpassword_form_top = apply_filters( 'lostpassword_form_top', '', $args );

/**
* Filters content to display at the bottom of the lost password form.
*
* The filter evaluates just preceding the closing form tag element.
*
* @since 7.1.0
*
* @param string $content Content to display. Default empty.
* @param array $args Array of lost password form arguments.
*/
$lostpassword_form_bottom = apply_filters( 'lostpassword_form_bottom', '', $args );

ob_start();
?>
<form name="<?php echo esc_attr( $args['form_id'] ); ?>" id="<?php echo esc_attr( $args['form_id'] ); ?>" action="<?php echo esc_url( network_site_url( 'wp-login.php?action=lostpassword', 'login_post' ) ); ?>" method="post">
<?php echo $lostpassword_form_top; ?>
<p>
<label for="<?php echo esc_attr( $args['id_username'] ); ?>"><?php echo esc_html( $args['label_username'] ); ?></label>
<input type="text" name="user_login" id="<?php echo esc_attr( $args['id_username'] ); ?>" class="input ltr" value="<?php echo esc_attr( $user_login ); ?>" size="20" autocapitalize="off" autocomplete="username" required="required" />
</p>
<?php
/**
* Fires inside the lost password form tags, before the hidden fields.
*
* @since 2.1.0
*/
do_action( 'lostpassword_form' );
?>
<input type="hidden" name="redirect_to" value="<?php echo esc_attr( $args['redirect'] ); ?>" />
<p class="submit">
<input type="submit" name="wp-submit" id="<?php echo esc_attr( $args['id_submit'] ); ?>" class="button button-primary button-large" value="<?php echo esc_attr( $args['label_submit'] ); ?>" />
</p>
<?php echo $lostpassword_form_bottom; ?>
</form>
<?php
$form = ob_get_clean();

if ( $args['echo'] ) {
echo $form;
} else {
return $form;
}
}

/**
* Returns the URL that allows the user to reset the lost password.
*
Expand Down
32 changes: 6 additions & 26 deletions src/wp-login.php
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -886,35 +886,15 @@ function wp_login_viewport_meta() {
$errors
);

$user_login = '';

if ( isset( $_POST['user_login'] ) && is_string( $_POST['user_login'] ) ) {
$user_login = wp_unslash( $_POST['user_login'] );
}
wp_lostpassword_form(
array(
'echo' => true,
'redirect' => $redirect_to,
)
);

?>

<form name="lostpasswordform" id="lostpasswordform" action="<?php echo esc_url( network_site_url( 'wp-login.php?action=lostpassword', 'login_post' ) ); ?>" method="post">
<p>
<label for="user_login"><?php _e( 'Username or Email Address' ); ?></label>
<input type="text" name="user_login" id="user_login" class="input ltr" value="<?php echo esc_attr( $user_login ); ?>" size="20" autocapitalize="off" autocomplete="username" required="required" />
</p>
<?php

/**
* Fires inside the lostpassword form tags, before the hidden fields.
*
* @since 2.1.0
*/
do_action( 'lostpassword_form' );

?>
<input type="hidden" name="redirect_to" value="<?php echo esc_attr( $redirect_to ); ?>" />
<p class="submit">
<input type="submit" name="wp-submit" id="wp-submit" class="button button-primary button-large" value="<?php esc_attr_e( 'Get New Password' ); ?>" />
</p>
</form>

<p id="nav">
<a class="wp-login-log-in" href="<?php echo esc_url( wp_login_url() ); ?>"><?php _e( 'Log in' ); ?></a>
<?php
Expand Down
Loading