wp_delete_object_term_relationships() WordPress Function
The wp_delete_object_term_relationships() function is used to delete all relationships between the given object and any terms in the given taxonomy. This function does not delete the terms themselves, only the relationships between the object and the terms.
wp_delete_object_term_relationships( int $object_id, string|array $taxonomies ) #
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_id
(int)(Required)The term object ID that refers to the term.
- $taxonomies
(string|array)(Required)List of taxonomy names or single taxonomy name.
Source
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 ); } }
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
Version | Description |
---|---|
2.3.0 | Introduced. |