set_object_terms

Fires after an object's terms have been set.

Description

do_action( 'set_object_terms', (int) $object_id, (array) $terms, (array) $tt_ids, (string) $taxonomy, (bool) $append, (array) $old_tt_ids ); 

Parameters (6)

0. $object_id (int)
The object id.
1. $terms (array)
An array of object terms.
2. $tt_ids (array)
An array of term taxonomy IDs.
3. $taxonomy (string)
Taxonomy slug.
4. $append (bool)
Whether to append new terms to the old terms.
5. $old_tt_ids (array)
Old array of term taxonomy IDs.

Usage

To run the hook, copy the example below.
  1. // run the action 
  2. do_action( 'set_object_terms', $object_id, $terms, $tt_ids, $taxonomy, $append, $old_tt_ids ); 
The following example is for adding a hook callback.
  1. // define the set_object_terms callback 
  2. function action_set_object_terms( $object_id, $terms, $tt_ids, $taxonomy, $append, $old_tt_ids ) { 
  3. // make action magic happen here... 
  4. }; 
  5.  
  6. // add the action 
  7. add_action( 'set_object_terms', 'action_set_object_terms', 10, 6 ); 
To remove a hook callback, use the example below.
  1. // remove the action 
  2. remove_action( 'set_object_terms', 'action_set_object_terms', 10, 6 ); 

Defined (1)

The action is defined in the following location(s).

/wp-includes/taxonomy.php  
  1. do_action( 'set_object_terms', $object_id, $terms, $tt_ids, $taxonomy, $append, $old_tt_ids );