Документация к виджету-калькулятору

Назначение виджета.

Виджет-калькулятор выводит список всех возможных вариантов доставки (включая карту с точками ПВЗ) до указанного города или адреса. Через виджет можно получить информацию о сроках и стоимости доставки, доступных услугах и вариантах оплаты.

Установка на сайт.

Разместите код внутри тега <head>:

1 <script src="https://widgets.saferoute.ru/cart/api.js?new"></script>

Затем разместите код в том месте страницы, где должен располагаться виджет:

1 <div id="saferoute-calculator-widget"></div>

Запуск виджета.

1 2 3 4 // Инициализация виджета new SafeRouteCalculatorWidget("saferoute-calculator-widget", { apiScript: "/saferoute-widget-api.php" });

Конструктор SafeRouteCalculatorWidget() принимает 2 аргумента:

  • ID DOM-элемента, внутри которого должен инициализироваться виджет;

  • Объект с параметрами виджета.

Список параметров и данных, которые можно передавать конструктору.

Параметр

Тип

Допустимые значения

Описание

Параметр

Тип

Допустимые значения

Описание

apiScript

string

Путь к API-скрипту (скачать API-скрипт).
Если не указать, по умолчанию виджет будет обращаться по адресу "/saferoute-widget-api.php".

lang

string

'ru', 'en'

Язык интерфейса виджета: русский (по умолчанию), английский.

kladr

string

КЛАДР населенного пункта пользователя.

Если передан, в виджете сразу будет выбран соответствующий населенный пункт.

fias

string

ФИАС населенного пункта пользователя.

Если передан, в виджете сразу будет выбран соответствующий населенный пункт.

regionName

string

Название населенного пункта пользователя (например, «Москва», «Казань»).

Наименее предпочтительный способ, рекомендуется использовать КЛАДР и ФИАС.

currency

number

'rub', 'usd', 'euro'

Валюта, в которой будут выведены цены: рубль (по умолчанию), доллар США, евро.