WP_Abilities_Registry::unregister │ public │ WP 6.9.0

Unregisters an ability.

Do not use this method directly. Instead, use the wp_unregister_ability()

Method of the class: WP_Abilities_Registry{}

No Hooks.

Returns

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

Usage

$WP_Abilities_Registry = new WP_Abilities_Registry();
$WP_Abilities_Registry->unregister( $name ): ?WP_Ability;

$name(string) (required)

The name of the registered ability, with its namespace.

Notes

• See: wp_unregister_ability()

Changelog

WP_Abilities_Registry::unregister() WP Abilities Registry::unregister code ^{WP 7.0}

public function unregister( string $name ): ?WP_Ability {
	if ( ! $this->is_registered( $name ) ) {
		_doing_it_wrong(
			__METHOD__,
			/* translators: %s: Ability name. */
			sprintf( __( 'Ability "%s" not found.' ), esc_html( $name ) ),
			'6.9.0'
		);
		return null;
	}

	$unregistered_ability = $this->registered_abilities[ $name ];
	unset( $this->registered_abilities[ $name ] );

	return $unregistered_ability;
}