unregister_taxonomy()

4.5.0 wp-includes / taxonomy.php / Кодекс WordPress

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

Возвращает:

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 );

Кодекс WordPress: Таксономии: add_term_meta(), edit_term_link(), get_ancestors(), get_edit_term_link(), get_taxonomies(), get_taxonomy(), get_term(), get_term_by(), get_term_children(), get_term_field(), get_term_link(), get_term_meta(), get_term_parents_list(), get_terms(), get_the_term_list(), get_the_terms(), is_object_in_term(), is_tax(), is_taxonomy_hierarchical(), register_taxonomy(), register_taxonomy_for_object_type(), sanitize_term(), sanitize_term_field(), single_term_title(), taxonomy_exists(), term_description(), term_exists(), term_is_ancestor_of(), the_terms(), unregister_taxonomy(), unregister_taxonomy_for_object_type(), update_term_meta(), wp_count_terms(), wp_delete_term(), wp_get_object_terms(), wp_get_post_terms(), wp_get_term_taxonomy_parent_id(), wp_insert_term(), wp_set_object_terms(), wp_update_term()

Миша

Впервые познакомился с WordPress в 2009 году. Организатор и спикер на конференциях WordCamp. Преподаватель в школе Нетология.

Пишите, если нужна помощь с сайтом или разработка с нуля.

Параметры
Пример
Хуки
1. unregistered_taxonomy