From 4fb7dc8429665c744a68681c2e447a4e5416e0be Mon Sep 17 00:00:00 2001
From: John Blackbourn <johnbillion@git.wordpress.org>
Date: Thu, 7 Jan 2021 17:26:09 +0000
Subject: [PATCH] Login and Registration: Introduce the
 `lostpassword_user_data` filter which allows for the user data object during
 a password reset request to be filtered.

Props marcelo2605

Fixes #51924

Built from https://develop.svn.wordpress.org/trunk@49945


git-svn-id: http://core.svn.wordpress.org/trunk@49644 1a063a9b-81f0-0310-95a4-ce76da25c4cd
---
 wp-includes/version.php |  2 +-
 wp-login.php            | 13 +++++++++++++
 2 files changed, 14 insertions(+), 1 deletion(-)

diff --git a/wp-includes/version.php b/wp-includes/version.php
index 87369967d2..43f43c2dde 100644
--- a/wp-includes/version.php
+++ b/wp-includes/version.php
@@ -13,7 +13,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '5.7-alpha-49944';
+$wp_version = '5.7-alpha-49945';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.
diff --git a/wp-login.php b/wp-login.php
index f244433609..700901f857 100644
--- a/wp-login.php
+++ b/wp-login.php
@@ -369,6 +369,19 @@ function retrieve_password() {
 		$user_data = get_user_by( 'login', $login );
 	}
 
+	/**
+	 * Filters the user data during a password reset request.
+	 *
+	 * Allows, for example, custom validation using data other than username or email address.
+	 *
+	 * @since 5.7.0
+	 *
+	 * @param WP_User|false $user_data WP_User object if found, false if the user does not exist.
+	 * @param WP_Error      $errors    A WP_Error object containing any errors generated
+	 *                                 by using invalid credentials.
+	 */
+	$user_data = apply_filters( 'lostpassword_user_data', $user_data, $errors );
+
 	/**
 	 * Fires before errors are returned from a password reset request.
 	 *