WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

wp_get_abilities()

wp_get_abilities(): WP_Ability[]

In this article

Back to top

Retrieves all registered abilities.

Description

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

Example:

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

See also

Return

WP_Ability[] An array of registered WP_Ability instances. Returns an empty array if no abilities are registered or if the registry is unavailable.

Source

function wp_get_abilities(): array {
	$registry = WP_Abilities_Registry::get_instance();
	if ( null === $registry ) {
		return array();
	}

	return $registry->get_all_registered();
}

View all references View on Trac View on GitHub

UsesDescription
WP_Abilities_Registry::get_instance()wp-includes/abilities-api/class-wp-abilities-registry.php

Utility method to retrieve the main instance of the registry class.

Used byDescription
WP_REST_Abilities_V1_List_Controller::get_items()wp-includes/rest-api/endpoints/class-wp-rest-abilities-v1-list-controller.php

Retrieves all abilities.

Changelog

VersionDescription
6.9.0Introduced.

User Contributed Notes

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