the_category()

Отображает список категорий для записи в виде HTML-списка или в пользовательском формате
Функция WordPress
INT 0.71
WordPress Icon
Содержание
  1. Описание функции
  2. Примеры использования
  3. Отображение категорий в виде HTML списка
  4. Форматирование категорий с использованием разделителя
  5. Отображение родительских категорий
  6. Получение категорий для определенного поста
  7. Вопросы и ответы
  8. Как изменить разделитель между категориями в функции the_category()?
  9. Как вывести только родительские категории в функции the_category()?
  10. Как вывести только дочерние категории в функции the_category()?
  11. Как вывести список категорий в виде ссылок без разделителя в функции the_category()?
  12. Как изменить формат вывода списка категорий в функции the_category()?
  13. Как вывести список категорий для определенного поста в функции the_category()?
  14. Как вывести список категорий для нескольких постов в функции the_category()?
  15. Как вывести список категорий без ссылок в функции the_category()?
  16. Как вывести список категорий в обратном порядке в функции the_category()?
  17. Связанные элементы

Описание функции

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

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

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

the_category( string $separator = '', string $parents = '', int $post_id = false )

Функция the_category() принимает три необязательных параметра:

  • $separator (строка) — Разделитель между категориями. По умолчанию ссылки на категории помещаются в неупорядоченный список. Пустая строка приведет к использованию значения по умолчанию.
  • $parents (строка) — Определяет, как отображать родительские категории. Принимает значения ‘multiple’ (множественные родительские категории), ‘single’ (одиночная родительская категория) или пустая строка (по умолчанию).
  • $post_id (целое число) — Идентификатор поста, для которого нужно получить список категорий. По умолчанию используется текущий пост.
<?php
  // Выводит список категорий для текущего поста
  the_category();
  // Выводит список категорий для поста с ID 5, используя запятую в качестве разделителя
  the_category(', ', 'multiple', 5);
?>

В приведенном выше примере кода функция the_category() вызывается дважды. Первый вызов выводит список категорий для текущего поста с использованием значений по умолчанию для всех параметров. Второй вызов выводит список категорий для поста с ID 5, используя запятую в качестве разделителя и отображая множественные родительские категории.

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

Отображение категорий в виде HTML списка


the_category();

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

Форматирование категорий с использованием разделителя


the_category(', ');

Функция the_category() с параметром $separator позволяет задать разделитель между категориями. В данном примере используется запятая с пробелом в качестве разделителя. Категории выводятся в виде ссылок, разделенных заданным разделителем.

Отображение родительских категорий


the_category(', ', 'multiple');

Функция the_category() с параметром $parents позволяет задать, как отображать родительские категории. В данном примере используется значение 'multiple', что означает, что будут отображены все родительские категории. Категории выводятся в виде ссылок, разделенных заданным разделителем.

Получение категорий для определенного поста


the_category(', ', '', 123);

Функция the_category() с параметром $post_id позволяет получить категории для определенного поста. В данном примере используется значение 123 в качестве идентификатора поста. Категории выводятся в виде ссылок, разделенных заданным разделителем.

Вопросы и ответы

Как изменить разделитель между категориями в функции the_category()?

Для изменения разделителя между категориями в функции the_category() необходимо использовать параметр $separator. По умолчанию, категории выводятся в виде неупорядоченного списка с разделителем между ними. Если нужно изменить разделитель, можно передать в параметр $separator строку с новым разделителем.

Пример кода:


the_category(', ');

Как вывести только родительские категории в функции the_category()?

Для вывода только родительских категорий в функции the_category() необходимо использовать параметр $parents. По умолчанию, все категории выводятся. Чтобы вывести только родительские категории, нужно передать в параметр $parents значение ‘single’.

Пример кода:


the_category('', 'single');

Как вывести только дочерние категории в функции the_category()?

Для вывода только дочерних категорий в функции the_category() необходимо использовать параметр $parents. По умолчанию, все категории выводятся. Чтобы вывести только дочерние категории, нужно передать в параметр $parents значение ‘multiple’.

Пример кода:


the_category('', 'multiple');

Как вывести список категорий в виде ссылок без разделителя в функции the_category()?

Для того чтобы вывести список категорий в виде ссылок без разделителя в функции the_category(), необходимо использовать следующий код:


the_category('');

Как изменить формат вывода списка категорий в функции the_category()?

Для изменения формата вывода списка категорий в функции the_category(), можно использовать параметр $separator. Например, чтобы использовать запятую в качестве разделителя, следует использовать следующий код:


the_category(', ');

Как вывести список категорий для определенного поста в функции the_category()?

Для вывода списка категорий для определенного поста в функции the_category(), необходимо указать ID этого поста с помощью параметра $post_id. Например, чтобы вывести список категорий для поста с ID 5, следует использовать следующий код:


the_category('', '', 5);

Как вывести список категорий для нескольких постов в функции the_category()?

Для вывода списка категорий для нескольких постов в функции the_category() необходимо передать параметр $post_id со значением массива, содержащего идентификаторы постов. В результате будут выведены категории для каждого поста в виде ссылок, разделенных заданным разделителем.


$post_ids = array(1, 2, 3);
the_category(',', '', $post_ids);

Как вывести список категорий без ссылок в функции the_category()?

Для вывода списка категорий без ссылок в функции the_category() необходимо передать параметр $separator со значением пустой строки. В результате будут выведены только названия категорий, разделенные заданным разделителем.


the_category('', '', false);

Как вывести список категорий в обратном порядке в функции the_category()?

Для вывода списка категорий в обратном порядке в функции the_category() необходимо передать параметр $separator со значением пустой строки и параметр $parents со значением ‘multiple’. В результате категории будут выведены в обратном порядке, разделенные заданным разделителем.


the_category('', 'multiple', false);

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

Связанные элементы

  • Функция get_the_category(): возвращает массив объектов категорий, к которым относится пост.
  • Функция get_the_category_list(): возвращает строку, содержащую список категорий, к которым относится пост.
  • Функция single_cat_title(): выводит заголовок текущей категории.
  • Функция get_category_link(): возвращает URL ссылки на категорию.
  • Функция get_category_parents(): возвращает список родительских категорий для указанной категории.
  • Функция get_category(): возвращает объект категории по ее ID.
  • Хук pre_get_posts: позволяет изменять параметры запроса перед выполнением запроса к базе данных.
Обсуждение