THE_CATEGORY() │ WP 0.71

Функция the_category() выводит ссылки на категории, к которым принадлежит запись. Вывод может быть в виде HTML-списка или в другом формате, который вы можете настроить.

Эту функцию обычно используют внутри цикла WordPress, однако можно передать параметр $post_id, если необходимо вывести категории для конкретной записи.

Важные характеристики

• Функция работает с помощью get_the_category_list().
• Время выполнения при вызове один раз: 0.006019 сек (очень медленно).
• Время выполнения при вызове 50000 раз: 16.46 сек (медленно).
• Пример PHP версии: 7.1.2, версии WordPress: 4.7.3.
• Нет хуков.

Возвращаемое значение

Функция ничего не возвращает (null).

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

Формат вызова функции:

the_category( $separator, $parents, $post_id );

Параметры

• $separator (строка) — Разделитель между ссылками. По умолчанию: пустая строка '' — ссылки выводятся в виде списка <ul>.

• $parents (строка) — Определяет, как показывать ссылки, если текущая категория является дочерней:

  • multiple — показать ссылки на родительские и дочерние категории отдельно, сохраняя порядок (родитель > потомок).
  • single — показать одну ссылку на категорию, куда входит запись, при этом вся структура категорий станет якорем для ссылки.
  • По умолчанию: '' — просто отображает категории, к которым принадлежит запись (без учета родительских категорий).

• $post_id (целое число) — ID записи, категории которой нужно отобразить. По умолчанию: false — используется текущая запись ($post->ID).

Примеры использования

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

Категории: 

Результат: Категории: WordPress, Компьютеры, Блоггинг

Пример 2: Использование второго параметра

Допустим, публикация находится в ка��егории "Пушкин", которая является подкатегорией "Поэты":

 ', 'multiple'); ?>

Отображается: Поэты > Пушкин

Пример 3: Установка параметра 'single'

 ', 'single'); ?>

Результат: Поэты > Пушкин (ссылка ведет к категории "Пушкин").

Изменения

• Функция была введена в версии 0.71.

Код функции

Функция the_category() определена в файле wp-includes/category-template.php:

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

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

Для работы с категориями и тегами можно использовать следующие функции:

• get_object_taxonomies()
• get_objects_in_term()
• get_the_category()
• get_the_category_list()
• get_the_tag_list()
• get_the_tags()
• get_the_taxonomies()
• get_the_term_list()
• get_the_terms()
• has_category()
• has_tag()
• has_term()
• is_object_in_taxonomy()
• is_object_in_term()
• the_tags()
• the_taxonomies()
• wp_delete_object_term_relationships()
• wp_get_object_terms()
• wp_get_post_categories()
• wp_get_post_tags()
• wp_get_post_terms()
• wp_remove_object_terms()
• wp_set_object_terms()
• wp_set_post_categories()
• wp_set_post_tags()
• wp_set_post_terms()

Заключение

Функция the_category() — полезный инструмент для отображения категорий ваших записей в WordPress. Она проста в использовании и позволяет добавить многообразие в вашу разметку. Не забудьте экспериментировать с параметрами для достижения наилучшего результата.