get_objects_in_term() │ WP 2.3.0

Получает ID объектов (обычно это записи), которые относятся к указанному элементу, указанной таксономии.

Параметр $taxonomies обязательный. Если указанная тут таксономия не найдена, функция вернет WP_Error объект, который можно обработать и получить сообщение об ошибке... Все это чем-то похоже на Исключения в PHP (Exceptions).

Параметр $term_ids, проверяется иначе, чем $taxonomies - нет проверки наличия термина и если его нет в БД, то он просто пропускается (не учитывается).

Функция не кэширует запрос. Запрос получается прямой к базе данных и точечный - т.е. получает только ID объектов.

Функция получает ID записей, только из указанных элементов таксономий - вложенность не учитывается. Т.е. если у рубрики 5 есть под-рубрики 6 и 7, а мы указали только 5, то будут получены ID постов только из 5.

1 раз — 0.000449 сек (быстро) | 50000 раз — 13.14 сек (медленно) | PHP 7.1.2, WP 4.7.5

Хуков нет.

Возвращает

Строку[]|WP_Error.

  • WP_Error, если хоть одной из указанных таксономий не существует.
  • Пустой массив, когда нет найдено ни одного объекта у указанной таксономии и терминов.
  • Массив с ID найденных терминов.

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

get_objects_in_term( $term_ids, $taxonomies, $args = array() );
$term_ids(число/массив) (обязательный)
ID элемента таксономии (термина) или массив из нескольких ID.
$taxonomies(строка/массив) (обязательный)
Название таксономии или массив из названий нескольких таксономий.
Если, хоть одной из указанных тут таксономий не существует. Функция вернет WP_Error...
$args(массив/строка)
Параметры запроса. Пока можно указать только один параметр - order. Он отвечает за направление сортировки и может быть: ASC или DESC. Сортировка происходит по колонке object_ids, т.е. по ID терминов.
По умолчанию: array()

Примеры

0

#1 Получим ID всех записей (постов) из рубрики

Здесь мы получаем ID постов из рубрики 33:

$post_ids = get_objects_in_term( 33, 'category' );

print_r( $post_ids );
/*
Array (
	[0] => 72
	[1] => 372
	[2] => 800
)
*/
0

#2 Получим ID всех записей из нескольких таксономий и их элементов

Здесь 33 это элемент таксы 'category', а 12 элемент таксы 'post_tag':

$objects = get_objects_in_term( array(33,12) , array('category','post_tag') );

print_r( $objects );
/*
Array (
	[0] => 72
	[1] => 372
	[2] => 800
	[3] => 2818
	[4] => 2971
	[5] => 3755
)
*/
0

#3 Проверка возвращаемого значения 

$objects = get_objects_in_term( array(33,12) , array('category','post_tag') );

if( is_wp_error($objects) ){
	echo 'Таксономия указана неверно';
}
elseif( ! $objects ){
	echo 'Нет объектов';
}
else {
	echo 'есть объекты!';
	print_r( $objects );
}
0

#4 Список всех тегов (меток) записей из указанной рубрики

Отличный и сложный пример, который работает на основе этой функции описан в статье http://dimox.name/wordpress-get-all-tags-from-category/

Этот пример показывает, как с наименьшими ресурсозатратами получить список всех меток записей, которые находятся в указанной рубрике (в данном случае в текущей рубрике).

// страница рубрики
if( is_category() ){

	$term_id = get_queried_object_id(); // id текущей рубрики

	// соберем ID всех вложенных рубрик
	$term_ids = get_term_children( $term_id, 'category' );
	array_push( $term_ids, $term_id );

	$post_ids = get_objects_in_term( $term_ids, 'category' );

	if ( $post_ids && ! is_wp_error($post_ids) ) {

		$tags = wp_get_object_terms( $post_ids, 'post_tag' );

		if ( ! empty($tags) && ! is_wp_error($tags) ){  
			$list = array();
			foreach( $tags as $tag ){
				$list[] = '<a href="'. get_term_link( $tag, 'post_tag') .'">'. esc_html( $tag->name ) .'</a>';
			}

			echo '
			<ul>
				<li>'. implode( "</li>\n<li>", $list ) .'</li>
			</ul>
			';
		}
	}

}

Заметки

  • Global. wpdb. $wpdb WordPress database abstraction object.

Список изменений

С версии 2.3.0 Введена.

Код get_objects_in_term() WP 6.5.2

wp-includes/taxonomy.php 
function get_objects_in_term( $term_ids, $taxonomies, $args = array() ) {
	global $wpdb;

	if ( ! is_array( $term_ids ) ) {
		$term_ids = array( $term_ids );
	}
	if ( ! is_array( $taxonomies ) ) {
		$taxonomies = array( $taxonomies );
	}
	foreach ( (array) $taxonomies as $taxonomy ) {
		if ( ! taxonomy_exists( $taxonomy ) ) {
			return new WP_Error( 'invalid_taxonomy', __( 'Invalid taxonomy.' ) );
		}
	}

	$defaults = array( 'order' => 'ASC' );
	$args     = wp_parse_args( $args, $defaults );

	$order = ( 'desc' === strtolower( $args['order'] ) ) ? 'DESC' : 'ASC';

	$term_ids = array_map( 'intval', $term_ids );

	$taxonomies = "'" . implode( "', '", array_map( 'esc_sql', $taxonomies ) ) . "'";
	$term_ids   = "'" . implode( "', '", $term_ids ) . "'";

	$sql = "SELECT tr.object_id FROM $wpdb->term_relationships AS tr INNER JOIN $wpdb->term_taxonomy AS tt ON tr.term_taxonomy_id = tt.term_taxonomy_id WHERE tt.taxonomy IN ($taxonomies) AND tt.term_id IN ($term_ids) ORDER BY tr.object_id $order";

	$last_changed = wp_cache_get_last_changed( 'terms' );
	$cache_key    = 'get_objects_in_term:' . md5( $sql ) . ":$last_changed";
	$cache        = wp_cache_get( $cache_key, 'term-queries' );
	if ( false === $cache ) {
		$object_ids = $wpdb->get_col( $sql );
		wp_cache_set( $cache_key, $object_ids, 'term-queries' );
	} else {
		$object_ids = (array) $cache;
	}

	if ( ! $object_ids ) {
		return array();
	}
	return $object_ids;
}

Для записей