the_category()
Выводит ссылки на рубрики, к которым принадлежит пост в виде HTML li списка или в произвольном формате.
Функцию нужно использовать внутри Цикла WordPress или использовать параметр post_id (см. описание).
Работает на основе: get_the_category_list()
1 раз — 0.006019 сек (очень медленно) | 50000 раз — 16.46 сек (медленно) | PHP 7.1.2, WP 4.7.3
Хуков нет.
Возвращает
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>
#2 Используем второй параметр
Пусть, пост находится в категории "Пушкин", которая является дочерней категорией категории "Поэты", тогда:
<?php the_category(' > ', 'multiple'); ?>
#3 А если во втором параметре написать 'single'
<?php the_category(' > ', 'single'); ?>
Получим: Поэты > Пушкин (ссылка будет вести на категорию "Пушкин")
Список изменений
| С версии 0.71 | Введена. |
Код the_category() the category WP 6.1.1
function the_category( $separator = '', $parents = '', $post_id = false ) {
echo get_the_category_list( $separator, $parents, $post_id );
}