update_object_term_cache( string|int[] $object_ids, string|string[] $object_type ): void|false

Description

Parameters

$object_idsstring|int[]

Comma-separated list or array of term object IDs.

$object_typestring|string[]

The taxonomy object type or array of the same.

Return

void|false

Void on success or if the $object_ids parameter is empty, false if all of the terms in $object_ids are already cached.

Uses · 4

• get_object_taxonomies()Returns the names or objects of the taxonomies which are registered for the requested object or object type, such as a post object or post type name.
• wp_cache_get_multiple()Retrieves multiple values from the cache in one call.
• wp_get_object_terms()Retrieves the terms associated with the given object(s), in the supplied taxonomies.
• wp_cache_add_multiple()Adds multiple values to the cache in one call, if the cache keys don't already exist.

Used by · 2

• _prime_post_caches()Adds any posts from the given IDs to the cache that do not already exist in cache.
• update_post_caches()Updates post, term, and metadata caches for a list of post objects.

Source

View on Trac ↗View on GitHub ↗

3864function update_object_term_cache( $object_ids, $object_type ) {3865	if ( empty( $object_ids ) ) {3866		return;3867	}3868 3869	if ( ! is_array( $object_ids ) ) {3870		$object_ids = explode( ',', $object_ids );3871	}3872 3873	$object_ids     = array_map( 'intval', $object_ids );3874	$non_cached_ids = array();3875 3876	$taxonomies = get_object_taxonomies( $object_type );3877 3878	foreach ( $taxonomies as $taxonomy ) {3879		$cache_values = wp_cache_get_multiple( (array) $object_ids, "{$taxonomy}_relationships" );3880 3881		foreach ( $cache_values as $id => $value ) {3882			if ( false === $value ) {3883				$non_cached_ids[] = $id;3884			}3885		}3886	}3887 3888	if ( empty( $non_cached_ids ) ) {3889		return false;3890	}3891 3892	$non_cached_ids = array_unique( $non_cached_ids );3893 3894	$terms = wp_get_object_terms(3895		$non_cached_ids,3896		$taxonomies,3897		array(3898			'fields'                 => 'all_with_object_id',3899			'orderby'                => 'name',3900			'update_term_meta_cache' => false,3901		)3902	);3903 3904	$object_terms = array();3905	foreach ( (array) $terms as $term ) {3906		$object_terms[ $term->object_id ][ $term->taxonomy ][] = $term->term_id;3907	}3908 3909	foreach ( $non_cached_ids as $id ) {3910		foreach ( $taxonomies as $taxonomy ) {3911			if ( ! isset( $object_terms[ $id ][ $taxonomy ] ) ) {3912				if ( ! isset( $object_terms[ $id ] ) ) {3913					$object_terms[ $id ] = array();3914				}3915				$object_terms[ $id ][ $taxonomy ] = array();3916			}3917		}3918	}3919 3920	$cache_values = array();3921	foreach ( $object_terms as $id => $value ) {3922		foreach ( $value as $taxonomy => $terms ) {3923			$cache_values[ $taxonomy ][ $id ] = $terms;3924		}3925	}3926	foreach ( $cache_values as $taxonomy => $data ) {3927		wp_cache_add_multiple( $data, "{$taxonomy}_relationships" );3928	}3929}

History

Introduced in 2.3.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-includes/taxonomy.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.