eurobyte.ru - мощные сервера с Дата-центрами в Нидерландах и Москве. От 159 ₽/мес.
Kama и campusboy3.1 год назад7 EN

wp_remove_object_terms() │ WP 3.6.0

Разрывает связь между указанным объектом и указанным термином, т.е. удаляет запись из элемента таксономии (рубрики).

После удаления связи количество записей в термине пересчитывается с помощью wp_update_term_count().

Используйте wp_delete_object_term_relationships(), чтобы удалить сразу все связи объекта с таксономией.

Прямо перед удалением связи срабатывает событие delete_term_relationships и сразу после удаления срабатывает deleted_term_relationships. События передают переменные: $object_id - ID обрабатываемого объекта и $tt_ids - ID терминов таксономий (это не ID термина), связь с которыми разрывается.

Работает на основе: term_exists()
Основа для: wp_delete_object_term_relationships()
Хуки из функции

Возвращает

true|false|WP_Error.

  • true - если удалось разорвать связь.
  • false или объект WP_Error - в случае неудачи.

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

wp_remove_object_terms( $object_id, $terms, $taxonomy );
$object_id(число) (обязательный)
ID объекта, который нужно удалить из терминов. Под объектом подразумевается любая запись: пост, страница, ссылка, произвольный тип записи.
$terms(строка/массив/число/объект) (обязательный)

ID/ярлык/объект термина из которого будет удаляться указанный в $object_id объект. Можно указать несколько терминов в массиве одновременно.

Если указывается ID, то значение должно быть типа "число", а не строка в виде чила. Например 12 а не '12'. Указанные тут значения передаются в term_exists() - подробнее смотрите там.

$taxonomy(строка/массив) (обязательный)
Название таксономии в которой находятся термины. Можно указать строку или массив строк нескольких таксономий.

Примеры

1

#1 Удаление метки у поста

Пример, демонстрирующий как удалить запись из термина таксономии:

$post_id  = 5;
$terms    = 'sweet';
$taxonomy = 'post_tag';

$done = wp_remove_object_terms( $post_id, $terms, $taxonomy );

if( $done ){
	echo "Метка записи удалена.";
}
else {
	echo "Не удалось удалить метку.";
}

Заметки

  • Global. wpdb. $wpdb WordPress database abstraction object.

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

С версии 3.6.0 Введена.

Код wp_remove_object_terms() WP 6.8.3

wp-includes/taxonomy.php 
function wp_remove_object_terms( $object_id, $terms, $taxonomy ) {
	global $wpdb;

	$object_id = (int) $object_id;

	if ( ! taxonomy_exists( $taxonomy ) ) {
		return new WP_Error( 'invalid_taxonomy', __( 'Invalid taxonomy.' ) );
	}

	if ( ! is_array( $terms ) ) {
		$terms = array( $terms );
	}

	$tt_ids = array();

	foreach ( (array) $terms as $term ) {
		if ( '' === trim( $term ) ) {
			continue;
		}

		$term_info = term_exists( $term, $taxonomy );
		if ( ! $term_info ) {
			// Skip if a non-existent term ID is passed.
			if ( is_int( $term ) ) {
				continue;
			}
		}

		if ( is_wp_error( $term_info ) ) {
			return $term_info;
		}

		$tt_ids[] = $term_info['term_taxonomy_id'];
	}

	if ( $tt_ids ) {
		$in_tt_ids = "'" . implode( "', '", $tt_ids ) . "'";

		/**
		 * Fires immediately before an object-term relationship is deleted.
		 *
		 * @since 2.9.0
		 * @since 4.7.0 Added the `$taxonomy` parameter.
		 *
		 * @param int    $object_id Object ID.
		 * @param array  $tt_ids    An array of term taxonomy IDs.
		 * @param string $taxonomy  Taxonomy slug.
		 */
		do_action( 'delete_term_relationships', $object_id, $tt_ids, $taxonomy );

		$deleted = $wpdb->query( $wpdb->prepare( "DELETE FROM $wpdb->term_relationships WHERE object_id = %d AND term_taxonomy_id IN ($in_tt_ids)", $object_id ) );

		wp_cache_delete( $object_id, $taxonomy . '_relationships' );
		wp_cache_set_terms_last_changed();

		/**
		 * Fires immediately after an object-term relationship is deleted.
		 *
		 * @since 2.9.0
		 * @since 4.7.0 Added the `$taxonomy` parameter.
		 *
		 * @param int    $object_id Object ID.
		 * @param array  $tt_ids    An array of term taxonomy IDs.
		 * @param string $taxonomy  Taxonomy slug.
		 */
		do_action( 'deleted_term_relationships', $object_id, $tt_ids, $taxonomy );

		wp_update_term_count( $tt_ids, $taxonomy );

		return (bool) $deleted;
	}

	return false;
}

Для записей

7 комментариев