wp_unregister_ability( string $name ): WP_Ability|null

Unregisters an ability from the Abilities API.

Description

Removes a previously registered ability from the global registry. Use this to disable abilities provided by other plugins or when an ability is no longer needed.

Can be called at any time after the ability has been registered.

Example:

if ( wp_has_ability( 'other-plugin/some-ability' ) ) {
    wp_unregister_ability( 'other-plugin/some-ability' );
}

Parameters

$namestringrequired: The name of the ability to unregister, including namespace prefix (e.g., 'my-plugin/my-ability').

Return

WP_Ability|null The unregistered ability instance on success, null on failure.

Source

function wp_unregister_ability( string $name ): ?WP_Ability {
	$registry = WP_Abilities_Registry::get_instance();
	if ( null === $registry ) {
		return null;
	}

	return $registry->unregister( $name );
}

View all references View on Trac View on GitHub

Uses	Description
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.

Changelog

Version	Description
6.9.0	Introduced.

User Contributed Notes

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