is_object_in_term

Определяет связан ли указанный объект с любым из указанных элементов таксономии (термином). Можно указать конкретный термин(ы) для проверки связи.

Указанные термины сравниваются с ID, названием и слагом терминов объекта. Если передать термины как числа, то сравнение будет только с ID терминов объекта. Если не указать термин, то функция проверит есть ли у объекта хоть один термин из указанной таксономии.

✈ 1 раз = 0.000809с = медленно | 50000 раз = 1.16с = быстро PHP 7.0.8, WP 4.6.1

Хуков нет.

Возвращает

true, если объект относится к термин или false. Объект WP_Error, если произошла ошибка.

Использование

if( is_object_in_term( $object_id, $taxonomy, $terms ) ){
	...
}
$object_id(число) (обязательный)
ID поста, связь которого с термином нужно проверить.
$taxonomy(строка) (обязательный)
Название таксономии, к которой принадлежит термин из параметра $terms.
$terms(строка/массив/число)
ID, название или слаг термина. Можно указать несколько терминов в массиве.
По умолчанию: null

Примеры

#1 Проверка наличия терминов у объекта

Проверим, находится ли текущий пост ($post->ID) в термине “Языки” (yaziki или ID=5), таксономии ‘my_taxonomy’:

<?php
function is_object_in_term( $object_id, $taxonomy, $terms = null ) {
	if ( !$object_id = (int) $object_id )
		return new WP_Error( 'invalid_object', __( 'Invalid object ID' ) );

	$object_terms = get_object_term_cache( $object_id, $taxonomy );
	if ( false === $object_terms ) {
		$object_terms = wp_get_object_terms( $object_id, $taxonomy, array( 'update_term_meta_cache' => false ) );
		if ( is_wp_error( $object_terms ) ) {
			return $object_terms;
		}

		wp_cache_set( $object_id, wp_list_pluck( $object_terms, 'term_id' ), "{$taxonomy}_relationships" );
	}

	if ( is_wp_error( $object_terms ) )
		return $object_terms;
	if ( empty( $object_terms ) )
		return false;
	if ( empty( $terms ) )
		return ( !empty( $object_terms ) );

	$terms = (array) $terms;

	if ( $ints = array_filter( $terms, 'is_int' ) )
		$strs = array_diff( $terms, $ints );
	else
		$strs =& $terms;

	foreach ( $object_terms as $object_term ) {
		// If term is an int, check against term_ids only.
		if ( $ints && in_array( $object_term->term_id, $ints ) ) {
			return true;
		}

		if ( $strs ) {
			// Only check numeric strings against term_id, to avoid false matches due to type juggling.
			$numeric_strs = array_map( 'intval', array_filter( $strs, 'is_numeric' ) );
			if ( in_array( $object_term->term_id, $numeric_strs, true ) ) {
				return true;
			}

			if ( in_array( $object_term->name, $strs ) ) return true;
			if ( in_array( $object_term->slug, $strs ) ) return true;
		}
	}

	return false;
}

Комментарии:


Оставить комментарий

Your email address will not be published. Required fields are marked *