Функция is_taxonomy_hierarchical() в WordPress используется для проверки, является ли заданная таксономия древовидной (иерархической). Это может быть полезно при разработке тем и плагинов, когда необходимо различать таксономии, которые поддерживают иерархию (например, категории), и те, которые не имеют иерархии (например, метки).
is_taxonomy_hierarchical( string $taxonomy ): bool
Параметры
- $taxonomy (string, обязательный): Название объекта таксономии, которую нужно проверить на древовидность.
Возвращаемое значение
Функция возвращает логическое значение:
- true, если таксономия является древовидной.
- false, если таксономия обычная или не существует.
Описание
Функция сначала проверяет, является ли указанная таксономия объектом. Затем она получает объект таксономии и возвращает значение иерархии из этого объекта. Если таксономия не существует, функция также вернет false.
Функция is_taxonomy_hierarchical() основывается на других функциях WordPress:
taxonomy_exists(): проверяет, существует ли указанная таксономия.get_taxonomy(): получает объект таксономии.
Пример 1: Проверка стандартных таксономий
В этом примере мы проверим, являются ли стандартные таксономии category (категории) и post_tag (метки) древовидными.
$is_category_hierarchical = is_taxonomy_hierarchical('category');
// вернет: true
$is_post_tag_hierarchical = is_taxonomy_hierarchical('post_tag');
// вернет: false
Пример 2: Проверка произвольной таксономии
В этом примере мы проверим, является ли произвольная таксономия с названием custom_tax древовидной.
if (is_taxonomy_hierarchical('custom_tax')) {
// Таксономия древовидная
echo 'Таксономия custom_taxявляется древовидной.';
} else {
// Таксономия не древовидная
echo 'Таксономия custom_taxне является древовидной.';
}
Заключение
Функция is_taxonomy_hierarchical() является полезным инструментом для разработчиков WordPress, позволяя определять тип таксономии и адаптировать логику приложения в зависимости от ее иерархической структуры. Эта функция помогает сделать код более гибким и упрощает работу с разными типами таксономий.