Question

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

Will unlink the object from the taxonomy or taxonomies.

---

description

Will remove all relationships between the object and any terms in a particular taxonomy or taxonomies. Does not remove the term or taxonomy itself.

---

参数

$object_id

(int) (Required) The term Object Id that refers to the term.

$taxonomies

(string|array) (Required) List of Taxonomy Names or single Taxonomy name.

---

源代码

File: wp-includes/taxonomy.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 );
	}
}

---

更新日志

Version	description
2.3.0	Introduced.

---

相关函数

Uses

• wp-includes/taxonomy.php: wp_get_object_terms()
• wp-includes/taxonomy.php: wp_remove_object_terms()

---

Used By

• wp-admin/includes/bookmark.php: wp_delete_link()
• wp-includes/post.php: wp_delete_attachment()
• wp-includes/post.php: wp_delete_post()

---

User Contributed Notes

1. Skip to note content You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note Contributed by Codex

   Delete all tag relationships for a post

   
   $post_id = 55;
   
   wp_delete_object_term_relationships( $post_id, 'post_tag' );
   // Post 55 now has no tags.
   

Delete multiple taxonomies’ relationships for a post

$post_id = 55;
$taxonomies = array( 'category', 'post_tag', 'custom_taxonomy' );

wp_delete_object_term_relationships( $post_id, $taxonomies );