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

Обзор

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

Описание

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

Входные данные

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

null

Выходные данные

{
  "field_groups": [
    {
      "ID": 123,
      "key": "group_abc123",
      "title": "Product Fields",
      "fields": [...],
      "location": [...],
      "position": "normal",
      "style": "default",
      "active": true,
      "show_in_rest": true,
      "allow_ai_access": true,
      "ai_description": "Fields for product information including price, SKU, and inventory."
    }
  ],
  "count": 1,
  "message": "Found 1 field group(s) with AI access enabled."
}

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

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_descriptionstringОписание, помогающее ИИ понять назначение

Аннотации

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

Разрешения

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

Пример

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

Ответ:

{
  "field_groups": [
    {
      "ID": 45,
      "key": "group_product_details",
      "title": "Product Details",
      "fields": [
        {
          "key": "field_price",
          "label": "Price",
          "name": "price",
          "type": "number"
        },
        {
          "key": "field_sku",
          "label": "SKU",
          "name": "sku",
          "type": "text"
        }
      ],
      "location": [
        [
          {
            "param": "post_type",
            "operator": "==",
            "value": "product"
          }
        ]
      ],
      "active": true,
      "allow_ai_access": true,
      "ai_description": "Core product information fields"
    }
  ],
  "count": 1,
  "message": "Found 1 field group(s) with AI access enabled."
}

Примечания

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

Обновлено: 30.09.2026