` element.
* Default 'Log In'.
* @param string $message Optional. Message to display in header. Default empty.
* @param WP_Error $wp_error Optional. The error to pass. Default is a WP_Error instance.
*/
function login_header($title = 'Log In', $message = '', $wp_error = null) {
global $error, $interim_login, $action;
// Don't index any of these forms.
add_action('login_head', 'wp_sensitive_page_meta');
add_action('login_head', 'wp_login_viewport_meta');
if (! is_wp_error($wp_error)) {
$wp_error = new WP_Error();
}
// Shake it!
$shake_error_codes = array('empty_password', 'empty_email', 'invalid_email', 'invalidcombo', 'empty_username', 'invalid_username', 'incorrect_password', 'retrieve_password_email_failure');
/**
* Filters the error codes array for shaking the login form.
*
* @since 3.0.0
*
* @param array $shake_error_codes Error codes that shake the login form.
*/
$shake_error_codes = apply_filters('shake_error_codes', $shake_error_codes);
if ($shake_error_codes && $wp_error->has_errors() && in_array($wp_error->get_error_code(), $shake_error_codes, true)) {
add_action('login_footer', 'wp_shake_js', 12);
}
$login_title = get_bloginfo('name', 'display');
/* translators: Login screen title. 1: Login screen name, 2: Network or site name. */
$login_title = sprintf(__('%1$s ‹ %2$s — WordPress'), $title, $login_title);
if (wp_is_recovery_mode()) {
/* translators: %s: Login screen title. */
$login_title = sprintf(__('Recovery Mode — %s'), $login_title);
}
/**
* Filters the title tag content for login page.
*
* @since 4.9.0
*
* @param string $login_title The page title, with extra context added.
* @param string $title The original page title.
*/
$login_title = apply_filters('login_title', $login_title, $title);
?>
>
<?php echo esc_html($login_title); ?>
get_error_code()) {
?>
add('error', $error);
unset($error);
}
if ($wp_error->has_errors()) {
$errors = '';
$messages = '';
foreach ($wp_error->get_error_codes() as $code) {
$severity = $wp_error->get_error_data($code);
foreach ($wp_error->get_error_messages($code) as $error_message) {
if ('message' === $severity) {
$messages .= ' ' . $error_message . "
\n";
} else {
$errors .= ' ' . $error_message . "
\n";
}
}
}
if (! empty($errors)) {
/**
* Filters the error messages displayed above the login form.
*
* @since 2.1.0
*
* @param string $errors Login error message.
*/
echo '
' . wp_kses_post(apply_filters('login_errors', $errors)) . "
\n";
}
if (! empty($messages)) {
/**
* Filters instructional messages displayed above the login form.
*
* @since 2.5.0
*
* @param string $messages Login messages.
*/
echo '
' . wp_kses_post(apply_filters('login_messages', $messages)) . "
\n";
}
}
} // End of login_header().
/**
* Outputs the footer for the login page.
*
* @since 3.1.0
*
* @global bool|string $interim_login Whether interim login modal is being displayed. String 'success'
* upon successful login.
*
* @param string $input_id Which input to auto-focus.
*/
function login_footer($input_id = '') {
global $interim_login;
// Don't allow interim logins to navigate away from the page.
if (! $interim_login) {
?>
', '
');
}
?>
. ?>
add('empty_username', __('Error: Please enter a username or email address.'));
} elseif (strpos($_POST['user_login'], '@')) {
$user_data = get_user_by('email', trim(wp_unslash($_POST['user_login'])));
if (empty($user_data)) {
$errors->add('invalid_email', __('Error: There is no account with that username or email address.'));
}
} else {
$login = trim(wp_unslash($_POST['user_login']));
$user_data = get_user_by('login', $login);
}
/**
* Fires before errors are returned from a password reset request.
*
* @since 2.1.0
* @since 4.4.0 Added the `$errors` parameter.
* @since 5.4.0 Added the `$user_data` parameter.
*
* @param WP_Error $errors A WP_Error object containing any errors generated
* by using invalid credentials.
* @param WP_User|false $user_data WP_User object if found, false if the user does not exist.
*/
do_action('lostpassword_post', $errors, $user_data);
/**
* Filters the errors encountered on a password reset request.
*
* The filtered WP_Error object may, for example, contain errors for an invalid
* username or email address. A WP_Error object should always be returned,
* but may or may not contain errors.
*
* If any errors are present in $errors, this will abort the password reset request.
*
* @since 5.5.0
*
* @param WP_Error $errors A WP_Error object containing any errors generated
* by using invalid credentials.
* @param WP_User|false $user_data WP_User object if found, false if the user does not exist.
*/
$errors = apply_filters('lostpassword_errors', $errors, $user_data);
if ($errors->has_errors()) {
return $errors;
}
if (! $user_data) {
$errors->add('invalidcombo', __('Error: There is no account with that username or email address.'));
return $errors;
}
// Redefining user_login ensures we return the right case in the email.
$user_login = $user_data->user_login;
$user_email = $user_data->user_email;
$key = get_password_reset_key($user_data);
if (is_wp_error($key)) {
return $key;
}
if (is_multisite()) {
$site_name = get_network()->site_name;
} else {
/*
* The blogname option is escaped with esc_html on the way into the database
* in sanitize_option. We want to reverse this for the plain text arena of emails.
*/
$site_name = wp_specialchars_decode(get_option('blogname'), ENT_QUOTES);
}
$message = __('Someone has requested a password reset for the following account:') . "\r\n\r\n";
/* translators: %s: Site name. */
$message .= sprintf(__('Site Name: %s'), $site_name) . "\r\n\r\n";
/* translators: %s: User login. */
$message .= sprintf(__('Username: %s'), $user_login) . "\r\n\r\n";
$message .= __('If this was a mistake, ignore this email and nothing will happen.') . "\r\n\r\n";
$message .= __('To reset your password, visit the following address:') . "\r\n\r\n";
$message .= network_site_url("wp-login.php?action=rp&key=$key&login=" . rawurlencode($user_login), 'login') . "\r\n\r\n";
$requester_ip = $_SERVER['REMOTE_ADDR'];
if ($requester_ip) {
$message .= sprintf(
/* translators: %s: IP address of password reset requester. */
__('This password reset request originated from the IP address %s.'),
$requester_ip
) . "\r\n";
}
/* translators: Password reset notification email subject. %s: Site title. */
$title = sprintf(__('[%s] Password Reset'), $site_name);
/**
* Filters the subject of the password reset email.
*
* @since 2.8.0
* @since 4.4.0 Added the `$user_login` and `$user_data` parameters.
*
* @param string $title Email subject.
* @param string $user_login The username for the user.
* @param WP_User $user_data WP_User object.
*/
$title = apply_filters('retrieve_password_title', $title, $user_login, $user_data);
/**
* Filters the message body of the password reset mail.
*
* If the filtered message is empty, the password reset email will not be sent.
*
* @since 2.8.0
* @since 4.1.0 Added `$user_login` and `$user_data` parameters.
*
* @param string $message Email message.
* @param string $key The activation key.
* @param string $user_login The username for the user.
* @param WP_User $user_data WP_User object.
*/
$message = apply_filters('retrieve_password_message', $message, $key, $user_login, $user_data);
if ($message && ! wp_mail($user_email, wp_specialchars_decode($title), $message)) {
$errors->add(
'retrieve_password_email_failure',
sprintf(
/* translators: %s: Documentation URL. */
__('Error: The email could not be sent. Your site may not be correctly configured to send emails. Get support for resetting your password.'), // phpcs:ignore UpdraftPlus.Translation.MultipleSentence.MultipleSentenceInsideTranslationFunction -- This is a WordPress translation.
esc_url(__('https://wordpress.org/support/article/resetting-your-password/'))
)
);
return $errors;
}
return true;
}
//
// Main.
//
$action = isset($_REQUEST['action']) ? $_REQUEST['action'] : 'login';
$errors = new WP_Error();
if (isset($_GET['key'])) {
$action = 'resetpass';
}
if (isset($_GET['checkemail'])) {
$action = 'checkemail';
}
$default_actions = array(
'confirm_admin_email',
'postpass',
'logout',
'lostpassword',
'retrievepassword',
'resetpass',
'rp',
'register',
'checkemail',
'confirmaction',
'login',
WP_Recovery_Mode_Link_Service::LOGIN_ACTION_ENTERED,
);
// Validate action so as to default to the login screen.
if (! in_array($action, $default_actions, true) && false === has_filter('login_form_' . $action)) {
$action = 'login';
}
nocache_headers();
header('Content-Type: ' . get_bloginfo('html_type') . '; charset=' . get_bloginfo('charset'));
if (defined('RELOCATE') && RELOCATE) { // Move flag is set.
if (isset($_SERVER['PATH_INFO']) && ($_SERVER['PATH_INFO'] !== $_SERVER['PHP_SELF'])) {
$_SERVER['PHP_SELF'] = str_replace($_SERVER['PATH_INFO'], '', $_SERVER['PHP_SELF']);
}
$url = dirname(set_url_scheme('http://' . $_SERVER['HTTP_HOST'] . $_SERVER['PHP_SELF']));
if (get_option('siteurl') !== $url) {
update_option('siteurl', $url);
}
}
setcookie(TEST_COOKIE, 'WP Cookie check', 0, COOKIEPATH, COOKIE_DOMAIN, is_ssl(), true);
if (SITECOOKIEPATH !== COOKIEPATH) {
setcookie(TEST_COOKIE, 'WP Cookie check', 0, SITECOOKIEPATH, COOKIE_DOMAIN, is_ssl(), true);
}
/**
* Fires when the login form is initialized.
*
* @since 3.2.0
*/
do_action('login_init');
/**
* Fires before a specified login form action.
*
* The dynamic portion of the hook name, `$action`, refers to the action
* that brought the visitor to the login form. Actions include 'postpass',
* 'logout', 'lostpassword', etc.
*
* @since 2.8.0
*/
do_action("login_form_{$action}");
$http_post = ('POST' === $_SERVER['REQUEST_METHOD']);
$interim_login = isset($_REQUEST['interim-login']);
/**
* Filters the separator used between login form navigation links.
*
* @since 4.9.0
*
* @param string $login_link_separator The separator used between login form navigation links.
*/
$login_link_separator = apply_filters('login_link_separator', ' | ');
switch ($action) {
case 'confirm_admin_email':
/*
* Note that `is_user_logged_in()` will return false immediately after logging in
* as the current user is not set, see wp-includes/pluggable.php.
* However this action runs on a redirect after logging in.
*/
if (! is_user_logged_in()) {
wp_safe_redirect(wp_login_url());
exit;
}
if (! empty($_REQUEST['redirect_to'])) {
$redirect_to = $_REQUEST['redirect_to'];
} else {
$redirect_to = admin_url();
}
if (current_user_can('manage_options')) {
$admin_email = get_option('admin_email');
} else {
wp_safe_redirect($redirect_to);
exit;
}
/**
* Filters the interval for dismissing the admin email confirmation screen.
*
* If `0` (zero) is returned, the "Remind me later" link will not be displayed.
*
* @since 5.3.1
*
* @param int $interval Interval time (in seconds). Default is 3 days.
*/
$remind_interval = (int) apply_filters('admin_email_remind_interval', 3 * DAY_IN_SECONDS);
if (! empty($_GET['remind_me_later'])) {
if (! wp_verify_nonce($_GET['remind_me_later'], 'remind_me_later_nonce')) {
wp_safe_redirect(wp_login_url());
exit;
}
if ($remind_interval > 0) {
update_option('admin_email_lifespan', time() + $remind_interval);
}
$redirect_to = add_query_arg('admin_email_remind_later', 1, $redirect_to);
wp_safe_redirect($redirect_to);
exit;
}
if (! empty($_POST['correct-admin-email'])) {
if (! check_admin_referer('confirm_admin_email', 'confirm_admin_email_nonce')) {
wp_safe_redirect(wp_login_url());
exit;
}
/**
* Filters the interval for redirecting the user to the admin email confirmation screen.
*
* If `0` (zero) is returned, the user will not be redirected.
*
* @since 5.3.0
*
* @param int $interval Interval time (in seconds). Default is 6 months.
*/
$admin_email_check_interval = (int) apply_filters('admin_email_check_interval', 6 * MONTH_IN_SECONDS);
if ($admin_email_check_interval > 0) {
update_option('admin_email_lifespan', time() + $admin_email_check_interval);
}
wp_safe_redirect($redirect_to);
exit;
}
login_header(__('Confirm your administration email'), '', $errors);
/**
* Fires before the admin email confirm form.
*
* @since 5.3.0
*
* @param WP_Error $errors A `WP_Error` object containing any errors generated by using invalid
* credentials. Note that the error object may not contain any errors.
*/
do_action('admin_email_confirm', $errors);
?>
HashPassword(wp_unslash($_POST['post_password'])), $expire, COOKIEPATH, COOKIE_DOMAIN, is_ssl(), true);
wp_safe_redirect(wp_get_referer());
exit;
case 'logout':
check_admin_referer('log-out');
$user = wp_get_current_user();
wp_logout();
if (! empty($_REQUEST['redirect_to'])) {
$redirect_to = $_REQUEST['redirect_to'];
$requested_redirect_to = $redirect_to;
} else {
$redirect_to = add_query_arg(
array(
'loggedout' => 'true',
'wp_lang' => get_user_locale($user),
),
wp_login_url()
);
$requested_redirect_to = '';
}
/**
* Filters the log out redirect URL.
*
* @since 4.2.0
*
* @param string $redirect_to The redirect destination URL.
* @param string $requested_redirect_to The requested redirect destination URL passed as a parameter.
* @param WP_User $user The WP_User object for the user that's logging out.
*/
$redirect_to = apply_filters('logout_redirect', $redirect_to, $requested_redirect_to, $user);
wp_safe_redirect($redirect_to);
exit;
case 'lostpassword':
case 'retrievepassword':
if ($http_post) {
$errors = retrieve_password();
if (! is_wp_error($errors)) {
$redirect_to = ! empty($_REQUEST['redirect_to']) ? $_REQUEST['redirect_to'] : 'wp-login.php?checkemail=confirm';
wp_safe_redirect($redirect_to);
exit;
}
}
if (isset($_GET['error'])) {
if ('invalidkey' === $_GET['error']) {
$errors->add('invalidkey', __('Your password reset link appears to be invalid. Please request a new link below.')); // phpcs:ignore UpdraftPlus.Translation.MultipleSentence.MultipleSentenceInsideTranslationFunction -- This is a WordPress translation.
} elseif ('expiredkey' === $_GET['error']) {
$errors->add('expiredkey', __('Your password reset link has expired. Please request a new link below.')); // phpcs:ignore UpdraftPlus.Translation.MultipleSentence.MultipleSentenceInsideTranslationFunction -- This is a WordPress translation.
}
}
$lostpassword_redirect = ! empty($_REQUEST['redirect_to']) ? $_REQUEST['redirect_to'] : '';
/**
* Filters the URL redirected to after submitting the lostpassword/retrievepassword form.
*
* @since 3.0.0
*
* @param string $lostpassword_redirect The redirect destination URL.
*/
$redirect_to = apply_filters('lostpassword_redirect', $lostpassword_redirect);
/**
* Fires before the lost password form.
*
* @since 1.5.1
* @since 5.1.0 Added the `$errors` parameter.
*
* @param WP_Error $errors A `WP_Error` object containing any errors generated by using invalid
* credentials. Note that the error object may not contain any errors.
*/
do_action('lost_password', $errors);
login_header(__('Lost Password'), '' . __('Please enter your username or email address. You will receive an email message with instructions on how to reset your password.') . '
', $errors); // phpcs:ignore UpdraftPlus.Translation.MultipleSentence.MultipleSentenceInsideTranslationFunction -- This is a WordPress translation.
$user_login = '';
if (isset($_POST['user_login']) && is_string($_POST['user_login'])) {
$user_login = wp_unslash($_POST['user_login']);
}
?>
%s', esc_url(wp_registration_url()), __('Register'));
echo esc_html($login_link_separator);
// This filter is documented in wp-includes/general-template.php
echo wp_kses_post(apply_filters('register', $registration_url));
}
?>
get_error_code() === 'expired_key') {
wp_redirect(site_url('wp-login.php?action=lostpassword&error=expiredkey'));
} else {
wp_redirect(site_url('wp-login.php?action=lostpassword&error=invalidkey'));
}
exit;
}
$errors = new WP_Error();
if (isset($_POST['pass1']) && $_POST['pass1'] !== $_POST['pass2']) {
$errors->add('password_reset_mismatch', __('The passwords do not match.'));
}
/**
* Fires before the password reset procedure is validated.
*
* @since 3.5.0
*
* @param WP_Error $errors WP Error object.
* @param WP_User|WP_Error $user WP_User object if the login and reset key match. WP_Error object otherwise.
*/
do_action('validate_password_reset', $errors, $user);
if ((! $errors->has_errors()) && isset($_POST['pass1']) && ! empty($_POST['pass1'])) {
reset_password($user, $_POST['pass1']);
setcookie($rp_cookie, ' ', time() - YEAR_IN_SECONDS, $rp_path, COOKIE_DOMAIN, is_ssl(), true);
login_header(__('Password Reset'), '' . __('Your password has been reset.') . ' ' . __('Log in') . '
');
login_footer();
exit;
}
wp_enqueue_script('utils');
wp_enqueue_script('user-profile');
login_header(__('Reset Password'), '' . __('Enter your new password below.') . '
', $errors);
?>
%s', esc_url(wp_registration_url()), __('Register'));
echo esc_html($login_link_separator);
// This filter is documented in wp-includes/general-template.php
echo wp_kses_post(apply_filters('register', $registration_url));
}
?>
' . __('Register For This Site') . '', $errors);
?>
add(
'confirm',
sprintf(
/* translators: %s: Link to the login page. */
__('Check your email for the confirmation link, then visit the login page.'),
wp_login_url()
),
'message'
);
} elseif ('registered' === $_GET['checkemail']) {
$errors->add(
'registered',
sprintf(
/* translators: %s: Link to the login page. */
__('Registration complete. Please check your email, then visit the login page.'), // phpcs:ignore UpdraftPlus.Translation.MultipleSentence.MultipleSentenceInsideTranslationFunction -- This is a WordPress translation.
wp_login_url()
),
'message'
);
}
// This action is documented in wp-login.php
$errors = apply_filters('wp_login_errors', $errors, $redirect_to);
login_header(__('Check your email'), '', $errors);
login_footer();
break;
case 'confirmaction':
if (! isset($_GET['request_id'])) {
wp_die(esc_html__('Missing request ID.'));
}
if (! isset($_GET['confirm_key'])) {
wp_die(esc_html__('Missing confirm key.'));
}
$request_id = (int) $_GET['request_id'];
$key = sanitize_text_field(wp_unslash($_GET['confirm_key']));
$result = wp_validate_user_request_key($request_id, $key);
if (is_wp_error($result)) {
wp_die($result);
}
/**
* Fires an action hook when the account action has been confirmed by the user.
*
* Using this you can assume the user has agreed to perform the action by
* clicking on the link in the confirmation email.
*
* After firing this action hook the page will redirect to wp-login a callback
* redirects or exits first.
*
* @since 4.9.6
*
* @param int $request_id Request ID.
*/
do_action('user_request_action_confirmed', $request_id);
$message = _wp_privacy_account_request_confirmed_message($request_id);
login_header(__('User action confirmed.'), $message);
login_footer();
exit;
case 'login':
default:
$secure_cookie = '';
$customize_login = isset($_REQUEST['customize-login']);
if ($customize_login) {
wp_enqueue_script('customize-base');
}
// If the user wants SSL but the session is not SSL, force a secure cookie.
if (! empty($_POST['log']) && ! force_ssl_admin()) {
$user_name = sanitize_user(wp_unslash($_POST['log']));
$user = get_user_by('login', $user_name);
if (! $user && strpos($user_name, '@')) {
$user = get_user_by('email', $user_name);
}
if ($user) {
if (get_user_option('use_ssl', $user->ID)) {
$secure_cookie = true;
force_ssl_admin(true);
}
}
}
if (isset($_REQUEST['redirect_to'])) {
$redirect_to = $_REQUEST['redirect_to'];
// Redirect to HTTPS if user wants SSL.
if ($secure_cookie && false !== strpos($redirect_to, 'wp-admin')) {
$redirect_to = preg_replace('|^http://|', 'https://', $redirect_to);
}
} else {
$redirect_to = admin_url();
}
$reauth = empty($_REQUEST['reauth']) ? false : true;
$user = wp_signon(array(), $secure_cookie);
if (empty($_COOKIE[LOGGED_IN_COOKIE])) {
if (headers_sent()) {
$user = new WP_Error(
'test_cookie',
sprintf(
/* translators: 1: Browser cookie documentation URL, 2: Support forums URL. */
__('Error: Cookies are blocked due to unexpected output. For help, please see this documentation or try the support forums.'), // phpcs:ignore UpdraftPlus.Translation.MultipleSentence.MultipleSentenceInsideTranslationFunction -- This is a WordPress translation.
esc_url(__('https://wordpress.org/support/article/cookies/')),
esc_url(__('https://wordpress.org/support/forums/'))
)
);
} elseif (isset($_POST['testcookie']) && empty($_COOKIE[TEST_COOKIE])) {
// If cookies are disabled, we can't log in even with a valid user and password.
$user = new WP_Error(
'test_cookie',
sprintf(
/* translators: %s: Browser cookie documentation URL. */
__('Error: Cookies are blocked or not supported by your browser. You must enable cookies to use WordPress.'), // phpcs:ignore UpdraftPlus.Translation.MultipleSentence.MultipleSentenceInsideTranslationFunction -- This is a WordPress translation.
esc_url(__('https://wordpress.org/support/article/cookies/#enable-cookies-in-your-browser'))
)
);
}
}
$requested_redirect_to = isset($_REQUEST['redirect_to']) ? $_REQUEST['redirect_to'] : '';
/**
* Filters the login redirect URL.
*
* @since 3.0.0
*
* @param string $redirect_to The redirect destination URL.
* @param string $requested_redirect_to The requested redirect destination URL passed as a parameter.
* @param WP_User|WP_Error $user WP_User object if login was successful, WP_Error object otherwise.
*/
$redirect_to = apply_filters('login_redirect', $redirect_to, $requested_redirect_to, $user);
if (! is_wp_error($user) && ! $reauth) {
if ($interim_login) {
$message = '' . __('You have logged in successfully.') . '
';
$interim_login = 'success';
login_header('', $message);
?>