wp_unregister_ability_category() │ WP 6.9.0

Удаляет зарегистрированную категорию способностей из глобального реестра.

Вызывать можно в любое время после регистрации категории. Если категория не найдена, функция создаст уведомление через _doing_it_wrong() и вернёт null.

Работает на основе: WP_Ability_Categories_Registry::unregister()

Хуков нет.

Возвращает

WP_Ability_Category|null.

WP_Ability_Category - удалённая категория.
null - категория не зарегистрирована или реестр недоступен.

Использование

wp_unregister_ability_category( $slug ): ?WP_Ability_Category;

$slug(string) (обязательный): Ярлык удаляемой категории способностей.

Примеры

#1 Удаление категории способностей

function my_plugin_unregister_ability_category(): void {
	if ( wp_has_ability_category( 'deprecated-category' ) ) {
		wp_unregister_ability_category( 'deprecated-category' );
	}
}

add_action(
	'wp_abilities_api_categories_init',
	'my_plugin_unregister_ability_category',
	20
);

Заметки

Смотрите: WP_Ability_Categories_Registry::unregister()
Смотрите: wp_register_ability_category()

Список изменений

С версии 6.9.0

Введена.

Код `wp_unregister_ability_category() wp unregister ability category` ^{WP 7.0.2}

wp-includes/abilities-api.php

function wp_unregister_ability_category( string $slug ): ?WP_Ability_Category {
	$registry = WP_Ability_Categories_Registry::get_instance();
	if ( null === $registry ) {
		return null;
	}

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