the_category() WP 0.71

Выводит ссылки на рубрики, к которым принадлежит пост в виде HTML li списка или в произвольном формате.

Функцию нужно использовать внутри Цикла WordPress или использовать параметр post_id (см. описание).

Хуков нет.

Возвращает

null. HTML код ссылок на категорию(и).

Использование

<?php the_category( $separator, $parents, $post_id ); ?>

$separator(строка)

Разделитель между ссылками.
По умолчанию: '' - выведет ссылки в списке <ul>

$parents(строка)

Как показывать ссылки, если текущая категория является дочерней. Может принимать:

• multiple - показывать отдельно ссылки на родительскую и дочернюю категории, сохраняя порядок (родитель/предок);

• single - показать одну ссылку, на категорию в которой находится пост, но текстом ссылки станет вся структура вложенности поста в категории (родитель/предок).

По умолчанию: '' - просто выводятся категории, к которым принадлежит пост (никакая связь не учитывается)

$post_id(число)

ID поста, категории которого нужно вывести.
По умолчанию: false - текущий пост ($post->ID)

Примеры

#1 Список категорий поста разделенных запятой:

<p>Категории: <?php the_category(', '); ?></p>

Получим: Категории: WordPress, Computers, Blogging

#2 Используем второй параметр

Пусть, пост находится в категории "Пушкин", которая является дочерней категорией категории "Поэты", тогда:

<?php the_category(' > ', 'multiple'); ?>

Выведет: Поэты > Пушкин

#3 А если во втором параметре написать 'single'

<?php the_category(' > ', 'single'); ?>

Получим: Поэты > Пушкин (ссылка будет вести на категорию "Пушкин")

Список изменений

Код the_category() the category ^{WP 5.8.2}

function the_category( $separator = '', $parents = '', $post_id = false ) {
	echo get_the_category_list( $separator, $parents, $post_id );
}

Cвязанные функции

Для записей

Записи: посты, страницы, ...