WP_Ability_Categories_Registry

20final class WP_Ability_Categories_Registry {21	/**22	 * The singleton instance of the registry.23	 *24	 * @since 6.9.025	 * @var self|null26	 */27	private static $instance = null;28 29	/**30	 * Holds the registered ability categories.31	 *32	 * @since 6.9.033	 * @var WP_Ability_Category[]34	 */35	private $registered_categories = array();36 37	/**38	 * Registers a new ability category.39	 *40	 * Do not use this method directly. Instead, use the `wp_register_ability_category()` function.41	 *42	 * @since 6.9.043	 *44	 * @see wp_register_ability_category()45	 *46	 * @param string               $slug The unique slug for the ability category. Must contain only lowercase47	 *                                   alphanumeric characters and dashes.48	 * @param array<string, mixed> $args {49	 *     An associative array of arguments for the ability category.50	 *51	 *     @type string               $label       The human-readable label for the ability category.52	 *     @type string               $description A description of the ability category.53	 *     @type array<string, mixed> $meta        Optional. Additional metadata for the ability category.54	 * }55	 * @return WP_Ability_Category|null The registered ability category instance on success, null on failure.56	 */57	public function register( string $slug, array $args ): ?WP_Ability_Category {58		if ( $this->is_registered( $slug ) ) {59			_doing_it_wrong(60				__METHOD__,61				/* translators: %s: Ability category slug. */62				sprintf( __( 'Ability category "%s" is already registered.' ), esc_html( $slug ) ),63				'6.9.0'64			);65			return null;66		}67 68		if ( ! preg_match( '/^[a-z0-9]+(?:-[a-z0-9]+)*$/', $slug ) ) {69			_doing_it_wrong(70				__METHOD__,71				__( 'Ability category slug must contain only lowercase alphanumeric characters and dashes.' ),72				'6.9.0'73			);74			return null;75		}76 77		/**78		 * Filters the ability category arguments before they are validated and used to instantiate the ability category.79		 *80		 * @since 6.9.081		 *82		 * @param array<string, mixed> $args {83		 *     The arguments used to instantiate the ability category.84		 *85		 *     @type string               $label       The human-readable label for the ability category.86		 *     @type string               $description A description of the ability category.87		 *     @type array<string, mixed> $meta        Optional. Additional metadata for the ability category.88		 * }89		 * @param string               $slug The slug of the ability category.90		 */91		$args = apply_filters( 'wp_register_ability_category_args', $args, $slug );92 93		try {94			// WP_Ability_Category::prepare_properties() will throw an exception if the properties are invalid.95			$category = new WP_Ability_Category( $slug, $args );96		} catch ( InvalidArgumentException $e ) {97			_doing_it_wrong(98				__METHOD__,99				$e->getMessage(),