wp_add_object_terms() WordPress Function
The wp_add_object_terms() function is used to add terms to an object. This function can be used to add terms to posts, pages, attachments, and custom post types. This function accepts four parameters: the object ID, the taxonomy slug, an array of terms, and a append flag.
wp_add_object_terms( int $object_id, string|int|array $terms, array|string $taxonomy ) #
Adds term(s) associated with a given object.
Parameters
- $object_id
(int)(Required)The ID of the object to which the terms will be added.
- $terms
(string|int|array)(Required)The slug(s) or ID(s) of the term(s) to add.
- $taxonomy
(array|string)(Required)Taxonomy name.
Return
(array|WP_Error) Term taxonomy IDs of the affected terms.
Source
File: wp-includes/taxonomy.php
function wp_add_object_terms( $object_id, $terms, $taxonomy ) {
return wp_set_object_terms( $object_id, $terms, $taxonomy, true );
}
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| 3.6.0 | Introduced. |