the_category( $separator = '', $parents = '', $post_id = false )
Параметры
- $separator
- (строка) разделитель рубрик, можно указать любой символ или HTML-тег, по умолчанию ссылки выводятся в виде маркированного списка. Подробнее в примере 1, примере 2 и примере 3.
- $parents
- (строка) Может принимать три значения:
multiple
– родительские рубрики будут включены в список в виде отдельных ссылок в любом случае, даже если пост не находится в них непосредственно, смотрите пример 4.single
– в этом случае родительские рубрики добавляются в текст ссылки дочерней категории, в которой и находится пост, смотрите пример 4.- пустое значение (по умолчанию) – родительские рубрики никак не отображаются в списке.
- $post_id
- (целое число) ID поста, категории которого нужно вывести, по умолчанию глобальная переменная
$post->ID
(параметр доступен с версии 2.5)
Пример 1. Стандартное использование функции
Если не указывать в качестве первого параметра функции ничего, то она будет выводить ссылки на рубрики в виде маркированного списка.
the_category();
Результат:
Пример 2. Используем буллеты (точки) в качестве разделителей рубрик
Более часто в темах WordPress встречалась подобная запись функции:
the_category( ' • ' );
В этом случае результат будет примерно таким (но понятно, что всё зависит от CSS-стилей вашей темы WordPress).
Пример 3. Разделяем рубрики стрелками
Ещё один популярный вариант, очень часто встречается в хлебных крошках:
the_category( ' » ' );
Пример 4. Способы отображения ссылок при наличии родительских рубрик. Параметр $parents
Давайте предположим, что у нашей записи подобная структура рубрик:
Если мы используем $parents=multiple
:
the_category( ', ', 'multiple' ); // в качестве разделителя взяли запятую с пробелом
Результат:
Для наглядности я обвел родительские и дочерние рубрики, замечаете, что у нас появилось две одинаковых ссылки?
Если $parents=single
:
the_category( ', ', 'single' );
Если же ничего не указывать:
the_category( ', ', '' );