WordPress.org

Languages: English • delete object term relationships 日本語 (Add your language)

Description

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

Usage

<?php wp_delete_object_term_relationships( $object_id, $taxonomies ); ?>

Parameters

$object_id

(int) (required) The term Object ID that refers to the term.

Default: None

$taxonomies

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

Default: None

Return Values

This function does not return a value.

Example

Delete all tag relationships for a post:

<?php

$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:

<?php

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

wp_delete_object_term_relationships( $post_id, $taxonomies );

?>

Notes

• Uses: wp_get_object_terms() - To get the term taxonomy IDs of all the terms linked to the object.
• Uses: $wpdb->query() - To delete the term relationships.
• Uses: wp_update_term_count() - To update the term count for the object.
• Uses: do_action():
  • Calls 'delete_term_relationships' with $object_id and the array of term taxonomy IDs before deleting the relationships.
  • Calls 'deleted_term_relationships' with $object_id and the array of term taxonomy IDs after deleting the relationships.

Change Log

Since: 2.3.0

Source File

wp_delete_object_term_relationships() is located in wp-includes/taxonomy.php.

Related

• is_term()
• term_exists()
• get_objects_in_term()
• get_term()
• get_term_by()
• get_term_children()
• get_term_link()
• get_terms()
• get_the_terms()
• get_the_term_list()
• has_term()
• sanitize term()
• the_terms()
• get_object_taxonomies()
• is_object_in_taxonomy()
• the_taxonomies()
• wp_get_object_terms()
• wp_set_object_terms()
• wp_get_post_terms()
• wp_set_post_terms()
• wp_delete_object_term_relationships()
• wp_remove_object_terms()

wp_remove_object_terms()