get_the_category_list()

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

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

Функция get_the_category_list() используется для получения списка категорий для определенного поста в формате HTML-списка или в пользовательском формате.

Функция возвращает список категорий для поста в виде строки.

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

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

Функция принимает три необязательных параметра: $separator, $parents и $post_id.

$separator — разделитель между категориями. По умолчанию ссылки размещаются в неупорядоченном списке. Пустая строка приведет к использованию стандартного разделителя. По умолчанию: ».

$parents — определяет, как отображать родительские категории. Принимает значения ‘multiple’, ‘single’ или пустую строку. По умолчанию: ».

$post_id — идентификатор поста, для которого нужно получить список категорий. По умолчанию используется текущий пост. По умолчанию: false.

Функция возвращает список категорий для поста в виде строки.


/**
 * Пример использования функции get_the_category_list()
 * с указанием всех параметров.
 */
$post_id = 123; // ID поста
$separator = ', '; // Разделитель
$parents = 'multiple'; // Отображение родительских категорий
$category_list = get_the_category_list($separator, $parents, $post_id);
echo $category_list;

В этом примере мы указываем ID поста, разделитель между категориями и определяем, что нужно отобразить все родительские категории. Затем мы вызываем функцию get_the_category_list() с этими параметрами и выводим список категорий для поста.

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

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


$post_categories = get_the_category_list();
echo $post_categories;

В этом примере мы используем функцию get_the_category_list() без параметров, чтобы получить список категорий для текущего поста в виде HTML-списка. Результат будет выведен с помощью функции echo.

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


$post_categories = get_the_category_list(', ');
echo $post_categories;

В этом примере мы используем функцию get_the_category_list() с параметром ', ', чтобы добавить запятую и пробел в качестве разделителя между категориями. Результат будет выведен с помощью функции echo.

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


$post_categories = get_the_category_list(', ', 'multiple');
echo $post_categories;

В этом примере мы используем функцию get_the_category_list() с параметром 'multiple', чтобы отобразить все родительские категории, если они есть. Результат будет выведен с помощью функции echo.

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


$post_id = 123;
$post_categories = get_the_category_list(', ', '', $post_id);
echo $post_categories;

В этом примере мы используем функцию get_the_category_list() с параметром $post_id, чтобы получить список категорий для поста с ID 123. Результат будет выведен с помощью функции echo.

Использование функции get_the_category_list() в шаблоне WordPress


$post_categories = get_the_category_list(', ');
if ( $post_categories ) {
    echo 'Categories: ' . $post_categories;
}

В этом примере мы используем функцию get_the_category_list() в шаблоне WordPress. Мы сначала получаем список категорий с помощью функции, а затем проверяем, есть ли категории. Если есть, то выводим текст «Categories: » и список категорий с помощью функции echo.

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

Как вывести список категорий поста в HTML-формате?

Функция get_the_category_list() используется для получения списка категорий поста в формате HTML. По умолчанию, ссылки на категории помещаются в неупорядоченный список.

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


$categories = get_the_category_list();
echo $categories;

Как изменить разделитель между категориями?

Параметр $separator функции get_the_category_list() позволяет изменить разделитель между категориями.

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


$categories = get_the_category_list(', ');
echo $categories;

Как вывести только родительские категории?

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

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


$categories = get_the_category_list('', 'single');
echo $categories;

Как вывести только дочерние категории?

Для вывода только дочерних категорий воспользуйтесь функцией get_the_category_list() с параметром $parents установленным в значение «multiple».


$categories = get_the_category_list(',', 'multiple');
echo $categories;

Как вывести список категорий для определенного поста?

Для вывода списка категорий для определенного поста используйте функцию get_the_category_list() с параметром $post_id установленным в ID нужного поста.


$categories = get_the_category_list(',', '', 123);
echo $categories;

Как вывести список категорий без ссылок?

Для вывода списка категорий без ссылок установите параметр $separator в пустую строку.


$categories = get_the_category_list('', '', 123);
echo $categories;

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

Функция get_the_category_list() используется для получения списка категорий для определенного поста в формате HTML-списка или в пользовательском формате.

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

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

Параметр $parents определяет, как отображать родительские категории. Вы можете выбрать из трех вариантов: ‘multiple’ (множественные), ‘single’ (единственные) или оставить его пустым.

Параметр $post_id позволяет указать ID поста, для которого нужно получить список категорий. По умолчанию, будет использован ID текущего поста.

Как вывести список категорий в виде массива?

Функция get_the_category_list() возвращает список категорий в виде строки. Если вам нужно получить список категорий в виде массива, вы можете использовать функцию get_the_category().


$categories = get_the_category( $post_id );

Функция get_the_category() возвращает массив объектов категорий для указанного поста. Вы можете использовать этот массив для дальнейшей обработки или вывода категорий в нужном формате.

Как вывести список категорий с определенным разделителем?

Если вам нужно вывести список категорий с определенным разделителем, вы можете использовать параметр $separator функции get_the_category_list().


$category_list = get_the_category_list( ', ', '', $post_id );

В приведенном примере, категории будут разделены запятой и пробелом.

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

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

  • Функция get_category(): Возвращает объект категории.
  • Функция get_categories(): Возвращает массив объектов категорий.
  • Функция get_the_category(): Возвращает массив объектов категорий, к которым относится пост.
  • Функция get_category_by_slug(): Возвращает объект категории по ее слагу.
  • Функция get_category_by_path(): Возвращает объект категории по ее пути.
  • Функция get_category_link(): Возвращает URL ссылки на категорию.
  • Функция get_category_parents(): Возвращает массив родительских категорий для указанной категории.
  • Функция get_category_template(): Возвращает путь к файлу шаблона для отображения категории.
Категории
Обсуждение

Этот сайт использует cookie для хранения данных. Продолжая использовать сайт, Вы принимаете условия пользовательского соглашения и даете свое согласие на использование cookie.