WordPress at Your Fingertips
function is not described

WP_Application_Passwords::record_application_password_usage() public WP 5.6.0

Records that an application password has been used.

{} It's a method of the class: WP_Application_Passwords{}

No Hooks.

Return

true|WP_Error. True if the usage was recorded, a WP_Error if an error occurs.

Usage

$result = WP_Application_Passwords::record_application_password_usage( $user_id, $uuid );
$user_id(int) (required)
User ID.
$uuid(string) (required)
The password's uuid.

Changelog

Since 5.6.0 Introduced.

Code of WP_Application_Passwords::record_application_password_usage() WP 5.8.2

public static function record_application_password_usage( $user_id, $uuid ) {
	$passwords = static::get_user_application_passwords( $user_id );

	foreach ( $passwords as &$password ) {
		if ( $password['uuid'] !== $uuid ) {
			continue;
		}

		// Only record activity once a day.
		if ( $password['last_used'] + DAY_IN_SECONDS > time() ) {
			return true;
		}

		$password['last_used'] = time();
		$password['last_ip']   = $_SERVER['REMOTE_ADDR'];

		$saved = static::set_user_application_passwords( $user_id, $passwords );

		if ( ! $saved ) {
			return new WP_Error( 'db_error', __( 'Could not save application password.' ) );
		}

		return true;
	}

	// Specified Application Password not found!
	return new WP_Error( 'application_password_not_found', __( 'Could not find an application password with that id.' ) );
}