WP_Application_Passwords::create_new_application_password( int $user_id, array $args = array() ): array|WP_Error

88	public static function create_new_application_password( $user_id, $args = array() ) {89		if ( ! empty( $args['name'] ) ) {90			$args['name'] = sanitize_text_field( $args['name'] );91		}92 93		if ( empty( $args['name'] ) ) {94			return new WP_Error( 'application_password_empty_name', __( 'An application name is required to create an application password.' ), array( 'status' => 400 ) );95		}96 97		$new_password    = wp_generate_password( static::PW_LENGTH, false );98		$hashed_password = wp_hash_password( $new_password );99 100		$new_item = array(101			'uuid'      => wp_generate_uuid4(),102			'app_id'    => empty( $args['app_id'] ) ? '' : $args['app_id'],103			'name'      => $args['name'],104			'password'  => $hashed_password,105			'created'   => time(),106			'last_used' => null,107			'last_ip'   => null,108		);109 110		$passwords   = static::get_user_application_passwords( $user_id );111		$passwords[] = $new_item;112		$saved       = static::set_user_application_passwords( $user_id, $passwords );113 114		if ( ! $saved ) {115			return new WP_Error( 'db_error', __( 'Could not save application password.' ) );116		}117 118		$network_id = get_main_network_id();119		if ( ! get_network_option( $network_id, self::OPTION_KEY_IN_USE ) ) {120			update_network_option( $network_id, self::OPTION_KEY_IN_USE, true );121		}122 123		/**124		 * Fires when an application password is created.125		 *126		 * @since 5.6.0127		 *128		 * @param int    $user_id      The user ID.129		 * @param array  $new_item     {130		 *     The details about the created password.131		 *132		 *     @type string $uuid      The unique identifier for the application password.133		 *     @type string $app_id    A UUID provided by the application to uniquely identify it.134		 *     @type string $name      The name of the application password.135		 *     @type string $password  A one-way hash of the password.136		 *     @type int    $created   Unix timestamp of when the password was created.137		 *     @type null   $last_used Null.138		 *     @type null   $last_ip   Null.139		 * }140		 * @param string $new_password The generated application password in plain text.141		 * @param array  $args         {142		 *     Arguments used to create the application password.143		 *144		 *     @type string $name   The name of the application password.145		 *     @type string $app_id A UUID provided by the application to uniquely identify it.146		 * }147		 */148		do_action( 'wp_create_application_password', $user_id, $new_item, $new_password, $args );149 150		return array( $new_password, $new_item );151	}