unregister_taxonomy()

Отменяет регистрацию таксономии. Не работает для рубрик и меток.

Возвращает:

• true – таксономия успешно де-регистрирована.
• WP_Error – либо в качестве параметра передана несуществующая таксономия, либо таксономия с системный свойством _builtin (рубрика или метка).

unregister_taxonomy( $taxonomy )

Параметры

$taxonomy

(строка) Название таксономии.

Пример

Функция также должна добавляться на хук init (на этот же хук добавляется и регистрация таксономии).

Могу предположить, что у хука должен быть повыше приоритет, чтобы мы не пытались отменить регистрацию таксономии, которая ещё даже не начинала регистрироваться.

Например, предположим, что где-то в коде у нас регистрируется таксономия:

// возможно, что этот код какого-то стороннего плагина или родительской темы
add_action( 'init', function() {
	register_taxonomy( 'game', ..... );
}, 25 );

А затем нам нужно её отменить:

add_action( 'init', function() {
 
	// кстати говоря, тут мы ещё можем добавить какие-то условия
 
	unregister_taxonomy( 'game' );
}, 27 ); // я использовал приоритет меньше, то есть хук сработает позже

Подробнее про хуки и приоритеты тут.

Хуки внутри функции

unregistered_taxonomy

Срабатывает после снятия с регистрации таксономии и перед тем, как функция возвращает true.

С версии 4.5.0

do_action( 'unregistered_taxonomy', $taxonomy );