Обзор
Перечисляет все пользовательские таксономии, зарегистрированные в ACF.
Описание
Возвращает массив таксономий, созданных с помощью функции регистрации таксономий ACF. Включает таксономии, для которых включен доступ ИИ.
Входные данные
Эта возможность не принимает входных параметров.
null
Выходные данные
{
"custom_taxonomies": [
{
"taxonomy": "product_category",
"label": "Категория товара",
"plural_label": "Категории товаров",
"description": "Категории для организации товаров",
"public": true,
"hierarchical": true,
"show_in_rest": true,
"rest_base": "product-categories",
"post_types": ["product"],
"allow_ai_access": true,
"ai_description": "Иерархические категории для организации товаров"
}
],
"count": 1,
"message": "Найдена 1 пользовательская таксономия ACF."
}
Свойства результата
custom_taxonomies
(array) Массив объектов конфигурации таксономий.
count
(integer) Общее количество возвращенных таксономий.
message
(string) Читаемое человеком статусное сообщение.
Свойства таксономии
| Свойство | Тип | Описание |
|---|---|---|
taxonomy | string | Ключ/слаг таксономии (макс. 32 символа) |
label | string | Единственное число |
plural_label | string | Множественное число |
description | string | Описание таксономии |
public | boolean | Доступна ли публично |
hierarchical | boolean | Поддерживает ли родительские/дочерние элементы (как категории) |
show_in_rest | boolean | Доступна ли в REST API |
rest_base | string | Базовый путь REST API |
post_types | array | Связанные слагы типов записей |
allow_ai_access | boolean | Включен ли доступ ИИ |
ai_description | string | Описание, которое помогает ИИ понять назначение |
Аннотации
| Аннотация | Значение |
|---|---|
readonly | true |
destructive | false |
idempotent | true |
Права доступа
Требуется возможность ACF (по умолчанию: manage_options).
Пример
Перечислить все пользовательские таксономии, зарегистрированные через ACF.
Ответ:
{
"custom_taxonomies": [
{
"taxonomy": "event_category",
"label": "Категория события",
"plural_label": "Категории событий",
"hierarchical": true,
"public": true,
"post_types": ["event"],
"show_in_rest": true,
"allow_ai_access": true,
"ai_description": "Категории для классификации событий по типу"
},
{
"taxonomy": "event_tag",
"label": "Метка события",
"plural_label": "Метки событий",
"hierarchical": false,
"public": true,
"post_types": ["event"],
"show_in_rest": true,
"allow_ai_access": true
}
],
"count": 2,
"message": "Найдены 2 пользовательские таксономии ACF."
}
Примечания
- Возвращаются только таксономии, зарегистрированные через ACF (не встроенные и не таксономии плагинов)
- Чтобы таксономии были полностью доступны через возможности, для них должно быть включено
show_in_rest - Возможности для каждой таксономии (query, create, view, update, delete) регистрируются динамически для каждой таксономии с доступом ИИ
- Иерархические таксономии поддерживают отношения родитель/дочерний элемент (как категории)
- Неиерархические таксономии плоские (как метки)
Обновлено: 01.06.2026