WP_Application_Passwords

14#[AllowDynamicProperties]15class WP_Application_Passwords {16 17	/**18	 * The application passwords user meta key.19	 *20	 * @since 5.6.021	 *22	 * @var string23	 */24	const USERMETA_KEY_APPLICATION_PASSWORDS = '_application_passwords';25 26	/**27	 * The option name used to store whether application passwords are in use.28	 *29	 * @since 5.6.030	 *31	 * @var string32	 */33	const OPTION_KEY_IN_USE = 'using_application_passwords';34 35	/**36	 * The generated application password length.37	 *38	 * @since 5.6.039	 *40	 * @var int41	 */42	const PW_LENGTH = 24;43 44	/**45	 * Checks if application passwords are being used by the site.46	 *47	 * This returns true if at least one application password has ever been created.48	 *49	 * @since 5.6.050	 *51	 * @return bool52	 */53	public static function is_in_use() {54		$network_id = get_main_network_id();55		return (bool) get_network_option( $network_id, self::OPTION_KEY_IN_USE );56	}57 58	/**59	 * Creates a new application password.60	 *61	 * @since 5.6.062	 * @since 5.7.0 Returns WP_Error if application name already exists.63	 * @since 6.8.0 The hashed password value now uses wp_fast_hash() instead of phpass.64	 *65	 * @param int   $user_id  User ID.66	 * @param array $args     {67	 *     Arguments used to create the application password.68	 *69	 *     @type string $name   The name of the application password.70	 *     @type string $app_id A UUID provided by the application to uniquely identify it.71	 * }72	 * @return array|WP_Error {73	 *     Application password details, or a WP_Error instance if an error occurs.74	 *75	 *     @type string $0 The generated application password in plain text.76	 *     @type array  $1 {77	 *         The details about the created password.78	 *79	 *         @type string $uuid      The unique identifier for the application password.80	 *         @type string $app_id    A UUID provided by the application to uniquely identify it.81	 *         @type string $name      The name of the application password.82	 *         @type string $password  A one-way hash of the password.83	 *         @type int    $created   Unix timestamp of when the password was created.84	 *         @type null   $last_used Null.85	 *         @type null   $last_ip   Null.86	 *     }87	 * }88	 */89	public static function create_new_application_password( $user_id, $args = array() ) {90		if ( ! empty( $args['name'] ) ) {91			$args['name'] = sanitize_text_field( $args['name'] );92		}93