_prime_term_caches() │ WP 4.6.0

Adds any terms from the given IDs to the cache that do not already exist in cache.

Internal function — this function is designed to be used by the kernel itself. It is not recommended to use this function in your code.

No Hooks.

Returns

null. Nothing (null).

Usage

_prime_term_caches( $term_ids, $update_meta_cache );

$term_ids(array) (required): Array of term IDs.
$update_meta_cache(true|false): Whether to update the meta cache.
Default: true

Notes

Global. wpdb. $wpdb WordPress database abstraction object.

Changelog

Since 4.6.0	Introduced.
Since 6.1.0	This function is no longer marked as "private".
Since 6.3.0	Use wp_lazyload_term_meta() for lazy-loading of term meta.

`_prime_term_caches() prime term caches` code ^{WP 6.9.1}

wp-includes/taxonomy.php

function _prime_term_caches( $term_ids, $update_meta_cache = true ) {
	global $wpdb;

	$non_cached_ids = _get_non_cached_ids( $term_ids, 'terms' );
	if ( ! empty( $non_cached_ids ) ) {
		$fresh_terms = $wpdb->get_results( sprintf( "SELECT t.*, tt.* FROM $wpdb->terms AS t INNER JOIN $wpdb->term_taxonomy AS tt ON t.term_id = tt.term_id WHERE t.term_id IN (%s)", implode( ',', array_map( 'intval', $non_cached_ids ) ) ) );

		update_term_cache( $fresh_terms );
	}

	if ( $update_meta_cache ) {
		wp_lazyload_term_meta( $term_ids );
	}
}