Установка

Способы установки виджета

Есть два способа установки виджета:

1. Локальная — когда все файлы размещаются на вашем сервере.
2. Минимальная — когда все файлы грузятся с нашего сайта, а с вашего сайта подгружается только данные с авторизацией.
   

Локальная установка позволяет держать все файлы на вашем сервере, что обеспечивает более быструю загрузку скриптов, по сравнению с минимальной. Также данный тип установки позволяет редактировать скрипты, стили оформления виджета под ваши требования. Минимальная установка хороша тем, что необходимо отредактировать только 1 файл и указать на него ссылку в скрипте.

Распаковка архива

Для установки виджета необходимо распаковать архив с виджетом. Внутри архива содержится:

• файл Документация_v.2.2.0.docx;
• скрипты виджета - директория widget;
• примеры работы виджета - директория examples;
• краткая инструкция по установке виджета - файл index.php.
  
  

Для локальной установки виджета необходимо скопировать директорию widget в директорию сайта: Например сайт расположен в директории /home/site/, копируем каталог с виджетом и тогда полный путь к виджету будет /home/site/widget/ Зависимость расположений скриптов должна быть сохранена. Обратите внимание, что в сборке виджета есть серверный файл (widget/scripts/service.php).

Для минимальной установки виджета необходимо скопировать только серверный файл (widget/scripts/service.php) к себе на сайт, например в директорию /home/site/widget/scripts/service.php

Авторизация и настройка

Для корректного расчета стоимости доставки виджету необходимы авторизационные данные для доступа к сервису интеграции СДЭК.
Получить их можно по запросу на электронную почту integrator@cdek.ru, указав ваш номер договора. Чтобы ввести данные, откройте файл scripts/service.php. Данные вводятся в 17-й (account) и 18-й (key) строках внутри кавычек.
Если необходимо изменить приоритет расчета тарифов, измените их последовательность в строках 5 (доставка курьером) и 6 (самовывоз из ПВЗ). Номера тарифов можно получить в документации к сервису интеграции, скачать которую можно по ссылке.

Подключение скриптов

Для подключения локальной версии виджета необходимо на нужную страницу добавить код (рекомендуется его расположить внутри тега ):

<script type="text/javascript" src="widget/widjet.js" id="ISDEKscript" ></script>

Для подключения минимальной версии виджета необходимо на нужную страницу добавить код (рекомендуется его расположить внутри тега ):

<script type="text/javascript" id="ISDEKscript" src="https://www.cdek.ru/website/edostavka/template/js/widjet.js"></script>

Размещение виджета на странице

На страницу необходимо добавить элемент, в который будет встроен виджет. Данному элементу следует указать высоту, иначе он может принять значение высоты равной 0 и виджет на странице не будет видно.

<div id="forpvz" style="height:600px;"></div>

Далее необходимо создать обработчик для инициализации виджета: Для локальной версии виджета обработчик с минимальным числом параметров будет выглядеть так:

<script type="text/javascript">
   var widjet = new ISDEKWidjet({
       defaultCity: 'Уфа',
       cityFrom: 'Омск',
       link: 'forpvz'
   });
</script>

Для минимальной установки виджета наименьшее число параметров будет выглядеть таким образом:

<script type="text/javascript">
   var widjet = new ISDEKWidjet({
       defaultCity: 'Уфа',
       cityFrom: 'Омск',
       link: 'forpvz',
       path: 'https://www.cdek.ru/website/edostavka/template/scripts/',
       servicepath: 'http://yoursite.net/service.php' //ссылка на файл service.php на вашем сайте
   });
</script>

Дополнительная информация по установке: ссылка