Описание функции is_taxonomy_hierarchical()
Функция is_taxonomy_hierarchical() проверяет, является ли указанная таксономия иерархической. Иерархические таксономии, такие как категории, позволяют создавать родительские и дочерние элементы, в то время как неиерархические таксономии, такие как метки, не имеют этой структуры.
Функция используется в основном при разработке тем и плагинов, где необходимо определить тип таксономии для корректного отображения данных.
Параметры
$taxonomy
Тип: string
Обязательный: Да
Описание: Слаг таксономии, которую нужно проверить на иерархичность
Возможные значения:
Возвращаемое значение
Тип: bool
Описание: Возвращает true, если таксономия иерархическая, иначе false
Возможные значения:
• true — если таксономия иерархическая
• false — если таксономия не иерархическая или не существует
Примеры использования
Базовый пример проверки таксономии категории на иерархичность
$is_hierarchical = is_taxonomy_hierarchical('category');
// $is_hierarchical будет true
Использование для категорий, которые имеют иерархическую структуру
Проверка таксономии меток на иерархичность
$is_hierarchical = is_taxonomy_hierarchical('post_tag');
// $is_hierarchical будет false
Метки не поддерживают иерархию
Безопасность
Валидация входных данных: Параметры не требуют дополнительной валидации, так как используются внутри WordPress
Санитизация: Слаг таксономии должен быть безопасным и корректным
Рекомендации: Убедитесь, что передаваемый слаг зарегистрирован в WordPress
— Связанные функции
Регистрация новой таксономии в WordPress
Получает список зарегистрированных таксономий
— Примечания
– Ограничения
Функция не проверяет существование таксономии, если передан неверный слаг, вернёт false
– Частые проблемы
- Ошибка при использовании несуществующего слага таксономии
- Путаница между иерархическими и неиерархическими таксономиями