msRussianPost

Калькулятор стоимости и сроков доставки через Почту России
Автор дополнения
Воеводский Михаил
Пакетов
7
Закачек
670
Автор дополнения
Пакетов
7
Закачек
670
Версия 1.0.5-pl1
Дата выпуска 05.07.2016
Загрузки 90
Просмотры 36
Внимание, этот компонент требует версию PHP 5.3 или выше! Если ваш сайт использует PHP ниже требуемого, установка этого дополнения может его сломать.

msRussianPost позволяет рассчитывать стоимость доставки, с учетом веса заказа и стоимости всех товаров, для всех основных типов перевозок Почтой России.


Особенности


  1. Учет стоимости и веса товаров в заказе
  2. Вывод стоимости доставки с учетом страхования
  3. Вывод сроков доставки
  4. Сниппет для расчета доставки в карточке товара
  5. Кэширование результатов расчета
  6. Совместимость с msCDEK при расчете сроков доставки

Поддерживаемые типы отправлений:


  1. Простая бандероль
  2. Заказная бандероль
  3. Заказная бандероль 1 класс
  4. Ценная бандероль
  5. Ценная посылка
  6. Ценная авиабандероль
  7. Ценная авиапосылка
  8. Ценная бандероль 1 класс
  9. Курьерская доставка EMS
Помимо стоимости, рассчитывается срок доставки.

Данный компонент возможно использовать вместе с компонентом msCDEK – они унифицированы.


Установка


Шаг 1: только стоимость доставки


После установки создается 9 новых способов доставки, по умолчанию они все выключены. Включите требуемые, не забыв отметить доступные способы оплаты.


В чанке tpl.msOrder.outer замените поле ввода города на вызов чанка [[$tpl.msRussianPost.city]]. В данном чанке находится вызов сниппета для вывода списка городов и скрипт для динамического пересчета стоимости после выбора другого города


Шаг 2: срок доставки


В чанке tpl.msOrder.outer добавьте в удобное место вызов чанка [[$tpl.msRussianPost.time]], в нем находится контейнер для вывода срока доставки.


Расчет в карточке товара


Для расчета в карточке товара используется сниппет msRussianPost. Его параметры:


&tpl — Чанк оформления. По умолчанию: 'tpl.msRussianPost.delivery'


&sending — Тип отправления, указывается название. По умолчанию: 'Ценная посылка'


&weight — Вес отправления. По умолчанию: '1'


&cost — Стоимость отправления в рублях. По умолчанию: '0'


&to — Пункт назначения. По умолчанию:'Москва'


&toPlaceholder — Если указано, все результаты сохраняются в плейсхолдер с указанным именем. По умолчанию: 'false'


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


msrussianpost_from_index — Индекс места отправления. По умолчанию: '190000' (Главпочтамт г. Санкт-Петербург)


ms2_delivery_weight_in_kg — Если включено, то вес отправления считается в килограммах. В противном случае – в граммах. По умолчанию: Включено


msrussianpost_cache_ttl — Время жизни результатов расчета в кэше, в секундах. По умолчанию:'604800'


msrussianpost_response_to_modx_log — Возможность отправить ответ сервиса расчетов в лог ошибок MODX на уровне ERROR. Может быть полезно при разработке, но на реальных проектах настоятельно рекомендуется отключать. По умолчанию: Отключено


Совместимость с msCDEK


Для вывода срока доставки используется отправка и обработка запроса происходит одинаково в обоих компонентах, используются переменные с одинаковыми названиями.


Это позволяет, например, корректно выводить результаты расчета для доставок через Почту России, используя чанки от msCDEK.


Нюанс: сниппет пунктов назначения для Почты России возвращает города и области, однако СДЕК не принимает названия областей для расчета. По этой причине при совместном использовании компонентов рекомендуется использовать чанк выбора города от компонента msCDEK.


Разработчик благодарит сервис postcalc.ru за возможность создания данного компонента.



Обсуждение компонента в сообществе MODX.PRO

1.0.5-pl1

  • Скорректирован расчет стоимости, если не задан вес для товаров

1.0.5-beta2

  • Добавлена системная настройка msrussianpost_return_time, при отключении которой срок доставки не выводится
  • Скорректированы лексиконы

1.0.5-beta1

  • В случае отсутствия возможности доставки определенным методом добавлен вывод сообщения вместо подстановки максимальных значений

1.0.4-pl2

  • Исправлен вывод сообщения о сроке доставки с учетом лексиконов
  • Исправлен вывод названия "пустого" пункта в списке городов
  • Добавлен лексикон для системной настройки с путем к файлу JS

1.0.4-pl

  • Добавлена совместимость с компонентом msDelline2
  • Текстовые значения перенесены в словари
  • Добавлено округление стоимости доставки

1.0.3-pl

  • Изменение JS для корректной записи выбранного города в сессию до запроса стоимости доставки (спасибо Kyrt God)
  • Подстановка выбранного ранее города при перезагрузке страницы заказа (спасибо Kyrt God)
  • Добавлена поддержка рассчитываемой по весу стоимости и дополнительной стоимости: число (+/-) или %, который будет рассчитан относительно стоимости доставки
  • Заменен давно устаревший плагин

1.0.2-pl2

  • JS код из чанка выбора города вынесен в отдельный файл

1.0.2-pl

  • В системные настройки добавлено значение веса по умолчанию
  • Отключена повторная инифиализация MS2, если он проинициализирован ранее
  • MS2 инициализируется в текущем контексте вместо стандартного web
  • Добавлена проверка заполнения города, устранена избыточная генерация предупреждения PHP в логах
  • Удален стандартный пункт меню

1.0.1-pl

  • Исправление для поддержки PHP 5.3
  • Исправлен в JS адрес для AJAX запросов
  • Исправлена ошибка установки в MODX 2.4

1.0.0-pl

  • Публичный выпуск

Последние обсуждения в сообществе MODX.pro