W3cubDocs

/WordPress

WP_Recovery_Mode_Link_Service::handle_begin_link( int $ttl )

Enters recovery mode when the user hits wp-login.php with a valid recovery mode link.

Parameters

$ttl

(int) (Required) Number of seconds the link should be valid for.

Source

File: wp-includes/class-wp-recovery-mode-link-service.php 

public function handle_begin_link( $ttl ) {
		if ( ! isset( $GLOBALS['pagenow'] ) || 'wp-login.php' !== $GLOBALS['pagenow'] ) {
			return;
		}

		if ( ! isset( $_GET['action'], $_GET['rm_token'], $_GET['rm_key'] ) || self::LOGIN_ACTION_ENTER !== $_GET['action'] ) {
			return;
		}

		if ( ! function_exists( 'wp_generate_password' ) ) {
			require_once ABSPATH . WPINC . '/pluggable.php';
		}

		$validated = $this->key_service->validate_recovery_mode_key( $_GET['rm_token'], $_GET['rm_key'], $ttl );

		if ( is_wp_error( $validated ) ) {
			wp_die( $validated, '' );
		}

		$this->cookie_service->set_cookie();

		$url = add_query_arg( 'action', self::LOGIN_ACTION_ENTERED, wp_login_url() );
		wp_redirect( $url );
		die;
	}

Uses

Uses Description
wp-includes/pluggable.php: wp_redirect()

Redirects to another page.
wp-includes/general-template.php: wp_login_url()

Retrieves the login URL.
wp-includes/functions.php: wp_die()

Kills WordPress execution and displays HTML page with an error message.
wp-includes/functions.php: add_query_arg()

Retrieves a modified URL query string.
wp-includes/load.php: is_wp_error()

Check whether variable is a WordPress Error.

Changelog

Version Description
5.2.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/classes/wp_recovery_mode_link_service/handle_begin_link