Описание функции get_taxonomy()
Функция get_taxonomy() возвращает объект таксономии по ее имени. Это полезно для получения информации о пользовательских таксономиях, таких как метки и категории, а также для работы с пользовательскими таксономиями, созданными плагинами или темами.
Функция позволяет разработчикам получить доступ к свойствам таксономии, таким как метки, типы объектов и другие параметры
Параметры
$taxonomy
Тип: string
Обязательный: Да
Описание: Имя таксономии, информацию о которой требуется получить
Возможные значения:
Возвращаемое значение
Тип: object|false
Описание: Объект таксономии или false, если таксономия не найдена
Возможные значения:
• Объект WP_Taxonomy с информацией о таксономии
• false, если таксономия не существует
Примеры использования
Базовый пример получения информации о стандартной таксономии категории
$taxonomy = get_taxonomy('category');
if ($taxonomy) {
echo $taxonomy->labels->name;
} else {
echo 'Таксономия не найдена';
}
Выводит ‘Категории’
Получение информации о пользовательской таксономии
$taxonomy = get_taxonomy('custom_taxonomy');
if ($taxonomy) {
echo $taxonomy->labels->singular_name;
} else {
echo 'Таксономия не найдена';
}
Выводит название пользовательской таксономии
Безопасность
Валидация входных данных: Параметр taxonomy должен быть строкой и существовать в системе
Санитизация: WordPress автоматически очищает входные данные
Рекомендации: При выводе данных используйте esc_html() для безопасного отображения названий таксономий
— Связанные функции
Получает список всех зарегистрированных таксономий
Регистрирует новую таксономию
— Хуки
Фильтрует объект таксономии перед его возвратом
— Примечания
– Ограничения
Возвращает только зарегистрированные таксономии
– Частые проблемы
- false, если запрашивается несуществующая таксономия
- Необходимо убедиться, что таксономия зарегистрирована перед вызовом функции
