wp_remove_object_terms()
Breaks the connection between the specified object and the specified term, i.e., removes the post from the taxonomy element (category).
After the connection is removed, the number of posts in the term is recalculated using wp_update_term_count().
Use wp_delete_object_term_relationships() to remove all connections of the object with the taxonomy at once.
Right before the connection is removed, the action delete_term_relationships
is triggered, and immediately after the removal, deleted_term_relationships
is triggered. The actions pass the variables: $object_id - ID of the processed object and $tt_ids - IDs of the taxonomy terms (these are not the term IDs) whose connection is being broken.
Hooks from the function
Returns
true|false|WP_Error
.
true
- if the connection was successfully broken.false
orWP_Error
object - in case of failure.
Usage
wp_remove_object_terms( $object_id, $terms, $taxonomy );
- $object_id(integer) (required)
- ID of the object to be removed from the terms. The object refers to any post: post, page, link, custom post type.
- $terms(string/array/integer/object) (required)
ID/slug/object of the term from which the specified object in $object_id will be removed. Multiple terms can be specified in an array at once.
If an ID is specified, the value must be of type "integer", not a string in the form of a number. For example
12
not'12'
. The values specified here are passed to term_exists() - see there for more details.- $taxonomy(string/array) (required)
- Name of the taxonomy in which the terms are located. A string or an array of strings of several taxonomies can be specified.
Examples
#1 Removing tags from a post
An example showing how to remove a post from a post_tag
taxonomy term:
$post_id = 5; $terms = 'sweet'; $taxonomy = 'post_tag'; $done = wp_remove_object_terms( $post_id, $terms, $taxonomy ); if( $done ){ echo "Tag posts deleted."; } else { echo "Failed to delete the tag."; }
Notes
- Global. wpdb. $wpdb WordPress database abstraction object.
Changelog
Since 3.6.0 | Introduced. |