Обзор
Перечисляет все пользовательские таксономии, зарегистрированные в ACF.
Описание
Возвращает массив таксономий, созданных с помощью функции регистрации таксономий ACF. Включает таксономии, для которых включён доступ AI.
Входные данные
Эта возможность не принимает входных параметров.
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 |
ai_description | string | Описание, помогающее AI понять назначение |
Аннотации
| Аннотация | Значение |
|---|---|
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 - Возможности для отдельных таксономий (запрос, создание, просмотр, обновление, удаление) динамически регистрируются для каждой таксономии с доступом AI
- Иерархические таксономии поддерживают связи между родительскими и дочерними терминами (как рубрики)
- Неиерархические таксономии имеют плоскую структуру (как метки)
Обновлено: 30.09.2026