the_category() │ WP 0.71

Виводить посилання на рубрики, до яких належить пост у вигляді 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)

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

Отримаємо: Категорії: Blogging

Нехай пост знаходиться в категорії “Пушкін”, яка є дочірньою категорією категорії “Поети”, тоді:

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

Виведе: Пушкін

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

Отримаємо: Поети > Пушкін (посилання вестиме на категорію “Пушкін”)

З версії 0.71

Введено.

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