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=single:

the_category( ', ', 'single' );

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

the_category( ', ', '' );

Миша

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

Если вам нужна помощь с сайтом или разработка с нуля на WordPress / WooCommerce — пишите. Я и моя команда будем рады вам помочь!