MS: Дробный остаток

Описание

Модуль ms_fractional_stock позволяет продавать определенное количество товара или товар с плавающей величиной. Модуль подходит для продажи продуктов питания (в граммах, килограммах), продуктов продаваемых в упаковках (ящики, коробки) и других товаров, которые имеют плавающую сумму.

Основные возможности

• Дробные количества: Возможность продажи товаров с дробными количествами (например, 1.5 кг, 2.3 л)
• Единицы измерения: Настройка единиц измерения количества для товаров (шт., кг, л, м и т.д.)
• Шаг изменения количества: Настройка шага изменения количества товара (например, 0.1, 0.5, 1)
• Минимальное и максимальное количество: Ограничение минимального и максимального количества для заказа
• Глобальные настройки: Глобальные настройки для всех товаров или индивидуальные настройки для каждого товара
• Интеграция с модулем складов: Работа с модулем warehouses для учета дробных остатков на складах
• Импорт/Экспорт: Поддержка импорта и экспорта дробных количеств через CommerceML и стандартный импорт/экспорт

Как работает модуль

Модуль использует следующие механизмы:

1. База данных (upgrades/migrations/): При установке модуль выполняет миграции для создания необходимых полей:

• allow_fractional_amount в таблице products - разрешение дробного остатка для товара
• ms_fractional_stock_use_global_settings в таблице products - использование глобальных настроек
• ms_unit_measure в таблице product_descriptions - единица измерения количества
• ms_step_qty в таблице products - шаг изменения количества
• ms_min_qty в таблице products - минимальное количество для заказа
• ms_max_qty в таблице products - максимальное количество для заказа

1. Функции работы с дробными количествами (func.php):

• fn_ms_fractional_stock_get_product_ms_unit_measure() - получает единицу измерения для товара
• fn_ms_fractional_stock_get_allow_fractional_amount() - проверяет, разрешен ли дробный остаток для товара
• fn_ms_fractional_stock_get_ms_step_qty() - получает шаг изменения количества
• fn_ms_fractional_stock_get_product_min_qty() - получает минимальное количество
• fn_ms_fractional_stock_get_product_max_qty() - получает максимальное количество

1. Хуки корзины (hooks.func.php):

• fn_ms_fractional_stock_add_product_to_cart_post_normalize_amount() - нормализует количество при добавлении в корзину:
• Округляет количество до шага изменения
• Проверяет минимальное и максимальное количество
• fn_ms_fractional_stock_update_cart_products_normalize_amount_post() - нормализует количество при обновлении корзины

1. Хуки товаров (hooks.func.php):

• Множество хуков для обработки дробных количеств при различных операциях с товарами
• Интеграция с модулем складов для учета дробных остатков

1. Схемы импорта/экспорта:

• Расширение схем импорта/экспорта для работы с дробными количествами
• Поддержка CommerceML для импорта дробных количеств

1. JavaScript (js/addons/ms_fractional_stock/):

• Обработка ввода дробных количеств на витрине
• Валидация и нормализация количеств в корзине

Где находится функциональность

• Административная панель:
• Настройки модуля с глобальными параметрами
• Карточка товара с настройками дробного остатка
• Массовое обновление товаров с дробными количествами
• Витрина:
• Страница товара с полем ввода дробного количества
• Корзина с отображением дробных количеств
• Оформление заказа с дробными количествами

Настройки модуля

• Использовать дробный остаток (allow_fractional_amount): Глобальная настройка включения/выключения дробного остатка
• Единица измерение количества (unit_measure): Глобальная единица измерения (по умолчанию "шт.")

Настройки товара

Для каждого товара можно настроить:

• Использовать дробный остаток: Включить/выключить для конкретного товара
• Использовать глобальные настройки: Использовать глобальные настройки модуля
• Единица измерения количества: Единица измерения для товара (кг, л, м, шт. и т.д.)
• Шаг изменения количества товара: Шаг изменения (например, 0.1, 0.5, 1)
• Минимальное количество товара для заказа: Минимальное количество
• Максимальное количество для покупки одного товара: Максимальное количество

Технические детали

• Модуль автоматически устанавливается в мультивендор и Ultimate редакции CS-Cart
• При установке выполняет миграции для создания необходимых полей в таблицах
• Конфликтует с модулем csc_fractional_stock (нельзя использовать одновременно)
• Интегрируется с модулем warehouses для учета дробных остатков на складах
• Поддерживает импорт/экспорт через CommerceML и стандартный импорт/экспорт CS-Cart