Карточный виджет показывает доступные варианты доставки для выбранного региона. Встроив этот виджет на страницу товара, вы предоставите своим клиентам информацию о примерных сроках и стоимости доставки.
Разместите код внутри тега <head>:
<script src="https://widgets.saferoute.ru/card/api.js"></script>Затем разместите код в том месте страницы, где должен располагаться виджет:
<div id="saferoute-card-widget"></div>// Инициализация виджета
new SafeRouteCardWidget("saferoute-card-widget", {
apiScript: "/saferoute-widget-api.php",
});Конструктор SafeRouteCardWidget() принимает 2 аргумента:
| Параметр | Тип | Допустимые значения | Описание |
|---|---|---|---|
apiScript |
string | – |
Путь к API-скрипту (скачать API-скрипт). Если не указать, по умолчанию виджет будет обращаться по адресу |
lang |
string | 'ru', 'en' |
Язык интерфейса виджета: русский (по умолчанию), английский. |
kladr |
string | – |
КЛАДР населённого пункта пользователя. Если передан, в виджете сразу будет выбран соответствующий населённый пункт. |
fias |
string | – |
ФИАС населённого пункта пользователя. Если передан, в виджете сразу будет выбран соответствующий населённый пункт. |
regionName |
string | – |
Название населённого пункта пользователя (например, «Москва», «Казань»). Наименее предпочтительный способ, рекомендуется использовать КЛАДР и ФИАС. |
priceDeclared |
number | ≥ 0 | Оценочная стоимость. |
priceCod |
number | ≥ 0 | Наложенный платёж. |
currency |
string | 'rub', 'usd', 'euro' |
Валюта, в которой будут выведены цены: рубль (по умолчанию), доллар США, евро. Также определяет валюту, в которой передаются |
width |
number | 0 – 999 |
Ширина в см. Дробные значения округляются. Если не задана, берётся значение по умолчанию из настроек виджета. |
height |
number | 0 – 999 |
Высота в см. Дробные значения округляются. Если не задана, берётся значение по умолчанию из настроек виджета. |
length |
number | 0 – 999 |
Длина в см. Дробные значения округляются. Если не задана, берётся значение по умолчанию из настроек виджета. |
weight |
number | 0 – 999 |
Вес в кг. Может быть дробным. Если не задан, берётся значение по умолчанию из настроек виджета. |
Если виджету не был передан ни kladr, ни fias, ни regionName, он попытается определить населённый пункт по IP-адресу пользователя. В случае, если определить населённый пункт не удалось, пользователю будет предложено указать его самостоятельно.
Чтобы попасть в настройки виджета, зайдите в Личный кабинет SafeRoute, перейдите в раздел «Настройки» > «Магазины». Откройте тот магазин из списка, для которого требуется настроить виджет. На странице магазина нажмите кнопку «Настройки виджетов». В открывшейся панели перейдите в раздел «Карточный виджет».
Для работы виджета вам необходимо установить на своём сервере наш API-скрипт и прописать путь к этому скрипту в параметре apiScript виджета.
Скрипт необходим для взаимодействия виджета с сервером SafeRoute и не требует никаких дополнительных настроек, кроме указания в нем вашего токена и ID магазина.
Откройте файл saferoute-widget-api.php и в строке
$widgetApi->setToken('');вставьте токен, который выводится на странице вашего профиля в Личном кабинете SafeRoute.
А в строке
$widgetApi->setShopId('');вставьте ID магазина со страницы вашего магазина в Личном кабинете SafeRoute.