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

the_category( $separator = '', $parents = '', $post_id = false )

Если в функцию не передать параметр $post_id, то она будет выводить рубрики текущего поста внутри цикла WordPress.

Параметры

$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 = multiple

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

Если $parents=single:

the_category( ', ', 'single' );
список рубрик при $parents = single

Если же ничего не указывать:

the_category( ', ', '' );
список рубрик при $parents равному пустой строке

Миша

Впервые познакомился с WordPress в 2009 году. Организатор и спикер на конференциях WordCamp. Преподаватель в школе Нетология.

Пишите, если нужна помощь с сайтом или разработка с нуля.

Комментарии — 2

Чтобы оставить комментарий, пожалуйста, зарегистрируйтесь или войдите.

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

Полезности из мира WordPress и жизни студии.

Мой телеграм-канал