删除与给定对象关联的术语。

原型

wp_remove_object_terms( int $object_id, string|int|array $terms, array|string $taxonomy )

参数

$object_id (int) (Required) 将从中删除术语的对象的ID。

$terms (string|int|array) (Required) 要移除的术语的slug或ID(s)。

$taxonomy (array|string) (Required) 分类名称。

返回值

(bool|WP_Error)  成功,虚假或

源文件

路径:wp-includes/taxonomy.php

<?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 ( ! strlen( trim( $term ) ) ) {
			continue;
		}
		if ( ! $term_info = term_exists( $term, $taxonomy ) ) {
			// 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_delete( 'last_changed', 'terms' );
		/**
		 * 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;
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/wp_remove_object_terms/