Описание функции get_the_taxonomies()
Функция get_the_taxonomies() возвращает массив таксономий для текущей записи. Это позволяет разработчикам получать информацию о всех таксономиях, связанных с записью, таких как категории и метки.
Функция используется в шаблонах и плагинах для отображения или обработки таксономий текущего поста.
Параметры
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Массив аргументов для фильтрации таксономий
Возможные значения:
object_type: Массив типов объектов, для которых нужно получить таксономии
public: 1,
show_ui: 1,
Возвращаемое значение
Тип: array
Описание: Массив таксономий для текущей записи
Возможные значения:
• Массив объектов WP_Taxonomy при успешном выполнении
• Пустой массив если таксономии не найдены
Примеры использования
Базовый пример получения таксономий
$taxonomies = get_the_taxonomies();
foreach($taxonomies as $taxonomy) {
echo $taxonomy->name . ', ';
}
Покажет названия всех таксономий, связанных с текущей записью
Получение только публичных таксономий для текущей записи
$args = array(
'public' => true
);
$taxonomies = get_the_taxonomies($args);
Исключает скрытые таксономии
Безопасность
Валидация входных данных: Все параметры проходят валидацию внутри функции
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: При выводе данных используйте esc_html() для названий таксономий
— Связанные функции
Получает все зарегистрированные таксономии
Получает термины для конкретной записи по таксономии
— Хуки
Фильтрует массив таксономий перед его возвратом
— Примечания
– Ограничения
Возвращает таксономии только для текущей записи
– Частые проблемы
- Пустой результат при отсутствии таксономий для записи
- Некорректные параметры могут привести к неожиданным результатам