Обзор
Создаёт новую пользовательскую таксономию в ACF.
Описание
Создаёт новую таксономию с помощью системы регистрации таксономий ACF. Таксономия регистрируется в WordPress и при необходимости может быть включена для доступа ИИ.
Входные данные
{
"taxonomy": "product_category",
"label": "Категория товара",
"plural_label": "Категории товаров",
"post_types": ["product"]
}Обязательные свойства
taxonomy
(string) Ключ/слаг таксономии. Должен состоять из строчных букв и цифр, а также подчёркиваний или дефисов. Максимум 32 символа.
label
(string) Единственная метка для таксономии.
plural_label
(string) Множественная метка для таксономии.
post_types
(array) Массив слагов типов записей, связанных с этой таксономией.
Необязательные свойства
description
(string) Описание таксономии.
public
(boolean) Доступна ли таксономия публично. По умолчанию: true
hierarchical
(boolean) Поддерживает ли таксономия отношения родитель/дочерний элемент (как рубрики). По умолчанию: false (плоская, как метки)
show_in_rest
(boolean) Показывать ли в REST API. Требуется для редактора блоков и возможностей ИИ. По умолчанию: true
rest_base
(string) Пользовательский базовый путь REST API. По умолчанию — ключ таксономии.
show_admin_column
(boolean) Показывать ли столбец в таблице записей. По умолчанию: false
allow_ai_access
(boolean) Разрешать ли ИИ доступ к этой таксономии. По умолчанию: true
ai_description
(string) Описание, помогающее ИИ понять назначение этой таксономии.
Вывод
{
"success": true,
"taxonomy": {
"taxonomy": "product_category",
"label": "Категория товара",
"plural_label": "Категории товаров",
"hierarchical": false,
"public": true,
"post_types": ["product"],
"show_in_rest": true,
"allow_ai_access": true
},
"message": "Пользовательская таксономия 'product_category' успешно создана."
}Аннотации
| Аннотация | Значение |
|---|---|
readonly | false |
destructive | false |
idempotent | false |
Права доступа
Требуется capability ACF (по умолчанию: manage_options).
Пример
Создайте иерархическую таксономию «Категория события»:
{
"taxonomy": "event_category",
"label": "Категория события",
"plural_label": "Категории событий",
"description": "Категории для организации событий",
"post_types": ["event"],
"hierarchical": true,
"show_admin_column": true,
"allow_ai_access": true,
"ai_description": "Иерархические категории для типов событий (конференции, воркшопы, митапы)"
}Ответ:
{
"success": true,
"taxonomy": {
"taxonomy": "event_category",
"label": "Категория события",
"plural_label": "Категории событий",
"description": "Категории для организации событий",
"hierarchical": true,
"public": true,
"post_types": ["event"],
"show_in_rest": true,
"show_admin_column": true,
"allow_ai_access": true,
"ai_description": "Иерархические категории для типов событий (конференции, воркшопы, митапы)"
},
"message": "Пользовательская таксономия 'event_category' успешно создана."
}Ошибки
| Ошибка | Причина |
|---|---|
| Неверный ключ таксономии | Ключ содержит недопустимые символы или превышает 32 символа |
| Таксономия уже существует | Таксономия с этим ключом уже зарегистрирована |
| Отсутствует обязательное поле | taxonomy, label, plural_label или post_types не указаны |
| Неверный тип записи | Один или несколько указанных типов записи не существуют |
Примечания
- Ключи таксономий должны быть уникальными во всём WordPress
- Зарезервированные ключи таксономий (
category,post_tagи т. д.) использовать нельзя - Таксономия регистрируется сразу и становится доступной в админке
- Динамические возможности (query, create, view, update, delete) регистрируются для таксономий с включёнными
show_in_restиallow_ai_access - Установите
hierarchical: trueдля таксономий, похожих на рубрики, с поддержкой родительских и дочерних элементов - Установите
hierarchical: falseдля плоских таксономий, похожих на метки
Обновлено: 01.06.2026