wp_get_post_categories

Получает список категорий (рубрик) поста (записи) в виде массива.

Функция является оберткой для функции wp_get_object_terms() и создана для тех, кто плохо разбирается в понятии “таксономии WordPress”, но понимает что такое рубрики, что по сути является одним и тем же.

✈ 1 раз = 0.00111с = очень медленно | 50000 раз = 43.9с = очень медленно

Хуков нет.

Возвращает

Массив данных рубрик. По умолчанию массив содержащий ID категорий.

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

wp_get_post_categories( $post_id, $args );
$post_id(число) (обязательный)
ID поста, рубрики которого нужно получить.
$args(массив)
Аргументы получения рубрик.
По умолчанию: array(‘fields’ => ‘ids’);

Аргументы параметра $args

orderby(строка)

По какому критерию сортировать результат. Может быть:

  • count – по количеству записей;

  • name – по имени. По умолчанию;

  • slug – по слагу;

  • none – выводить без сортировки.
    По умолчанию: ‘name’
order(строка)
Направление сортировки. ASC — по порядку, DESC — в обратном порядке.
По умолчанию: ‘ASC’
fields(строка)

Какие поля включать в результирующий массив. Может быть:

  • all – в результате мы получи массив объектов со всей информацией о каждом термине;
  • all_with_object_id – тоже что и all, плюс еще и ID терминов;
  • ids – получить только ID терминов;
  • names – получить только имена терминов.
    По умолчанию: ‘all’

Примеры

#1 Демонстрация работы функции

Пример показывает, какой результат выводит базовое использование wp_get_post_categories():

<?php
function wp_get_post_categories( $post_id = 0, $args = array() ) {
	$post_id = (int) $post_id;

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

	$cats = wp_get_object_terms($post_id, 'category', $args);
	return $cats;
}

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


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

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