Описание функции get_category_by_slug()
Функция get_category_by_slug() возвращает объект категории WordPress по указанному слагу. Эта функция полезна, когда необходимо получить информацию о конкретной категории, используя её уникальный идентификатор (слаг).
Функция используется в плагинах и темах для получения данных о категориях на основе их слагов.
Параметры
$slug
Тип: string
Обязательный: Да
Описание: Слаг категории, которую нужно получить
Возможные значения:
Возвращаемое значение
Тип: object|WP_Error
Описание: Объект WP_Term, представляющий категорию, или WP_Error в случае ошибки
Возможные значения:
• Объект WP_Term при успешном выполнении
• WP_Error если категория не найдена
Примеры использования
Базовый пример получения категории по слагу
$category = get_category_by_slug('news');
if ($category) {
echo 'Категория: ' . $category->name;
} else {
echo 'Категория не найдена';
}
Выводит название категории или сообщение об ошибке
Пример обработки ошибки, если категория не найдена
$category = get_category_by_slug('nonexistent');
if (is_wp_error($category)) {
echo $category->get_error_message();
}
Выводит сообщение об ошибке
Безопасность
Валидация входных данных: Слаг проходит валидацию внутри функции
Санитизация: Параметр автоматически очищается WordPress
Рекомендации: Используйте esc_html() для безопасного вывода названий категорий
— Связанные функции
Получает одну категорию по ID
Получает все категории или их фильтрованный список
— Примечания
– Ограничения
Возвращает только публичные категории
– Частые проблемы
- Категория не найдена при неправильном слаге
- Проблемы с кэшированием могут привести к устаревшим данным
