Обзор
Создаёт новый пользовательский тип записи в ACF.
Описание
Создаёт новый пользовательский тип записи с помощью системы регистрации типов записей ACF. Тип записи регистрируется в WordPress и при необходимости становится доступным для ИИ.
Входные данные
{
"post_type": "product",
"label": "Товар",
"plural_label": "Товары"
}Обязательные свойства
post_type
(string) Ключ/slug типа записи. Должен содержать строчные буквы, цифры, символы подчёркивания или дефисы. Максимальная длина — 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) Пользовательский slug страницы архива.
menu_icon
(string|object) Значок меню администратора. Может быть классом dashicon (например, dashicons-cart), URL изображения или объектом с параметрами type и value.
menu_position
(integer) Позиция в меню администратора. Допустимые значения: от 5 до 100.
taxonomies
(array) Массив slug таксономий, связанных с этим типом записи.
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и т. д.) использовать нельзя - Тип записи сразу регистрируется и становится доступен в панели администратора
- Динамические возможности (запрос, создание, просмотр, обновление, удаление) регистрируются для типов записей, у которых включены
show_in_restиallow_ai_access
Обновлено: 30.09.2026