WP_Application_Passwords::record_application_password_usage( int $user_id, string $uuid ): true|WP_Error

Records that an application password has been used.


Parameters

$user_id int Required
User ID.
$uuid string Required
The password's UUID.

Top ↑

Return

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


Top ↑

Source

File: wp-includes/class-wp-application-passwords.php. View all references

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.' ) );
}


Top ↑

Changelog

Changelog
Version Description
5.6.0 Introduced.

Top ↑

User Contributed Notes

You must log in before being able to contribute a note or feedback.