Singleton registry for managing ability categories.

Source: wp-includes/abilities-api/class-wp-ability-categories-registry.php
Since: 6.9.0

Properties

Methods

get_instance()

Returns the singleton registry instance.

public static function get_instance(): ?self

Returns: Registry instance, or null if called before initialization.

Note: Fires wp_abilities_api_categories_init action on first call.

register()

Registers a new ability category.

public function register( string $slug, array $args ): ?WP_Ability_Category

Returns: WP_Ability_Category on success, null on failure.

Validation:

• Slug must be lowercase alphanumeric with dashes
• Required args: label, description

Filters:

• wp_register_ability_category_args — Modify args before registration

Errors (via _doing_it_wrong):

• Invalid slug format
• Duplicate slug

unregister()

Removes a registered category.

public function unregister( string $slug ): ?WP_Ability_Category

Returns: Removed WP_Ability_Category, or null if not found.

get_registered()

Retrieves a single registered category.

public function get_registered( string $slug ): ?WP_Ability_Category

Returns: WP_Ability_Category or null if not registered.

get_all_registered()

Retrieves all registered categories.

public function get_all_registered(): array

Returns: Array of WP_Ability_Category instances.

is_registered()

Checks if a category is registered.

public function is_registered( string $slug ): bool

Returns: true if registered, false otherwise.

__wakeup()

Prevents unserialization (security hardening).

public function __wakeup(): void

Throws: LogicException

__sleep()

Prevents serialization (security hardening).

public function __sleep(): array

Throws: LogicException