Установка скрипта «Интеграция доставки ТК «Деловые линии»

Введение

Благодарим за покупку скрипта! Установка скриптового решения займет некоторое время. Пожалуйста, внимательно читайте инструкции и старайтесь следовать всем рекомендациям.

Решение интегрирует калькулятор расчета стоимости и сроков доставки товара транспортной компанией «Деловые линии» с помощью API.

Для расчета стоимости доставки требуется знать общий вес товара, его объем, город отправителя и город получателя. Если бы все эти данные заполнял пользователь, то скорее всего он бы просто ушел.

Данное решение берет общий вес товара, считает общий объем товара (вам нужно только указать номер дополнительного поля в котором хранится объем), город отправителя указывается в настройках скрипта, а пользователю остается ввести только город, в который необходимо осуществить доставку. Для городов, в которых присутствует терминалы ТК «Деловые линии», рядом с полем ввода, будет выведена информация о сроках доставки. Для других населенных пунктов эта информация не доступна.

При выборе другого способа доставки поле с вводом города разумеется скрывается.

    Преимущества данного решения:
  • использование API ТК «Деловые линии»;
  • установка города отправителя или своего списка городов;
  • возможность прибавлять/не прибавлять стоимость доставки к общей стоимости;
  • возможность прибавлять к стоимости доставки свою фиксированную сумму;
  • возможность прибавлять к стоимости доставки процент от стоимости товара;
  • управление шаблоном вывода;
  • дублирование города доставки в поле заказа.

В зависимости от спроса этого продукта, а так же от ваших комментариев и предложений скрипт будет обновляться и дополняться, в т.ч. такими параметрами как негабаритные части товара, страховка груза и пр.

    Требования к установке:
  • активированное PHP;

Используется библиотека jQueryUI (распространяется бесплатно по лицензии MIT)


Перед установкой, сделайте полный бэкап шаблонов на случай, если вы в какой-то момент решите вернуть прежний вид сайту или отдельным его элементам. Сделать это можно в Панели управления » Управление дизайном » Backup шаблонов.

Первый шаг: активация PHP

Убедитесь, что на вашем сайте активна услуга PHP. Для этого перейдите на главную страницу панели управления и обратите внимание на правую часть страницы. В случае наличия активной услуги вы увидите текст "PHP детали".
– перейдите к следующему шагу установки, PHP-услуга у вас активна. Если такой текст отсутствует, значит услуга PHP отключена или просрочена. Для подключения PHP необходимо оплатить премиум пакет, включающий возможность использования PHP-скриптов, либо заказать данную услугу отдельно.

Второй шаг: загрузка скриптов на FTP PHP


Этап 1. Установка пароля

Если у вас задан пароль к FTP PHP, сразу же переходите к следующему этапу.

Перейдите на главную страницу панели управления вашим сайтом, в правой верхней части нажмите на ссылку «PHP детали».
В открывшемся окне кликните на ссылку: «Пароль не установлен.
Мы попадем на страницу установки пароля на FTP PHP. Заполните поля, продолжайте следовать инструкциям системы.

Этап 2. Подключение к PHP FTP серверу

После установки пароля, скачайте FTP-клиент, рекомендуем бесплатный FTP клиент FileZilla. После установки программы, в верхней части вводим параметры подключения:

  • Сервер: s2000.ucoz.net
  • Логин (FTP login): введите свой логин, который указан в меню "PHP детали"
  • Пароль: пароль который вы ввели ранее в специальном разделе

После заполнения полей нажмите на кнопку «Быстрое соединение».


Этап 3. Загрузка скриптов на PHP FTP сервер

После успешного подключения вы увидите каталог под именем «scripts» в правой части окна программы. Обязательно переходим в этот каталог двойным кликом по нему.

Теперь загрузите в этот каталог папку из архива со скриптом «delivery». Загрузить легко, просто перетащите эту папку в правый диалог (где отображаются каталоги и файлы хранящиеся на сервере).
Узнать статус передачи файлов вы можете в окне статуса, которое находится в нижней части программы, там отображаются файлы которые ожидают передачи и те, которые не удалось передать, в частности которые были успешно переданы.
Перед загрузкой файлов укажите в файле user_id.txt (в папке «delivery») id пользователя, которому будет предоставлен доступ к установочному файлу.

Третий шаг: загрузка файлов на сайт


Перейдите в Панель управления » Файловый менеджер.
В правом верхнем углу кликните на кнопку "Создать папку", введите название папки js.


Теперь зайдите в папку js и загрузите в эту папку файлы "delivery.min.js" и "jquery-ui.min.js" из архива со скриптом (папка "скрипты").
Обратите внимание, на библиотеку jquery-ui.min.js. Если вы уверены, что на вашем сайте уже подключена эта библиотека, то загружать и подключать ее не нужно.
По аналогии создайте папку images и загрузите в эту папку файлы из папки "изображения" из архива со скриптом.

Четвёртый шаг: установка CSS стилей

Перейдите в Панель управления » Интернет-магазин » CSS и в самом конце пропишите следующий код:
.ui-autocomplete{position:absolute;top:0;left:0;cursor:default;background:#fff;border:1px solid #ccc;max-height:200px;overflow-y:auto;overflow-x:hidden;}
.ui-menu{list-style:none;padding:0;margin:0;display:block;outline:none}
.ui-menu .ui-menu{position:absolute}
.ui-menu .ui-menu-item{position:relative;padding:3px 1em 3px .4em;margin:0px;cursor:pointer;min-height:0;list-style:none;display:block}
.ui-menu .ui-menu-item:hover{background: #e6e6e6}
.ui-menu .ui-menu-divider{margin:5px 0;height:0;font-size:0;line-height:0;border-width:1px 0 0 0}
.ui-menu .ui-state-focus,.ui-menu .ui-state-active{margin:0px}
.ui-menu .ui-menu-icon{left:auto;right:0}
.ui-autocomplete-loading{background: #fff url('/images/ajsml.gif') center right no-repeat !important;}
#city {width:300px;}
    Информация о классах:
  • ui-autocomplete – выпадающее окно со списком городов;
    • ui-autocomplete-loading – состояние окна при загрузке списка;
  • ui-menu – список городов;
    • ui-menu-item – отдельный пункт в списке;
  • #city – поле ввода города доставки;

Пятый шаг: размещение кода на страницах сайта


Перейдите в Панель управления » Интернет-магазин » Управление дизайном модуля.

Откройте шаблон "Страница служебных форм" и перед </body> установите следующий код:
<?if($PAGE_ID$=='checkout')?>
    <script type="text/javascript" src="/js/jquery-ui.min.js"></script>
    <script type="text/javascript" src="/js/delivery.min.js"></script>
    <script type="text/javascript">
        $(function () {
            AddDL ('$ORDER_WEIGHT$', $ORDER_TOTAL_RAW$, 1);
        });
    </script>
<?endif?>
Внимание! Цифра 1 - это номер дополнительного поля, в котором присутствует объем товара. Если для хранения объема товара вы используете дополнительное поле № 5, то замените еденицу на 5."
Теперь перейдите в Панель управления » Интернет-магазин » Способы оплаты, доставки, валюты и курсы.

Намите на ссылку "Добавить способ доставки", введите название способа доставки "Доставка ТК "Деловые линии" и сохраните.

После вашего описания доставки добавьте код

<div id="dl" style="display: none"></div>

Активируйте галочку напротив пункта "Использовать модуль расчёта стоимости доставки", в выпадающем списке выберите "Внешний калькулятор". Далее нажимаем "Настройки модуля" и в появившемся окне ставим галочку "Разрешить нулевую величину". Сохраняем.

Осталось перейти по адресу http://ваш_сайт.ру/php/delivery/install.php и настроить скрипт "под себя".

Внимание! Чтобы попасть в настройки по адресу http://ваш_сайт.ру/php/delivery/install.php Вы должны быть авторизованы на сайте под тем пользователем, ID которого вы указали в шаге 2 (файл user_id.txt). Это сделано в целях защиты чтобы никто кроме вас не смог попасть в настройки."
Установка завершена. Если у вас возникли вопросы, которые не затрагивались в документации, спрашивайте в комментариях к товару.