MS: Расписание доставки

Описание

Модуль ms_delivery_schedule добавляет график доступности способов доставки и позволяет покупателям выбрать дату доставки при оформлении заказа. Модуль позволяет настроить расписание работы доставки по дням недели с указанием временных интервалов.

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

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

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

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

1. Хранение расписания (hooks.func.php):

• Расписание хранится в сериализованном виде в поле schedule таблицы shippings
• Структура: [день_недели] => [временные_интервалы], где день недели: 0-6 (0=воскресенье, 1=понедельник, ..., 6=суббота)
• Поддерживает множественные временные интервалы для одного дня

1. Сериализация расписания (hooks.func.php):

• Функция fn_ms_delivery_schedule_update_shipping() сериализует расписание перед сохранением
• Поддерживает новую структуру с множественными интервалами и старую структуру (для обратной совместимости)
• Преобразует дни недели: 1-7 (из формы) → 0-6 (в базе данных), где 7 → 0 (воскресенье)

1. Десериализация расписания (hooks.func.php):

• Функция fn_ms_delivery_schedule_get_shipping_info_after_select() десериализует расписание после получения из базы данных
• Преобразует дни недели обратно: 0-6 → 1-7 для отображения в форме
• Разворачивает множественные временные интервалы для отображения

1. Контроллер выбора даты (controllers/frontend/checkout.post.php):

• Обрабатывает выбор даты доставки покупателем
• Сохраняет выбранную дату и время в сессию корзины
• Определяет день недели выбранной даты и загружает доступные временные интервалы

1. Отображение на странице оформления (controllers/frontend/checkout.post.php):

• Режим checkout передает расписания доставки в шаблон
• Включает информацию о минимальном времени до начала доставки и ограничении по дням

1. Миграции базы данных: При установке модуль выполняет миграции для добавления полей schedule, schedule_time, schedule_days в таблицу способов доставки.

1. Сохранение в заказе: Выбранная дата и время доставки сохраняются в таблице ms_delivery_schedule_orders_time для каждого поставщика отдельно.

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

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

Настройки способа доставки

• MS: Расписание доставки: Раздел настроек расписания
• Доступность в часах (schedule_time): Количество часов до крайнего времени доставки, чтобы день был доступен для заказа
• Ограничение в днях (schedule_days): Количество дней вперед, на которое ограничивается календарь доставки
• Расписание по дням недели: Настройка временных интервалов для каждого дня недели (например, "09:00 - 18:00")
• Отображать дату при оформлении заказа (show_date_in_checkout): Показывать ли поле выбора даты
• Отображать время при оформлении заказа (show_time_in_checkout): Показывать ли поле выбора времени

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

• Модуль автоматически устанавливается в мультивендор и Ultimate редакции CS-Cart
• При установке выполняет миграции для добавления полей в таблицу способов доставки
• Создает таблицу ms_delivery_schedule_orders_time для хранения выбранных дат и времени доставки
• Поддерживает множественные временные интервалы для одного дня недели
• Интегрируется с модулем suppliers для работы с несколькими поставщиками в одном заказе