Vidžet za zakazivanje prikazuje UzmiTermin kalendar direktno na vašem sajtu: klijent vidi majstore, usluge i slobodne termine i zakazuje ne napuštajući stranicu. Rezervacija stiže kod vas u UzmiTermin, obaveštenja se šalju kao i obično. U ovom vodiču napravićete vidžet, ubaciti ga na stranicu i podesiti prema svom sajtu.
Prijavite se na nalog kompanije i otvorite odeljak Vidžet za zakazivanje na ovoj stranici.
Navedite domen sajta na kome će stajati vidžet - na primer, salon.rs. Verzija sa www je dozvoljena automatski. Ako vam vidžet treba na poddomenima, navedite *.salon.rs: tako su dozvoljeni i svi poddomeni i sam salon.rs.
Sačuvajte - pojaviće se kod za ubacivanje.
Ubacite kod na mesto na stranici gde treba da bude kalendar:
<script src="https://widget.uzmitermin.rs/e/YOUR_TOKEN.js" async></script>
Vidžet će zauzeti celu širinu bloka, a visinu će prilagoditi sadržaju - unutra neće biti skrolovanja. Kada klijent izabere termin, prozor za zakazivanje otvara se preko cele stranice, a posle zakazivanja stranica ostaje tamo gde je bila.
Da biste vidžet postavili ne pored koda, već u drugi blok, navedite taj blok atributom data-target:
<div id="booking"></div>
<script src="https://widget.uzmitermin.rs/e/YOUR_TOKEN.js" data-target="#booking" async></script>
Ako stranicu pravi React (Next.js, Gatsby, Remix i sl.), tag <script> ne možete samo ubaciti u JSX. Next.js iscrtava stranicu na serveru, a vidžet ubaci kalendar pre nego što React preuzme stranicu. React tada vidi drugačiji kod od onog koji je stigao sa servera i pada sa greškom hidratacije (Minified React error #418). Osim toga, kada posetilac dođe na stranicu preko linka unutar sajta, takav tag se uopšte ne izvršava.
Ubacite tag iz koda kada se komponenta pojavi na stranici:
'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;
// Atributi iz tabele ispod: script.dataset.lang = 'sr';
container.appendChild(script);
return () => container.replaceChildren();
}, []);
return <div ref={ref} />;
};
Postavite <BookingWidget /> tamo gde treba da bude kalendar. Atribute iz tabele ispod zadajte preko script.dataset: data-lang je script.dataset.lang, data-primary je script.dataset.primary. U Vue-u, Svelte-u i drugim frameworkovima je isto: napravite tag u onMounted ili njegovom ekvivalentu i uklonite ga pri demontiranju.
Gotov kod sa vašim tokenom je na kartici React / Next.js u odeljku Vidžet za zakazivanje.
Jezik i boje podešavaju se u odeljku Vidžet za zakazivanje ili atributima direktno u kodu. Atribut ima prednost: tako vidžet na različitim stranicama sajta može izgledati različito.
<script
src="https://widget.uzmitermin.rs/e/YOUR_TOKEN.js"
data-lang="sr"
data-primary="#2e7d32"
data-background="transparent"
async
></script>
| Atribut | Šta podešava | Vrednosti |
|---|---|---|
data-lang | Jezik vidžeta | sr, en, ru. Ako nije naveden ni ovde ni u podešavanjima - jezik stranice, zatim jezik pregledača |
data-primary | Glavna boja: dugmad, izabrani majstor i usluge, današnji dan | Boja u formatu #rrggbb. Boja teksta na dugmadi - bela ili tamna - bira se automatski |
data-background | Pozadina vidžeta | Boja #rrggbb ili transparent - tada se vidi pozadina vaše stranice |
data-surface | Pozadina zaglavlja kalendara sa datumom i danima u nedelji | Boja #rrggbb |
data-master | Odmah otvoriti kalendar jednog majstora | Identifikator majstora iz odeljka Vidžet za zakazivanje |
data-target | Blok u koji će se postaviti vidžet | CSS selektor, na primer #booking |
Ako je vrednost atributa navedena pogrešno, vidžet je neće primeniti i uzeće podešavanje iz odeljka Vidžet za zakazivanje.
Vidžet obaveštava stranicu o tome šta se u njemu dešava, događajima na window. Na primer, ovako možete proslediti rezervaciju u svoju analitiku:
window.addEventListener('uzmi:booked', (event) => {
gtag('event', 'booking', { appointment_id: event.detail.appointmentId });
});
| Događaj | Kada | Podaci u event.detail |
|---|---|---|
uzmi:ready | Vidžet se učitao | - |
uzmi:booked | Klijent je zakazao | appointmentId |
uzmi:unavailable | Vidžet ne može da prima rezervacije | code - razlog, vidi ispod |
book.salon.rs dozvoljeni su samo ako je naveden *.salon.rs.code: WIDGET_DISABLED), pretplata je istekla (SUBSCRIPTION_INACTIVE) ili vidžet nije uključen u vaš paket (PLAN_NOT_ALLOWED).NOT_FOUND) - na primer, nakon što je token promenjen. Ponovo kopirajte kod iz odeljka Vidžet za zakazivanje.