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()

Приклади

#1 Отримаємо ID всіх записів (постів) із рубрики

Тут ми отримуємо ID постів із рубрики 33:

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

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

#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
)
*/

#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);
}

#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() get objects in term` ^{WP 6.0.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) ) 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, 'terms');
	if ( false === $cache ) {
		$object_ids = $wpdb->get_col( $sql );
		wp_cache_set($cache_key, $object_ids, 'terms');
	} else {
		$object_ids = (array) $cache;
	}

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