Виджет записи показывает календарь UzmiTermin прямо на вашем сайте: клиент видит мастеров, услуги и свободное время и записывается, не уходя со страницы. Запись появляется у вас в UzmiTermin, уведомления уходят как обычно. В этом руководстве вы создадите виджет, вставите его на страницу и настроите под свой сайт.
Войдите в аккаунт компании и откройте раздел Виджет записи на этой странице.
Укажите домен сайта, на котором будет стоять виджет, - например, salon.rs. Версия с www разрешается сама. Если виджет нужен на поддоменах, укажите *.salon.rs: так разрешены и все поддомены, и сам salon.rs.
Сохраните - появится код для вставки.
Вставьте код в то место страницы, где должен быть календарь:
<script src="https://widget.uzmitermin.rs/e/YOUR_TOKEN.js" async></script>
Виджет займёт всю ширину блока, а высоту подстроит под содержимое - прокрутки внутри не будет. Когда клиент выбирает время, окно записи открывается поверх всей страницы, а после записи страница остаётся там же, где была.
Чтобы поставить виджет не рядом с кодом, а в другой блок, укажите этот блок атрибутом data-target:
<div id="booking"></div>
<script src="https://widget.uzmitermin.rs/e/YOUR_TOKEN.js" data-target="#booking" async></script>
Если страницу собирает React (Next.js, Gatsby, Remix и т.п.), тег <script> нельзя просто вставить в JSX. Next.js отрисовывает страницу на сервере, а виджет успевает вставить календарь до того, как React подхватит страницу. React видит не ту разметку, что пришла с сервера, и падает с ошибкой гидрации (Minified React error #418). Кроме того, при переходе на страницу по ссылке внутри сайта такой тег вообще не выполняется.
Вставляйте тег из кода после того, как компонент появился на странице:
'use client';
import { useEffect, useRef } from 'react';
export const BookingWidget = () => {
const ref = useRef<HTMLDivElement>(null);
useEffect(() => {
const container = ref.current;
if(!container)
return;
const script = document.createElement('script');
script.src = 'https://widget.uzmitermin.rs/e/YOUR_TOKEN.js';
script.async = true;
// Атрибуты из таблицы ниже: script.dataset.lang = 'ru';
container.appendChild(script);
return () => container.replaceChildren();
}, []);
return <div ref={ref} />;
};
Поставьте <BookingWidget /> туда, где должен быть календарь. Атрибуты из таблицы ниже задаются через script.dataset: data-lang - это script.dataset.lang, data-primary - script.dataset.primary. Во Vue, Svelte и других фреймворках так же: создайте тег в onMounted или его аналоге и удалите при размонтировании.
Готовый код с вашим токеном - на вкладке React / Next.js в разделе Виджет записи.
Язык и цвета задаются в разделе Виджет записи или атрибутами прямо в коде. Атрибут главнее: так на разных страницах сайта виджет можно показать по-разному.
<script
src="https://widget.uzmitermin.rs/e/YOUR_TOKEN.js"
data-lang="ru"
data-primary="#2e7d32"
data-background="transparent"
async
></script>
| Атрибут | Что задаёт | Значения |
|---|---|---|
data-lang | Язык виджета | sr, en, ru. Если не задан ни здесь, ни в настройках - язык страницы, затем язык браузера |
data-primary | Основной цвет: кнопки, выбранный мастер и услуги, сегодняшний день | Цвет в формате #rrggbb. Цвет текста на кнопках - белый или тёмный - подбирается сам |
data-background | Фон виджета | Цвет #rrggbb или transparent - тогда виден фон вашей страницы |
data-surface | Фон шапки календаря с датой и днями недели | Цвет #rrggbb |
data-master | Сразу открыть календарь одного мастера | Идентификатор мастера из раздела Виджет записи |
data-target | Блок, в который встанет виджет | CSS-селектор, например #booking |
Если значение атрибута указано с ошибкой, виджет его не применит и возьмёт настройку из раздела Виджет записи.
Виджет сообщает странице о том, что в нём происходит, событиями на window. Например, так можно передать запись в свою аналитику:
window.addEventListener('uzmi:booked', (event) => {
gtag('event', 'booking', { appointment_id: event.detail.appointmentId });
});
| Событие | Когда | Данные в event.detail |
|---|---|---|
uzmi:ready | Виджет загрузился | - |
uzmi:booked | Клиент записался | appointmentId |
uzmi:unavailable | Виджет не может принимать записи | code - причина, см. ниже |
book.salon.rs разрешены, только если указан *.salon.rs.code: WIDGET_DISABLED), закончилась подписка (SUBSCRIPTION_INACTIVE) или виджет не входит в ваш тариф (PLAN_NOT_ALLOWED).NOT_FOUND) - например, после того как токен сменили. Скопируйте код из раздела Виджет записи заново.