wp_get_ability_categories() │ WP 6.9.0

Gets all registered ability categories.

The returned array is indexed by category slug. It is useful for inspecting available categories, debugging, and building management interfaces.

Uses: WP_Ability_Categories_Registry::get_all_registered()

No Hooks.

Returns

WP_Ability_Category[].

array - WP_Ability_Category objects indexed by category slug.
[] - if no categories are registered or the registry is unavailable.

Usage

wp_get_ability_categories(): array;

Examples

#1 Display registered categories

$categories = wp_get_ability_categories();

foreach ( $categories as $slug => $category ) {
	echo esc_html( $category->get_label() );
}

Notes

Changelog

Since 6.9.0

Introduced.

`wp_get_ability_categories() wp get ability categories` code ^{WP 7.0.4}

wp-includes/abilities-api.php

function wp_get_ability_categories(): array {
	$registry = WP_Ability_Categories_Registry::get_instance();
	if ( null === $registry ) {
		return array();
	}

	return $registry->get_all_registered();
}