Утилиты: Поля товара

Настройка полей на вкладке Данные в карточке товара.

Cookbook

Секции, скрытие полей, связь с extra fields: Cookbook полей товара. Пример end-to-end: Оптовая цена.

Назначение

Инструмент управляет раскладкой полей на вкладке «Данные»:

• видимость и порядок полей
• группы по секциям
• подписи и xtype виджетов

Новую колонку в ms3_product_data создают в Дополнительных полях. После POST extra field строка появляется здесь автоматически.

Интерфейс

Секции

Левая панель содержит список секций с возможностью drag-and-drop сортировки.

Действия с секциями:

• Добавить — создание новой секции
• Редактировать — изменение параметров секции
• Удалить — удаление секции (поля перемещаются в "Без секции")
• Перетаскивание — изменение порядка секций

Поля

Правая панель показывает поля выбранной секции.

Отображаемая информация:

• Название поля (ключ)
• Подпись (label)
• Тип виджета (xtype)
• Статус видимости

Действия с полями:

• Редактировать — настройка параметров поля
• Перетаскивание — изменение порядка внутри секции

Управление секциями

Создание секции

1. Нажмите кнопку "Добавить секцию"
2. Заполните форму:

Поле	Описание	Обязательно
Ключ секции	Уникальный идентификатор (латиница)	Да
Ключ лексикона	Ключ для перевода названия	Нет
Название	Отображаемое название	Нет
Скрыта	Секция не отображается в карточке	Нет

Лексикон

Если указан ключ лексикона, название берётся из файлов локализации. Это позволяет автоматически переводить интерфейс на разные языки.

Редактирование секции

Кликните на иконку редактирования справа от названия секции или дважды кликните на секцию.

Удаление секции

Внимание

При удалении секции все её поля перемещаются в раздел "Без секции". Сами поля не удаляются.

Управление полями

Редактирование поля

Кликните на поле для открытия диалога редактирования.

Доступные параметры:

Параметр	Описание
Название (label)	Отображаемое название поля
Описание	Подсказка под полем
Секция	К какой секции принадлежит поле
Тип виджета (xtype)	Тип элемента формы
Видимость	Отображать ли поле в карточке
Порядок	Позиция в списке полей секции

Типы виджетов (xtype)

Тип	Описание
textfield	Однострочное текстовое поле
numberfield	Числовое поле
textarea	Многострочное текстовое поле
xcheckbox	Флажок (чекбокс)
ms3-combo-vendor	Выбор производителя
ms3-combo-autocomplete	Автодополнение из списка
ms3-combo-options	Выбор из опций товара

Перемещение полей

Поля можно перемещать:

• Внутри секции — перетаскиванием вверх/вниз
• Между секциями — изменением секции в диалоге редактирования

Стандартные секции

По умолчанию доступны следующие секции:

Ключ	Название	Описание
main	Основные данные	Артикул, цена, вес и др.
availability	Наличие	Остатки, статусы
content	Контент	Описание, характеристики

Сохранение изменений

• Изменения сохраняются автоматически при перетаскивании
• При редактировании поля/секции нажмите "Сохранить"
• Для применения изменений в карточке товара перезагрузите страницу

API Endpoints

Получение конфигурации полей

GET /api/mgr/config/page-fields/product_data

Ответ:

{
  "success": true,
  "object": {
    "fields": [
      {
        "name": "article",
        "label": "Артикул",
        "xtype": "textfield",
        "section": 1,
        "visible": true,
        "sort_order": 0
      }
    ]
  }
}

Получение секций

GET /api/mgr/config/sections/product_data

Сохранение конфигурации полей

PUT /api/mgr/config/page-fields/product_data

Право записи: mssetting_save. Чтение (GET) доступно любой сессии менеджера без mssetting_save.

Тело запроса — массив fields (не одно поле):

{
  "fields": [
    {
      "name": "article",
      "label": "Артикул товара",
      "section": 1,
      "visible": true,
      "sort_order": 0
    }
  ]
}

Сохранение секций

Новую секцию UI добавляет локально, затем сохраняет весь список:

PUT /api/mgr/config/sections/product_data

{
  "sections": [
    {
      "section_key": "custom",
      "lexicon_key": "ms3_section_custom",
      "label": "Дополнительно",
      "hidden": false,
      "sort_order": 100
    }
  ]
}

Удаление секции

DELETE /api/mgr/config/sections/product_data/{section_key}

Базовые секции удалить нельзя. POST /config/sections/... в 1.13.x нет.

Примеры настройки

Скрытие ненужных полей

Для интернет-магазина одежды не нужны поля color и size в стандартном виде (используются опции):

1. Откройте поле color
2. Снимите флаг "Видимость"
3. Сохраните
4. Повторите для size

Создание секции "SEO"

1. Нажмите "Добавить секцию"
2. Заполните:
   • Ключ: seo
   • Название: SEO
3. Переместите поля metatitle, metadescription в новую секцию

Изменение порядка секций

Перетащите секции в нужном порядке. Например:

1. Основные данные
2. Цены
3. Наличие
4. SEO