the_category() — выводит ссылки на все рубрики, в которых находится пост

Функция позволяет вывести настраиваемый список ссылок на категории, к которым относится указанная (или текущая) запись на блоге.

the_category( $separator, $parents, $post_id );

$separator
(строка) (необязательное) разделитель рубрик, можно указать любой символ или HTML-тег, по умолчанию ссылки выводятся в виде маркированного списка, то есть, если:

the_category();

тогда:

рубрики в виде маркированного списка

Обычно вместо этого параметра используются HTML-сущности, рассмотрим два самых популярных варианта:

the_category(' • ');

В итоге список рубрик со ссылками примет следующий вид:

список рубрик, разделенных точкой

Ещё один популярный вариант, очень часто встречается в хлебных крошках:

the_category(' » ');
список рубрик, разделенных закрывающей кавычкой

$parents
(строка) (необязательное) способ отображения ссылок при наличии родительских рубрик. Для того, чтобы было понятно, предположим, что имеется следующая иерархия рубрик (галочками отмечены категории, в которых находится пост).

рубрики на странице редактирования поста
  • multiple — родительские рубрики будут включены в список в виде отдельных ссылок в любом случае, даже если пост не находится в них непосредственно, сразу пример:
    the_category(', ', 'multiple'); // в качестве разделителя взяли запятую с пробелом

    Для наглядности я обвел родительские и дочерние рубрики, замечаете, что у нас появилось две одинаковых ссылки?

    список рубрик при $parents = multiple
  • single — в этом случае родительские рубрики добавляются в текст (анкор) ссылки дочерней категории, в которой и находится пост, пример:
    the_category(', ', 'single');

    Обратите внимание на подчеркивание, в этом случае имеем только три ссылки:

    список рубрик при $parents = single
  • по умолчанию параметр равен пустой строке — тогда родительские рубрики никак не отображаются в списке.
    the_category(', ', '');
    список рубрик при $parents равному пустой строке

$post_id
(целое число) (необязательное) — ID поста, категории которого нужно вывести, по умолчанию глобальная переменная $post->ID (начиная с версии 2.5)

the_category(' • ', '', 535);

О том, как узнать ID поста, читайте здесь.

Миша Рудрастых Разработчик WordPress WooCommerce

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

Впервые познакомился с WordPress в 2009 году, и после двух лет мучений с Joomla и самописными движками это был просто бальзам на душу. С 2014 года меня можно встретить на WordCamp — официальной конфе по WP в Москве, иногда там выступаю. Также в настоящее время веду курсы по WordPress в Epic Skills в Питере.