将对象与分类法或分类法取消链接。

原型

wp_delete_object_term_relationships( int $object_id, string|array $taxonomies )

描述

将删除对象与特定分类法或分类法中的任何术语之间的所有关系。不删除术语或分类法本身。

参数

$object_id (int) (Required) 术语“对象ID”指的是术语。

$taxonomies (string|array) (Required) 分类名称列表或单个分类名称。

源文件

路径:wp-includes/taxonomy.php

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
<?php
...
function wp_delete_object_term_relationships( $object_id, $taxonomies ) {
	$object_id = (int) $object_id;

	if ( !is_array($taxonomies) )
		$taxonomies = array($taxonomies);

	foreach ( (array) $taxonomies as $taxonomy ) {
		$term_ids = wp_get_object_terms( $object_id, $taxonomy, array( 'fields' => 'ids' ) );
		$term_ids = array_map( 'intval', $term_ids );
		wp_remove_object_terms( $object_id, $term_ids, $taxonomy );
	}
}

...
?>

其他

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