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

Перед началом

Посмотреть Demo

Создайте виджет

  1. Войдите в аккаунт компании и откройте раздел Виджет записи на этой странице.

  2. Укажите домен сайта, на котором будет стоять виджет, - например, salon.rs. Версия с www разрешается сама. Если виджет нужен на поддоменах, укажите *.salon.rs: так разрешены и все поддомены, и сам salon.rs.

  3. Сохраните - появится код для вставки.

Настроить виджет

Вставьте виджет на страницу

Вставьте код в то место страницы, где должен быть календарь:

<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

Если страницу собирает 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 - причина, см. ниже

Если виджет не появился

Что дальше