Merge pull request #866 from modx-pro/minishop3

версия 1.7.0

Author: biz87

docs/components/minishop3/interface/category.md

@@ -67,23 +67,25 @@ title: Категория
 - Реактивные фильтры
 - Плавная анимация drag-and-drop
 
-### Системная настройка колонок
+### Настройка колонок
 
-Колонки таблицы настраиваются через `ms3_category_grid_fields`:
+Колонки таблицы настраиваются через интерфейс **Утилиты → Колонки гридов** (грид `category-products`).
 
-```
-id,pagetitle,article,price,weight,image
-```
+::: warning Устаревшая настройка
+Системная настройка `ms3_category_grid_fields` удалена начиная с версии 1.7.0. Используйте интерфейс [Колонки гридов](utilities/grid-columns).
+:::
+
+### Inline-редактирование
+
+Двойной клик по ячейке позволяет редактировать значение прямо в таблице:
 
-**Доступные поля:**
+| Тип редактора | Поля |
+|---------------|------|
+| `text` | `pagetitle`, `longtitle`, `article`, `made_in` |
+| `number` | `price`, `old_price`, `weight` |
+| `boolean` | `published`, `new`, `popular`, `favorite` |
 
-| Группа | Поля |
-|--------|------|
-| Ресурс | `id`, `pagetitle`, `longtitle`, `alias`, `menuindex`, `template`, `published`, `deleted` |
-| Товар | `article`, `price`, `old_price`, `weight`, `image`, `thumb` |
-| Флаги | `new`, `popular`, `favorite` |
-| Производитель | `vendor_id`, `vendor_name`, `made_in` |
-| Даты | `createdon`, `editedon`, `publishedon` |
+Настройка редактируемых полей — в [Утилиты → Колонки гридов](utilities/grid-columns) (параметры `editable` и `editType` у колонки).
 
 ## Настройка колонок таблицы
 
@@ -701,7 +703,6 @@ POST /api/mgr/categories/{id}/products/sort
 
 | Настройка | Описание | По умолчанию |
 |-----------|----------|--------------|
-| `ms3_category_grid_fields` | Видимые колонки таблицы | `id,pagetitle,article,price,weight,image` |
 | `ms3_category_show_nested_products` | Показывать вложенные товары | `false` |
 | `ms3_category_show_options` | Показывать опции категории | `true` |
 | `ms3_category_remember_tabs` | Запоминать активную вкладку | `true` |

docs/components/minishop3/interface/gallery.md

@@ -48,6 +48,19 @@ MiniShop3 использует библиотеку [Intervention Image](https:/
 | AVIF | ✅ | ✅ | -50% размер (требует Imagick) |
 | HEIC | ✅ | ❌ | Конвертируется при загрузке |
 
+## Интерфейс управления
+
+Галерея товара реализована на Vue 3 + PrimeVue и включает:
+
+- **Сетка изображений** — с drag-and-drop сортировкой, поиском и пагинацией
+- **Контекстное меню** — правый клик по изображению для быстрых действий (редактировать, удалить, сделать главным)
+- **Панель инструментов** — выбор Media Source, массовые операции (удаление, перегенерация миниатюр)
+- **Диалог редактирования** — изменение имени файла, описания, alt-текста
+
+### Смена Media Source
+
+Выбор источника файлов в панели инструментов позволяет переключать Media Source без сохранения всей формы товара. Используется процессор `Product\UpdateSource`.
+
 ## Загрузчик изображений
 
 ### Технология Uppy

docs/components/minishop3/interface/settings/deliveries.md

@@ -115,6 +115,24 @@ MiniShop3 позволяет настроить обязательные пол
 - Использования сложных правил с регулярными выражениями
 - Импорта/экспорта конфигурации
 
+### Кастомные поля валидации
+
+Помимо стандартных полей заказа и адреса, можно добавить произвольные поля с правилами валидации. Например, чекбокс согласия с условиями:
+
+```json
+{
+  "phone": "required",
+  "email": "required|email",
+  "agreement": "required|accepted"
+}
+```
+
+Кастомные поля (`agreement` и другие, не входящие в стандартный набор) сохраняются в черновике заказа между шагами `order/add` и `order/submit`. При создании заказа они передаются в события `msOnBeforeCreateOrder` / `msOnCreateOrder` через параметр `customFields`.
+
+::: tip Чекбоксы
+На фронтенде чекбоксы отправляют состояние `input.checked` (`'1'` или `'0'`), а не статический атрибут `value`. Это обеспечивает корректную работу правила `accepted`.
+:::
+
 ### Доступные поля для валидации
 
 #### Поля заказа

docs/components/minishop3/interface/utilities/grid-columns.md

@@ -7,21 +7,26 @@ title: Колонки гридов
 
 ## Назначение
 
-Инструмент позволяет настраивать колонки в гридах (таблицах) админки:
+Основной инструмент настройки колонок в административных таблицах MiniShop3:
 
 - Включать и отключать колонки
 - Изменять порядок колонок
 - Настраивать сортировку и фильтрацию
 - Задавать ширину колонок
 - Добавлять кастомные колонки
+- Настраивать inline-редактирование (для грида `category-products`)
+
+::: info Начиная с версии 1.7.0
+Системная настройка `ms3_category_grid_fields` удалена. Настройка колонок таблицы товаров в категории выполняется только через этот интерфейс.
+:::
 
 ## Доступные гриды
 
 | Грид | Описание |
 |------|----------|
 | `customers` | Список покупателей |
 | `orders` | Список заказов |
-| `products` | Список товаров в категории |
+| `category-products` | Список товаров в категории |
 | `order_products` | Товары в заказе |
 | `vendors` | Список производителей |
 

docs/components/minishop3/settings.md

@@ -21,7 +21,6 @@ title: Системные настройки
 | Настройка | По умолчанию | Описание |
 |-----------|--------------|----------|
 | `ms3_template_category_default` | | Шаблон по умолчанию для новых категорий |
-| `ms3_category_grid_fields` | `id,menuindex,pagetitle,article,price,thumb,new,favorite,popular` | Видимые поля в таблице товаров категории |
 | `ms3_category_show_nested_products` | `true` | Показывать вложенные товары из подкатегорий |
 | `ms3_category_show_options` | `false` | Показывать опции товаров в таблице категории |
 | `ms3_category_remember_tabs` | `true` | Запоминать активную вкладку панели категории |
@@ -73,6 +72,7 @@ title: Системные настройки
 | `ms3_weight_snippet` | | Имя сниппета-модификатора веса |
 | `ms3_currency_symbol` | `₽` | Символ валюты (₽, $, €, £, ₴, ¥, ₸) |
 | `ms3_currency_position` | `after` | Позиция символа: `before` ($ 100) или `after` (100 ₽) |
+| `ms3_weight_unit` | `г` | Единица измерения веса (г, кг, lbs). Используется в `*_formatted` плейсхолдерах |
 
 ## Корзина
 

docs/components/minishop3/snippets/mscart.md

@@ -152,6 +152,13 @@ title: msCart
 - `{$product.old_price}` — Старая цена
 - `{$product.discount_price}` — Скидка на единицу
 - `{$product.discount_cost}` — Скидка на позицию (количество × скидка)
+- `{$product.price_formatted}` — Цена с валютой (например `1 234 ₽`)
+- `{$product.old_price_formatted}` — Старая цена с валютой
+- `{$product.cost_formatted}` — Стоимость позиции с валютой
+- `{$product.old_cost_formatted}` — Старая стоимость позиции с валютой
+- `{$product.weight_formatted}` — Вес с единицей (например `500 г`)
+- `{$product.discount_price_formatted}` — Скидка на единицу с валютой
+- `{$product.discount_cost_formatted}` — Скидка на позицию с валютой
 - `{$product.options}` — Массив опций
 - `{$product.option_*}` — Опции как отдельные поля (например `option_size`)
 - Все поля товара (`pagetitle`, `article`, `thumb` и т.д.)

docs/components/minishop3/snippets/msorder.md

@@ -75,10 +75,14 @@ title: msOrder
         'delivery_id' => 1,
         'payment_id' => 2,
         'comment' => '...',
-        'cost' => '5 300 ₽',          // Итого (форматировано)
-        'cart_cost' => '5 000 ₽',     // Стоимость товаров
-        'delivery_cost' => '300 ₽',   // Стоимость доставки
-        'discount_cost' => '0 ₽',     // Скидка
+        'cost' => 5300,                  // Итого (число)
+        'cost_formatted' => '5 300 ₽',  // Итого с валютой
+        'cart_cost' => 5000,             // Стоимость товаров
+        'cart_cost_formatted' => '5 000 ₽',
+        'delivery_cost' => 300,          // Стоимость доставки
+        'delivery_cost_formatted' => '300 ₽',
+        'discount_cost' => 0,            // Скидка
+        'discount_cost_formatted' => '0 ₽',
     ],
     'form' => [
         'first_name' => 'Иван',

docs/components/minishop3/snippets/msordertotal.md

@@ -131,12 +131,16 @@ title: msOrderTotal
 | Поле | Описание |
 |------|----------|
 | `cost` | Итого к оплате (товары + доставка + комиссия оплаты) |
+| `cost_formatted` | Итого с символом валюты |
 | `cart_cost` | Стоимость товаров |
+| `cart_cost_formatted` | Стоимость товаров с валютой |
 | `delivery_cost` | Стоимость доставки |
+| `delivery_cost_formatted` | Стоимость доставки с валютой |
 | `payment_cost` | Комиссия за способ оплаты |
 | `total_count` | Общее количество товаров |
 | `total_cost` | Стоимость товаров (дубль `cart_cost`) |
 | `total_weight` | Общий вес |
+| `total_weight_formatted` | Общий вес с единицей измерения |
 | `total_discount` | Сумма скидки |
 | `total_positions` | Количество позиций (уникальных товаров) |
 

docs/components/minishop3/snippets/msproducts.md

@@ -366,6 +366,22 @@ title: msProducts
 - `{$tags}` — Теги (JSON)
 - `{$discount}` — Скидка в процентах (вычисляется автоматически)
 
+### Форматированные плейсхолдеры
+
+Плейсхолдеры с суффиксом `_formatted` содержат значение с символом валюты / единицей веса, отформатированное по настройкам `ms3_price_format`, `ms3_currency_symbol`, `ms3_currency_position` и `ms3_weight_unit`:
+
+- `{$price_formatted}` — Цена с валютой (например `1 234 ₽`)
+- `{$old_price_formatted}` — Старая цена с валютой
+- `{$cost_formatted}` — Стоимость с валютой
+- `{$old_cost_formatted}` — Старая стоимость с валютой
+- `{$weight_formatted}` — Вес с единицей (например `500 г`)
+- `{$discount_price_formatted}` — Скидка на единицу с валютой
+- `{$discount_cost_formatted}` — Скидка на позицию с валютой
+
+::: warning Breaking change (v1.7.0)
+`cost_formatted` теперь включает символ валюты. Кастомные чанки, добавляющие валюту вручную к `cost_formatted`, получат двойной символ.
+:::
+
 ### Поля производителя (Vendor)
 
 При `includeVendorFields`: