wp_get_ability_category( string $slug ): WP_Ability_Category|null

Retrieves a registered ability category.

Description

Returns the ability category instance for inspection or use. The instance provides access to the ability category’s configuration and metadata.

Example:

// Prints information about a registered ability category.
$ability_category = wp_get_ability_category( 'content-management' );
if ( $ability_category ) {
    echo $ability_category->get_label() . ': ' . $ability_category->get_description();
}

Parameters

$slugstringrequired: The slug of the ability category.

Return

WP_Ability_Category|null The ability category instance, or null if not registered.

Source

function wp_get_ability_category( string $slug ): ?WP_Ability_Category {
	$registry = WP_Ability_Categories_Registry::get_instance();
	if ( null === $registry ) {
		return null;
	}

	return $registry->get_registered( $slug );
}

View all references View on Trac View on GitHub

Uses	Description
WP_Ability_Categories_Registry::get_instance()`wp-includes/abilities-api/class-wp-ability-categories-registry.php`	Utility method to retrieve the main instance of the registry class.

Used by	Description
WP_REST_Abilities_V1_Categories_Controller::get_item()`wp-includes/rest-api/endpoints/class-wp-rest-abilities-v1-categories-controller.php`	Retrieves a specific ability category.

Changelog

Version	Description
6.9.0	Introduced.

User Contributed Notes

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