wp_get_post_terms() WP 2.8

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

Для этой функции по умолчанию в $args устанавливается параметр 'field=all' (получить все поля термина). Другие значения этого аргумента: names (получать только названия терминов) и ids (только ID терминов ).

Хуков нет.

Возвращает

Массив/WP_Error.

• Массив объектов (список терминов), когда удалось получить.
• Пустой массив, когда терминов у записи нет.
• WP_Error, если указанной таксономии нет.

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

wp_get_post_terms( $post_id, $taxonomy, $args );

$post_id(число)

ID поста.

$taxonomy(строка/массив)

Название таксономии термины которой будут получены.
По умолчанию: "post_tag"

$args(массив)

Массив аргументов. Переписывает аргументы по умолчанию.

С версии WP 4.7, можно указывать все параметры функции get_terms(). До 4.7. список параметров смотрите в описании wp_get_object_terms()

По умолчанию: array('orderby' => 'name', 'order' => 'ASC', 'fields' => 'all')

Примеры

#1. Получим метки поста 2647. Будут получены все поля меток:

$term_list = wp_get_post_terms( 2647, 'post_tag', array("fields" => "all") );

$term_list будет содержать подобные данные:

Array
(
	[0] => stdClass Object
		(
			[term_id] => 44
			[name] => Новичкам
			[slug] => for_newbie
			[term_group] => 0
			[term_taxonomy_id] => 44
			[taxonomy] => post_tag
			[description] => 
			[parent] => 0
			[count] => 7
		)

	[1] => stdClass Object
		(
			[term_id] => 48
			[name] => Теория
			[slug] => teoriya
			[term_group] => 0
			[term_taxonomy_id] => 49
			[taxonomy] => post_tag
			[description] => 
			[parent] => 0
			[count] => 5
		)

	[2] => stdClass Object
		(
			[term_id] => 12
			[name] => Хаки
			[slug] => haki
			[term_group] => 0
			[term_taxonomy_id] => 12
			[taxonomy] => post_tag
			[description] => 
			[parent] => 0
			[count] => 10
		)

)

#2. Тоже самое, что в примере выше, но теперь получим только поля name:

$term_list = wp_get_post_terms(2647, 'post_tag', array("fields" => "names"));

/*
В итоге получим:
Array
(
	[0] => Новичкам
	[1] => Теория
	[2] => Хаки
)
*/

#3. Тоже самое, что в примере выше, но теперь получим только поля ids:

$term_list = wp_get_post_terms(2647, 'post_tag', array("fields" => "ids"));

/*
В итоге получим:
Array
(
	[0] => 44
	[1] => 48
	[2] => 12
)
*/

Код wp_get_post_terms: wp-includes/post.php ^{VER 4.9.8}

<?php
function wp_get_post_terms( $post_id = 0, $taxonomy = 'post_tag', $args = array() ) {
	$post_id = (int) $post_id;

	$defaults = array('fields' => 'all');
	$args = wp_parse_args( $args, $defaults );

	$tags = wp_get_object_terms($post_id, $taxonomy, $args);

	return $tags;
}

Cвязанные функции

Из раздела: Для записей