wp_delete_object_term_relationships() – Function

Unlinks 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.

Parameters

$object_idintrequired: The term object ID that refers to the term.
$taxonomiesstring|arrayrequired: List of taxonomy names or single taxonomy name.

Source

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 );
	}
}

View all references View on Trac View on GitHub

Uses	Description
wp_get_object_terms()`wp-includes/taxonomy.php`	Retrieves the terms associated with the given object(s), in the supplied taxonomies.
wp_remove_object_terms()`wp-includes/taxonomy.php`	Removes term(s) associated with a given object.

Used by	Description
wp_delete_link()`wp-admin/includes/bookmark.php`	Deletes a specified link from the database.
wp_delete_attachment()`wp-includes/post.php`	Trashes or deletes an attachment.
wp_delete_post()`wp-includes/post.php`	Trashes or deletes a post or page.

Changelog

Version	Description
2.3.0	Introduced.

User Contributed Notes

Skip to note 3 content

Codex 9 years ago

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
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.
```
Log in to add feedback
Skip to note 4 content

Codex 9 years ago

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
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 );
```
Log in to add feedback

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

In this article

Description

Parameters

Source

Changelog

User Contributed Notes

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

In this article

Description

Parameters

Source

Related

Changelog

User Contributed Notes