Обзор
Создает новый пользовательский тип записи в ACF.
Описание
Создает новый пользовательский тип записи с помощью системы регистрации типов записей ACF. Тип записи регистрируется в WordPress и при необходимости включается для доступа ИИ.
Входные данные
{
"post_type": "product",
"label": "Товар",
"plural_label": "Товары"
}Обязательные свойства
post_type
(string) Ключ/слаг типа записи. Должен содержать только строчные буквы, цифры, символы подчеркивания или дефисы. Максимум 20 символов.
label
(string) Единственная метка типа записи.
plural_label
(string) Множественная метка типа записи.
Необязательные свойства
description
(string) Описание типа записи.
public
(boolean) Определяет, доступен ли тип записи публично. По умолчанию: true
hierarchical
(boolean) Определяет, поддерживает ли тип записи родительско-дочерние связи (как страницы). По умолчанию: false
supports
(array) Возможности, которые поддерживает тип записи. Может быть массивом строк или объектом с булевыми значениями.
Доступные поддерживаемые параметры:
– title: Заголовок записи
– editor: Редактор содержимого
– author: Выбор автора
– thumbnail: Изображение записи
– excerpt: Цитата записи
– comments: Комментарии
– trackbacks: Трекбэки
– revisions: История редакций
– page-attributes: Атрибуты страницы (порядок меню, родитель)
– custom-fields: Метабокс пользовательских полей
– post-formats: Форматы записи
show_in_rest
(boolean) Определяет, нужно ли показывать в REST API. Требуется для редактора блоков и возможностей ИИ. По умолчанию: true
rest_base
(string) Пользовательский базовый путь REST API. По умолчанию используется ключ типа записи.
has_archive
(boolean) Определяет, есть ли у типа записи страница архива. По умолчанию: false
has_archive_slug
(string) Пользовательский слаг для страницы архива.
menu_icon
(string|object) Значок меню в админке. Может быть классом dashicon (например, dashicons-cart), URL изображения или объектом с type и value.
menu_position
(integer) Позиция в меню админки. Значения 5–100.
taxonomies
(array) Массив слагов таксономий, которые нужно связать с этим типом записи.
allow_ai_access
(boolean) Определяет, разрешен ли доступ ИИ к этому типу записи. По умолчанию: true
ai_description
(string) Описание, которое помогает ИИ понять назначение этого типа записи.
Вывод
{
"success": true,
"post_type": {
"post_type": "product",
"label": "Товар",
"plural_label": "Товары",
"public": true,
"show_in_rest": true,
"allow_ai_access": true
},
"message": "Пользовательский тип записи 'product' успешно создан."
}Примечания
| Аннотация | Значение |
|---|---|
readonly | false |
destructive | false |
idempotent | false |
Права доступа
Требуется возможность ACF (по умолчанию: manage_options).
Пример
Создайте тип записи «Участник команды»:
{
"post_type": "team_member",
"label": "Участник команды",
"plural_label": "Участники команды",
"description": "Профили сотрудников и участников команды",
"public": true,
"supports": ["title", "editor", "thumbnail"],
"has_archive": true,
"menu_icon": "dashicons-groups",
"menu_position": 25,
"allow_ai_access": true,
"ai_description": "Профили участников команды с биографией, ролью и контактной информацией"
}Ответ:
{
"success": true,
"post_type": {
"post_type": "team_member",
"label": "Участник команды",
"plural_label": "Участники команды",
"description": "Профили сотрудников и участников команды",
"public": true,
"hierarchical": false,
"supports": ["title", "editor", "thumbnail"],
"show_in_rest": true,
"has_archive": true,
"menu_icon": "dashicons-groups",
"menu_position": 25,
"allow_ai_access": true,
"ai_description": "Профили участников команды с биографией, ролью и контактной информацией"
},
"message": "Пользовательский тип записи 'team_member' успешно создан."
}Ошибки
| Ошибка | Причина |
|---|---|
| Неверный ключ типа записи | Ключ содержит недопустимые символы или превышает 20 символов |
| Тип записи уже существует | Тип записи с этим ключом уже зарегистрирован |
| Не указано обязательное поле | post_type, label или plural_label не предоставлены |
Примечания
- Ключи типов записей должны быть уникальными во всем WordPress
- Зарезервированные ключи типов записей (
post,page,attachmentи т. д.) использовать нельзя - Тип записи сразу регистрируется и становится доступен в админке
- Динамические возможности (query, create, view, update, delete) регистрируются для типов записей с включенными
show_in_restиallow_ai_access
Обновлено: 01.06.2026