wp_generate_user_request_key( int $request_id )

Returns a confirmation key for a user action and stores the hashed version for future comparison.


Parameters

$request_id

(int) (Required) Request ID.


Return

(string) Confirmation key.


Source

File: wp-includes/user.php

function wp_generate_user_request_key( $request_id ) {
	global $wp_hasher;

	// Generate something random for a confirmation key.
	$key = wp_generate_password( 20, false );

	// Return the key, hashed.
	if ( empty( $wp_hasher ) ) {
		require_once ABSPATH . WPINC . '/class-phpass.php';
		$wp_hasher = new PasswordHash( 8, true );
	}

	wp_update_post( array(
		'ID'                => $request_id,
		'post_status'       => 'request-pending',
		'post_password'     => $wp_hasher->HashPassword( $key ),
		'post_modified'     => current_time( 'mysql', false ),
		'post_modified_gmt' => current_time( 'mysql', true ),
	) );

	return $key;
}


Changelog

Changelog
Version Description
WP-4.9.6 Introduced.