clean_object_term_cache() WordPress Function
The clean_object_term_cache() function is used to clean the cache for a given object and its terms. This function is called automatically when an object is updated or deleted, so it is not necessary to call it directly.
clean_object_term_cache( int|array $object_ids, array|string $object_type ) #
Removes the taxonomy relationship to terms from the cache.
Description
Will remove the entire taxonomy relationship containing term $object_id
. The term IDs have to exist within the taxonomy $object_type
for the deletion to take place.
See also
- get_object_taxonomies(): for more on $object_type.
Parameters
- $object_ids
(int|array)(Required)Single or list of term object ID(s).
- $object_type
(array|string)(Required)The taxonomy object type.
Source
File: wp-includes/taxonomy.php
function clean_object_term_cache( $object_ids, $object_type ) { global $_wp_suspend_cache_invalidation; if ( ! empty( $_wp_suspend_cache_invalidation ) ) { return; } if ( ! is_array( $object_ids ) ) { $object_ids = array( $object_ids ); } $taxonomies = get_object_taxonomies( $object_type ); foreach ( $taxonomies as $taxonomy ) { wp_cache_delete_multiple( $object_ids, "{$taxonomy}_relationships" ); } wp_cache_delete( 'last_changed', 'terms' ); /** * Fires after the object term cache has been cleaned. * * @since 2.5.0 * * @param array $object_ids An array of object IDs. * @param string $object_type Object type. */ do_action( 'clean_object_term_cache', $object_ids, $object_type ); }
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
Version | Description |
---|---|
2.3.0 | Introduced. |