Возможность: acf/create-custom-post-type

Обзор

Создаёт новый пользовательский тип записи в 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' успешно создан."
}

Аннотации

АннотацияЗначение
readonlyfalse
destructivefalse
idempotentfalse

Разрешения

Требуется возможность 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