Функция позволяет вывести настраиваемый список ссылок на категории, к которым относится указанная (или текущая) запись на блоге.
the_category( $separator, $parents, $post_id ); |
$separator
(строка) (необязательное) разделитель рубрик, можно указать любой символ или HTML-тег, по умолчанию ссылки выводятся в виде маркированного списка, то есть, если:
the_category(); |
тогда:
Обычно вместо этого параметра используются HTML-сущности, рассмотрим два самых популярных варианта:
the_category(' • '); |
В итоге список рубрик со ссылками примет следующий вид:
Ещё один популярный вариант, очень часто встречается в хлебных крошках:
the_category(' » '); |
$parents
(строка) (необязательное) способ отображения ссылок при наличии родительских рубрик. Для того, чтобы было понятно, предположим, что имеется следующая иерархия рубрик (галочками отмечены категории, в которых находится пост).
-
multiple — родительские рубрики будут включены в список в виде отдельных ссылок в любом случае, даже если пост не находится в них непосредственно, сразу пример:
the_category(', ', 'multiple'); // в качестве разделителя взяли запятую с пробелом
Для наглядности я обвел родительские и дочерние рубрики, замечаете, что у нас появилось две одинаковых ссылки?
-
single — в этом случае родительские рубрики добавляются в текст (анкор) ссылки дочерней категории, в которой и находится пост, пример:
the_category(', ', 'single');
Обратите внимание на подчеркивание, в этом случае имеем только три ссылки:
- по умолчанию параметр равен пустой строке — тогда родительские рубрики никак не отображаются в списке.
the_category(', ', '');
$post_id
(целое число) (необязательное) — ID поста, категории которого нужно вывести, по умолчанию глобальная переменная $post->ID
(начиная с версии 2.5)
the_category(' • ', '', 535); |
О том, как узнать ID поста, читайте здесь.
Источник: misha.blog