Возможность: acf/field-groups

Обзор

Перечисляет все группы полей ACF, которые разрешают доступ ИИ.

Описание

Возвращает массив групп полей, у которых включён AI-доступ. Каждая группа полей включает полную конфигурацию, поля и правила расположения.

Вход

Эта возможность не принимает входных параметров.

null

Выход

{
  "field_groups": [
    {
      "ID": 123,
      "key": "group_abc123",
      "title": "Поля товара",
      "fields": [...],
      "location": [...],
      "position": "normal",
      "style": "default",
      "active": true,
      "show_in_rest": true,
      "allow_ai_access": true,
      "ai_description": "Поля с информацией о товаре, включая цену, SKU и остатки на складе."
    }
  ],
  "count": 1,
  "message": "Найдена 1 группа полей с включённым AI-доступом."
}

Свойства вывода

field_groups
(array) Массив объектов групп полей.

count
(integer) Общее количество возвращённых групп полей.

message
(string) Человекочитаемое сообщение о статусе.

Свойства группы полей

СвойствоТипОписание
IDintegerID записи WordPress
keystringУникальный ключ группы полей (например, group_abc123)
titlestringЗаголовок группы полей
fieldsarrayМассив конфигураций полей
locationarrayПравила расположения, определяющие, где отображается группа полей
positionstringПозиция метабокса (normal, side, acf_after_title)
stylestringСтиль метабокса (default, seamless)
activebooleanАктивна ли группа полей
show_in_restbooleanЭкспортируется ли в REST API
allow_ai_accessbooleanВключён ли AI-доступ
ai_descriptionstringОписание, помогающее ИИ понять назначение

Аннотации

АннотацияЗначение
readonlytrue
destructivefalse
idempotenttrue

Права доступа

Требует возможности ACF (по умолчанию: manage_options).

Пример

Перечислите все группы полей, доступные для AI-доступа.

Ответ:

{
  "field_groups": [
    {
      "ID": 45,
      "key": "group_product_details",
      "title": "Данные о товаре",
      "fields": [
        {
          "key": "field_price",
          "label": "Цена",
          "name": "price",
          "type": "number"
        },
        {
          "key": "field_sku",
          "label": "Артикул",
          "name": "sku",
          "type": "text"
        }
      ],
      "location": [
        [
          {
            "param": "post_type",
            "operator": "==",
            "value": "product"
          }
        ]
      ],
      "active": true,
      "allow_ai_access": true,
      "ai_description": "Основные поля с информацией о товаре"
    }
  ],
  "count": 1,
  "message": "Найдена 1 группа полей с включённым AI-доступом."
}

Примечания

  • Возвращаются только те группы полей, у которых allow_ai_access имеет значение true
  • Конфигурации полей включают все настройки полей и условную логику
  • Правила расположения используют тот же формат, что и PHP-регистрация ACF

Обновлено: 01.06.2026