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

Владислав Белецкий
Владислав Белецкий .
Категория:
Комментариев: 0

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( ', ', '' );
Подписаться
Уведомить о
guest
0 комментариев
Межтекстовые Отзывы
Посмотреть все комментарии