wp_delete_term()

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

Удаляет элемент таксономии. А также его метаданные.

Если термин является родительским для других терминов, то его дочерние элементы будут подвинуты на уровень выше.

Возвращает:

true – удаление прошло успешно,
false – указанных терминов не существует,
0 – если была попытка удалить категорию по умолчанию, термин по умолчанию.

wp_delete_term( $term, $taxonomy, $args = array() )

Параметры

$term

(целое) ID элемента таксономии, который нужно удалить.

$taxonomy

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

$args

(массив)

default

(целое) Укажите ID термина, в который мы должны поместить посты удаляемого термина.

force_default

(логическое)

false (по умолчанию) – посты удаляемого термина будут помещены в термин default только, если у них больше нет терминов (кроме удаляемого).
true – посты удаляемого термина будут помещены в термин default в любом случае.

Пример

// Попробуем удалить рубрику с ID = 25
if( wp_delete_term( 25, 'category' ) ) {
	echo 'Удаление прошло ОК';
} else {
	echo 'Либо рубрики не существует, либо это основная рубрика в Настройки > Написание';
}

Также можем проапгрейдить наш пример, поместив все посты из удаляемой рубрики с ID=25 в рубрику с ID=5.

if( wp_delete_term( 25, 'category', array( 'default' => 5, 'force_default' => true ) ) ) {

Хуки

Не знаете, как работать с хуками?

pre_delete_term

Запускается непосредственно перед удалением термина.

С версии 4.1.0

do_action( 'pre_delete_term', $term, $taxonomy );

edit_term_taxonomies

Запускается непосредственно перед тем, как функция начнёт обрабатывать дочерние элементы удаляемого термина. Не срабатывает для таксономий без иерархии.

С версии 2.9.0

do_action( 'edit_term_taxonomies', $edit_tt_ids );

edited_term_taxonomies

Запускается непосредственно после того, как функция обработает дочерние элементы удаляемого термина. Не срабатывает для таксономий без иерархии.

С версии 2.9.0

do_action( 'edited_term_taxonomies', $edit_tt_ids );

delete_term_taxonomy

Запускается непосредственно перед удалением данных термина из таблицы wp_term_taxonomy.

С версии 2.9.0

do_action( 'delete_term_taxonomy', $tt_id );

deleted_term_taxonomy

Запускается непосредственно после удаления данных термина из таблицы wp_term_taxonomy.

С версии 2.9.0

do_action( 'deleted_term_taxonomy', $tt_id );

delete_term

Срабатывает в самом конце – после полного удаления элемента таксономии и очистки кэша

С версии 2.5.0

do_action( 'delete_term', $term, $tt_id, $taxonomy, $deleted_term, $object_ids );

delete_{$taxonomy}

Срабатывает в самом конце – после полного удаления элемента таксономии и очистки кэша.

С версии 2.5.0

do_action( "delete_{$taxonomy}", $term, $tt_id, $deleted_term, $object_ids );

Кодекс 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. Преподаватель в школе Нетология.

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

Параметры
Пример
Хуки