unregister_taxonomy_for_object_type() WP 3.7.0

Открепляет таксономию от указанного типа записи (или другого объекта).

Возвращает

true/false. True, если удалось отвязать таксономию.

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

unregister_taxonomy_for_object_type( $taxonomy, $object_type );

$taxonomy(строка) (обязательный)

Имя таксономии, указываемое в register_taxonomy() первым аргументом.

$object_type(строка) (обязательный)

Имя типа записи, указываемое в register_post_type() первым параметром.

Примеры

#1 Отвяжем "Метки" от "Записей"

Этот пример отвяжет "Метки" от "Записей", то есть в меню "Записи" пропадёт пункт "Метки", а при редактировании записи пропадёт метабокс "Метки". Физического удаления таксономии "Метки" не произойдёт.

add_action( 'init', 'prefix_unregister_tags', 99 );
function prefix_unregister_tags(){
	unregister_taxonomy_for_object_type( 'post_tag', 'post' );

	// Тоже самое можно сделать и с "Рубриками"
	// unregister_taxonomy_for_object_type( 'category', 'post' );
}

Заметки

• Global. Массив. $wp_taxonomies The registered taxonomies.

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

Код unregister taxonomy for object type: wp-includes/taxonomy.php ^{WP 5.4}

<?php
function unregister_taxonomy_for_object_type( $taxonomy, $object_type ) {
	global $wp_taxonomies;

	if ( ! isset( $wp_taxonomies[ $taxonomy ] ) ) {
		return false;
	}

	if ( ! get_post_type_object( $object_type ) ) {
		return false;
	}

	$key = array_search( $object_type, $wp_taxonomies[ $taxonomy ]->object_type, true );
	if ( false === $key ) {
		return false;
	}

	unset( $wp_taxonomies[ $taxonomy ]->object_type[ $key ] );

	/**
	 * Fires after a taxonomy is unregistered for an object type.
	 *
	 * @since 5.1.0
	 *
	 * @param string $taxonomy    Taxonomy name.
	 * @param string $object_type Name of the object type.
	 */
	do_action( 'unregistered_taxonomy_for_object_type', $taxonomy, $object_type );

	return true;
}

Cвязанные функции

Из раздела: Любые таксономии