Функция the_category() используется для вывода списка категорий, к которым относится пост, в виде HTML-списка или с помощью заданного формата. Это удобно для отображения рубрик на странице записи.
the_category( string $separator = '', string $parents = '', int $post_id = false )
Параметры
- $separator(необязательный)
Разделитель между ссылками на категории. Если передано пустое значение, категории будут выводиться в виде маркированного списка<ul>.- Тип данных:
string - По умолчанию:
''(пустая строка)
- Тип данных:
- $parents(необязательный)
Как отображать родительские категории.- Тип данных:
string - Допустимые значения:
'multiple'— Выводит отдельные ссылки на родительскую и дочернюю категории, показывая их структуру (например, «родитель/дочерняя»).'single'— Выводит одну ссылку на дочернюю категорию, но с текстом, отражающим всю иерархию категорий (например, «родитель/дочерняя»).
- По умолчанию:
''(категории выводятся без учета родительской структуры)
- Тип данных:
- $post_id(необязательный)
ID поста, категории которого нужно вывести. Если не указано, по умолчанию используется текущий пост в цикле WordPress.- Тип данных:
int - По умолчанию:
false
- Тип данных:
Возвращаемое значение
Функция возвращает null, но выводит HTML-код со списком ссылок на категории.
Пример 1: Список категорий поста, разделённых запятой
Выведем категории текущего поста, разделяя их запятой:
<p>Категории: <?php the_category(', '); ?></p>
Результат:
Категории: Animals, Nature, Photography
Пример 2: Категории с разделителем в виде стрелки
Чтобы разделить категории стрелкой (>), используем следующий код:
<p>Категории: <?php the_category(' > '); ?></p>
Результат:
Категории: Wildlife > Landscapes > Nature
Пример 3: Отображение иерархии родительских категорий
Если нужно показать родительскую и дочернюю категорию с отдельными ссылками на каждую, используйте параметр 'multiple':
<?php the_category(' > ', 'multiple'); ?>
Предположим, пост относится к категории «Художественная литература», которая является дочерней категорией категории «Литература»:
Результат:
Литература > Художественная литература
(с отдельными ссылками на каждую категорию)
Пример 4: Отображение только дочерней категории с указанием иерархии
Чтобы вывести только дочернюю категорию с указанием родительской структуры в виде текста, используем параметр 'single':
<?php the_category(' > ', 'single'); ?>Предположим, пост находится в категории «Стихи», которая является дочерней категории «Поэты»:
Результат:
Поэты > Стихи
(ссылка ведёт на «Стихи», но показывает иерархию «Поэты > Стихи»)
Пример 5: Категории в виде списка
Если передать пустую строку в параметр $separator, категории выведутся в виде списка <ul>:
<ul><?php the_category(''); ?></ul>
Результат:
<ul>
<li><a href="...">Новости</a></li>
<li><a href="...">Политика</a></li>
<li><a href="...">Экономика</a></li>
</ul>
Заключение
Функция the_category() является мощным инструментом для вывода категорий, к которым относится пост. Используя различные параметры, можно гибко управлять выводом категорий, добавляя разделители, отображая родительские категории или форматируя вывод в виде списка.