Описание функции get_object_taxonomies()
Функция get_object_taxonomies() возвращает массив таксономий для заданного типа объекта. Это позволяет разработчикам получать информацию о связанных таксономиях, таких как категории, метки и пользовательские таксономии, что полезно для работы с записями и их структурой.
Функция используется в случаях, когда необходимо получить таксономии, ассоциированные с определенным типом записи или объектом.
Параметры
$object_type
Тип: string
Обязательный: Да
Описание: Тип объекта, для которого необходимо получить таксономии
Возможные значения:
0: post
1: page
2: custom_post_type
$output
Тип: string
Обязательный: Нет
По умолчанию: names
Описание: Тип возвращаемого значения
Возможные значения:
0: names
1: objects
Возвращаемое значение
Тип: array
Описание: Массив таксономий, связанных с заданным типом объекта
Возможные значения:
• Массив строк с названиями таксономий
• Массив объектов WP_Taxonomy при output=’objects’
• Пустой массив, если таксономии не найдены
Примеры использования
Базовый пример получения таксономий для типа объекта ‘post’
$taxonomies = get_object_taxonomies('post');
foreach($taxonomies as $taxonomy) {
echo $taxonomy . ', ';
}
category, post_tag,
Получение объектов таксономий для типа объекта ‘post’
$taxonomies = get_object_taxonomies('post', 'objects');
foreach($taxonomies as $taxonomy) {
echo $taxonomy->labels->name . ', ';
}
Выводит метки таксономий
Безопасность
Валидация входных данных: Параметр object_type проверяется на наличие зарегистрированных типов объектов
Санитизация: Не требуется дополнительная очистка параметров
Рекомендации: Используйте существующие типы объектов для предотвращения ошибок
— Связанные функции
Получает все зарегистрированные таксономии
Регистрация новой таксономии
— Хуки
Фильтрует список таксономий перед возвратом
— Примечания
– Ограничения
Возвращает только таксономии, зарегистрированные для указанного типа объекта
– Частые проблемы
- Пустой результат при неверном type объекта
- Ошибки, если таксономии не зарегистрированы