По расстоянию

По расстоянию

Плагин для расчёта стоимости доставки по автоматически посчитанному расстоянию

Плагин доставки для популярной платформы интернет-магазина HikaShop на CMS Joomla позволяет осуществлять расчёт маршрута и стоимости курьерской доставки от пункта отправителя до адреса, указанного в заказе. Так же плагин добавляет такие полезные функции, как:

  • геолокация (автоматическое определение адреса по местоположению);
  • подсказки мест при вводе адреса (по базе адресов Яндекс или Google);
  • отображение маршрута доставки на карте Яндекс или Google.

Плагин использует официальные API Яндекс и Google (при бесплатном использовании действует ограничение на количество запросов - не более 2 500 в сутки). Для работы плагина требуется Google API key (получить его можно быстро и бесплатно, смотрите инструкцию в подробном описании плагина). Внимание! Функция геолокации работает только на защищённых соединениях, то есть только при использовании протокола HTTPS (такова современная политика веб-безопасности).

Более подробное описание работы плагина смотрите ниже

Ещё чуть ниже смотрите пошаговую инструкцию по установке и настройке плагина

  • Лицензия на два сайта
  • Бесплатные обновления
  • Пожизненная техническая поддержка
  • При необходимости, адаптация плагина под ваши требования (за небольшую доплату)
  • Цена: 800

Текущая версия: 1.1.1 от 20.10.2017.


Описание работы плагина

Геолокация

Если в настройках способа доставки на основе плагина ByDistance включена опция "Геолокация", то во время оформления покупателем заказа на этапе ввода адреса срабатывает функция определения адреса по местоположению, при этом появляется запрос браузера на согласие пользователя на определение его местоположения и, при положительном ответе, происходит автоматическое заполнение поля address_street.

Для функции "Геолокация" требуется обязательное использование на сайте HTTPS-соединения, а так же в настройках браузера не должно быть явных запретов на геолокацию для данного узла или для всех узлов.

Подсказки мест

Функция подсказки мест срабатывает при оформении покупателем заказа при вводе текста в поле address_street. Когда пользователь начинает вводить адрес, функция подсказки мест производит поиск по базе Яндекс или Google (в зависимости от настроек способа доставки), предлагает подходящие варианты в виде выпадающего списка и завершает ввод адреса.

Маршрут на карте

Если в настройках способа доставки, созданного на основе плагина ByDistance, включена опция отображения маршрута доставки на карте Яндекс или Google, то при оформлении заказа на этапе выбора способа доставки появляется div-блок с картой Яндекс или Google и на ней отображается рассчитанный маршрут от пункта отправителя до адреса получателя.

В настройках способа доставки помимо выбора карты Яндекс или Google, так же можно настроить по своему усмотрению стили div-блока с картой (например, размеры блока). Адрес или географические координаты пункта отправителя так же указываются в настройках способа доставки.

Расчёт стоимости доставки

Ну и основная функция плагина - это определение расстояния от пункта отправителя до адреса получателя и расчёт стоимости доставки. В настройках способа доставки указывается стоимость 1 километра и исходя из этого рассчитывается полная стоимость доставки по указанному в заказе адресу.


Установка и настройка плагина

Шаг 1: Привязка доменов вашего сайта

После покупки плагина перейдите в раздел Личный кабинет и укажите к каким доменам вашего сайта следует привязать плагин, например: artpostel-shop.ru, www.artpostel-shop.ru. Вы можете указать до двух доменных имён для одной покупки плагина.

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

Шаг 2: Настройка Google APIs

  1. Перейдите в Google API Console. Нажмите кнопку "Выбрать проект" ("Select a project") и выберите проект или создайте новый.
  2. На странице "Панель управления" ("Dashboard") сверху выберите "ВКЛЮЧИТЬ API И СЕРВИСЫ" ("ENABLE API"), чтобы открыть вкладку "Библиотека" ("Library"). Альтернативный вариант - можно выбрать пункт "Библиотека" ("Library") в меню слева.
  3. Последовательно найдите и включите следующий набор API:
    • Google Maps JavaScript API;
    • Google Places API Web Service;
    • Google Maps Geocoding API;
    • Google Maps Directions API.
    Для того, чтобы включить API, необходимо найти его и выбрать из списка результатов поиска. Затем нажмите сверху "ВКЛЮЧИТЬ" ("ENABLE"). Когда процесс завершится, добавленный API появится в списке на панели "Панель управления" ("Dashboard").
  4. На странице "Панель управления" ("Dashboard") из списка добавленных API выберите Google Maps JavaScript API и затем выполните следующие действия:
    • нажмите кнопку "Создать" ("Create"), чтобы перейти к процедуре создания учётных данных;
    • на странице "Добавление учётных данных" нажмите кнопку "Выбрать тип учётных данных";
    • сохраните где-нибудь в текстовом редакторе созданный ключ Google API key и нажмите кнопку "Готово".

Шаг 3: Установка плагина

  1. Скачайте архив плагина в разделе Личный кабинет.
  2. Скачанный архив plg_bydistance.zip распаковывать не нужно!
  3. Откройте панель управления Joomla на вашем сайте и перейдите в подраздел Расширения Менеджер расширений Установить (Extensions Manage Install).
  4. Переключитесь на закладку Загрузить файл пакета (Upload Package File), выберите скачанный файл с архивом пакета plg_bydistance.zip и нажмите кнопку Загрузить и установить (Upload & Install).

Шаг 4: Настройка плагина

  1. Откройте панель управления Joomla на вашем сайте и перейдите в раздел Компоненты HikaShop (Components HikaShop).
  2. Перейдите в подраздел Система Способы доставки (System Shipping methods).
  3. Нажмите кнопку « Создать».
  4. В открывшемся окне найдите плагин "HikaShop ByDistance shipping plugin" и щёлкните по иконке «» в столбце "Включено". Иконка сменится на «».
  5. Щёлкните по ссылке "HikaShop ByDistance shipping plugin", в ответ откроется окно настроек плагина.
  6. В блоке "Общая конфигурация" напротив "Опубликовано" нажмите «Да».
  7. В блоке "Специальная конфигурация" настройте параметры плагина:
    Лицензия
    Лицензионный ключ вашего плагина (смотрите в Личном кабинете).
    Ключ Google API
    Ключ, который был получен при выполнении пункта 4 на "Шаге 2: Настройка Google APIs".
    Геолокация
    Выберите "Да" для активации функции автоматического определения адреса по местоположению при вводе адреса доставки или "Нет" для отключения данной функции.
    Маршрут на карте
    Выберите "Нет", если не хотите чтобы при оформлении заказа отображался div-блок с картой и маршрутом доставки на ней, или выберите Google или Яндекс для отображения, соответственно, карты Google или Яндекс. Данная настройка так же влияет на выбор поставщика сервиса (Google или Яндекс) при работе функции подсказки мест при заполнении адреса доставки. Если функция "Маршрут на карте" выключена, то для подсказки мест используется сервис Google.
    Адрес отправителя
    Введите адрес или географические координаты пункта, откуда будет осуществляться доставка. От этого адреса будет происходить поиск маршрута при расчёте стоимости доставки. Вы можете воспользоваться функцией геолокации для определения своего местоположения и автоматического заполнения адреса, для этого нажмите кнопку справа от поля для ввода адреса (геолокация работает только при использовании HTTPS-соединения с сайтом). А так же в поле ввода адреса отправителя реализована функция подсказки мест на основе сервиса Google.
    Центр карты
    Укажите адрес или географические координаты центра карты. Обычно сюда вводят координаты адреса отправителя. Кстати, если воспользоваться функцией геолокации при вводе адреса отправителя, то поле "Центр карты" заполнится автоматически.
    CSS-стили карты
    Вы можете настроить по своему усмотрению стили отображения div-блока с картой. По умолчанию используются следующие стили: width: 100%; height: 200px; background-color: grey
    Цена за 1 км
    Введите стоимость одного километра доставки для расчёта полной стоимости доставки.
    Наценка за обработку заказа
    Можете указать здесь любую сумму в рублях, которая будет единоразово добавлена к стоимости доставки. Таким образом, вы можете компенсировать свои расходы на обработку заказа или упаковку.
    Округлять стоимость доставки до десяти рублей
    При включенной опции стоимость тарифа будет округлена с точностью до 10 рублей.
    Отладка плагина
    При включенной опции во фронт-энде сайта выводятся диагностические сообщения плагина. Рекомендую включить только на этапе отладки плагина, но затем не забудьте её отключить!
  8. Нажмите кнопку « Сохранить и закрыть»

Шаг 5: Проверьте работу плагина

...и наслаждайтесь ;)