WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

wp_get_ability_categories()

wp_get_ability_categories(): WP_Ability_Category[]

In this article

Back to top

Retrieves all registered ability categories.

Description

Returns an array of all ability category instances currently registered in the system.
Use this for discovery, debugging, or building administrative interfaces.

Example:

// Prints information about all available ability categories.
$ability_categories = wp_get_ability_categories();
foreach ( $ability_categories as $ability_category ) {
    echo $ability_category->get_label() . ': ' . $ability_category->get_description() . "\n";
}

See also

Return

WP_Ability_Category[] An array of registered ability category instances. Returns an empty array if no ability categories are registered or if the registry is unavailable.

Source

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

	return $registry->get_all_registered();
}

View all references View on Trac View on GitHub

UsesDescription
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 byDescription
WP_REST_Abilities_V1_Categories_Controller::get_items()wp-includes/rest-api/endpoints/class-wp-rest-abilities-v1-categories-controller.php

Retrieves all ability categories.

Changelog

VersionDescription
6.9.0Introduced.

User Contributed Notes

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