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

Настройка отображения полей на вкладке "Данные товара" в карточке товара.

Назначение

Данный инструмент позволяет:

• Включать и отключать видимость полей
• Группировать поля по секциям (разделам)
• Изменять порядок отображения полей
• Создавать и редактировать секции
• Настраивать параметры каждого поля

Интерфейс

Секции

Левая панель содержит список секций с возможностью 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

Тело запроса:

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

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

POST /api/mgr/config/sections/product_data

Тело запроса:

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

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

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

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

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

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

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

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

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

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