wp_get_post_categories() — как получить все категории поста

Функция возвращает список всех рубрик, присвоенных к конкретному посту. Если записи с указанным в параметрах ID не существует, возвращает пустой массив.

wp_get_post_categories( $post_id = 0, $args = array() )
$post_id
(целое число) ID поста
$args
(массив) дополнительные параметры вывода
orderby
сортировка результатов, может принимать значения:
  • name — по названию рубрики (параметр установлен по умолчанию),
  • count — по количеству записей в рубрике,
  • slug — по ярлыку рубрики,
  • term_group — по значению поля term_group,
  • term_order — по значению поля term_order, обычно оно используется для установления собственного порядка рубрик вручную в админке,
  • term_id — по ID рубрики;
ORDER
направление сортировки:
  • ASC — по возврастанию (параметр установлен по умолчанию),
  • DESC — по убыванию;
fields
определяет вид возвращаемых результатов:
  • all — возвращает массив объектов, содержащих всю информацию о рубриках, более подробно про объекты рубрик написано здесь,
  • all_with_object_id — такой же массив объектов, но только с добавлением значения object_id,
  • ids — нумерованный массив, состоящий из ID рубрик (по умолчанию),
  • names — нумерованный массив, состоящий из названий рубрик,
  • slugs — нумерованный массив, состоящий из ярлыков рубрик;

Примеры

В качестве примера давайте выведем список всех рубрик поста через запятую, со ссылками разумеется. Получить ссылку на страницу архива категории нам поможет функция get_category_link(). Итак:

$post_cats = wp_get_post_categories( 1, array('fields' => 'all') ); // предположим, что ID поста = 1
$cats = '';
foreach($post_cats as $post_cat){
    $cats .= '<a href="' . get_category_link( $post_cat ) . '">' . $post_cat->name . '</a>, ';
}
echo rtrim($cats, ', ');

А теперь давайте посмотрим на содержимое массива объектов, который возвращается функцией в случае установки параметра fields равным all:

$post_cats = wp_get_post_categories( 1, array('fields' => 'all') );
print_r( $post_cats );

Источник: misha.blog

Миша Рудрастых

Путешествует по миру и рассказывает всем о WordPress лично, у себя в блогах и на курсах в Санкт-Петербурге. Умеет просто объяснять сложные вещи, делает это красиво. Организовывает неплохие WordCamp's, но совсем не умеет слушать чужие доклады.

Добавить комментарий

%d такие блоггеры, как: