Функция get_cat_name() используется для получения названия категории по её идентификатору (ID) в WordPress. Это простой и удобный способ получить имя категории, зная только её ID.
get_cat_name( int $cat_id ): string
Параметры
- $cat_id (int)
Обязательный параметр.
Идентификатор категории, название которой необходимо получить.
Возвращаемое значение
- string
Функция возвращает название категории в виде строки. Если категория с указанным ID не существует, возвращается пустая строка.
Пример 1: Вывод названия категории с определённым ID
<?php
echo get_cat_name( 123 );
?>
Пример использования в архиве категории
<?php
if ( is_category() ) {
$current_category = get_queried_object();
echo 'Текущая категория: ' . $current_category->name;
}
?>
Здесь проверяется, находится ли пользователь на странице категории с помощью функции is_category(). Затем через объект get_queried_object() выводится название текущей категории.
Как работает get_cat_name()
Внутренне функция get_cat_name() использует функцию get_term() для получения данных о категории на основе её ID. Она возвращает только имя категории, что делает её удобной для быстрого вывода на страницы.
Особенности
- Если категории с указанным ID не существует, функция вернет пустую строку.
- Не имеет хуков, то есть не поддерживает обработку через фильтры и действия.
Заключение
Функция get_cat_name() — это полезный инструмент, когда вам нужно быстро получить и вывести название категории по её ID. Она проста в использовании и может быть применена в различных сценариях, от отображения названия категории в шаблонах до динамического формирования текстов на сайте.