the_category с версии 0.71

Описание

Выводит ссылки на рубрики к которым принадлежит пост.

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

the_category() работает на базе get_the_category_list().

Функция возвращает HTML код ссылок на категорию(и).

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

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

Параметры

$separator (строка)

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

$parents (строка)

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

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

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

$post_id (число)

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

Примеры

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

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

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

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

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

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

2.1. А если во втором параметре написать 'single':

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

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

На заметку

• Параметр post_id добавлен в версии 2.5.

the_category()

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

Ещё из раздела

Смотрите также: Функции WordPress и Теги Шаблона.