wp_delete_term()

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

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

Возвращает:

  • 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 в 2009 году. Организатор и спикер на конференциях WordCamp. Преподаватель в школе Нетология.

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

Чтобы оставить комментарий, пожалуйста, зарегистрируйтесь или войдите.

Миша Рудрастых и WordPress

Полезности из мира WordPress и жизни студии.

Мой телеграм-канал