Vkládání na web (Embed Widget)

LockMyCal nabízí jeden univerzální JavaScript widget (embed.js), kterým lze rezervační stránku vložit na libovolný web (WordPress, Webflow, Wix, custom HTML) ve třech režimech: Inline, Popup a Floating tlačítko. Widget se automaticky stará i o přizpůsobení výšky obsahu bez posuvníků.

Hotový kód pro všechny režimy vygeneruje dashboard v sekci Vložení a sdílení – stačí ho zkopírovat. Pokud kód píšete ručně, vložte nejprve na stránku samotný skript (typicky do patičky, před </body>):

<script src="https://vasedomena.cz/embed.js" defer></script>

V cloudu LockMyCal použijte adresu https://lockmycal.app/embed.js.

1. Inline vložení

Vloží rezervační kalendář přímo do místa na stránce, kam umístíte <div>:

<div id="lockmycal-booking" data-username="jan-novak"></div>

Pro více widgetů na jedné stránce místo id použijte atribut data-lockmycal-inline.

2. Popup (modální okno)

Otevře rezervační kalendář v modálním okně po kliknutí na libovolný prvek (zavřít ho lze i programově přes LockMyCalBooking.close()):

<button onclick="LockMyCalBooking.open('jan-novak')">Rezervovat schůzku</button>

3. Plovoucí tlačítko (Floating)

Zobrazí trvalé plovoucí tlačítko v rohu obrazovky, které po kliknutí otevře popup:

<script>
  LockMyCalBooking.initFloating('jan-novak');
</script>

Starší názvy TymeslotBooking, tymeslot-booking a data-tymeslot-inline fungují dál, takže dříve vložený kód není potřeba měnit.

4. Dostupné atributy přizpůsobení

U inline vložení lze nastavit tyto atributy. U open()/initFloating() se stejné volby předávají jako druhý parametr, např. { meeting: 'konzultace', background: 'transparent' }.

5. Které typy schůzek widget ukáže

Widget má vlastní seznam typů schůzek, nezávislý na veřejné rezervační stránce. U každého typu schůzky v sekci Viditelnost najdete dva přepínače:

• Skrýt z veřejné rezervační stránky – typ se nezobrazí v seznamu na vaší veřejné stránce.
• Zobrazit ve vloženém widgetu – typ se zobrazí v seznamu ve widgetu.

Přímý odkaz na typ schůzky (/vase-jmeno/slug) funguje vždy. Typy zobrazené ve widgetu mají v seznamu typů schůzek štítek Zobrazeno ve widgetu.

Widget pro jeden typ schůzky

Atribut data-meeting (nebo volba meeting) otevře widget rovnou na výběru termínu daného typu, bez seznamu a bez tlačítka zpět. Funguje pro každý aktivní typ bez ohledu na přepínače viditelnosti. V dashboardu typ vyberete v Přizpůsobení v poli Typ schůzky.

Pokud typ neexistuje, je vypnutý nebo pozastavený, zobrazí widget místo rezervace hlášku Tento typ schůzky není dostupný.

6. Vzhled widgetu

Uvnitř widgetu je rezervační stránka zjednodušená: horní lišta ukazuje jen logo uprostřed, bez přepínače jazyka a odkazů, a chybí tlačítko pro zobrazení celého kalendáře. Jazyk se řídí prohlížečem návštěvníka (pokud ho LockMyCal nepodporuje, použije se angličtina); pevný jazyk nastavíte atributem data-locale.

V Přizpůsobení nastavíte i Pozadí:

• Podle motivu – pozadí z vašeho motivu (výchozí).
• Průhledné – prosvítá stránka, do které widget vkládáte.
• Vlastní barva – libovolná barva z výběru.

Samostatná rezervační stránka si vždy ponechá pozadí svého motivu.

Volby z Přizpůsobení (typ schůzky, pozadí, rozvržení, jazyk, výška a šířka) i zvolený styl se ukládají k vašemu účtu a po návratu na stránku zůstanou nastavené. Ovlivňují jen kód, který dashboard vygeneruje – widget už vložený na webu se řídí svým kódem.

7. Skrytá adresa widgetu

Kód widgetu na vašem webu obsahuje vaše uživatelské jméno, takže z něj jde dohledat vaši veřejnou rezervační stránku. Pokud to nechcete, vytvořte si skrytou adresu widgetu: náhodnou adresu ve tvaru /_k7m2x9qa4b…, kterou widget použije místo uživatelského jména.

1. V dashboardu otevřete Vložení a sdílení → Zabezpečení → Skrytá adresa widgetu.
2. Klikněte na Vytvořit skrytou adresu.
3. Kód na kartě Možnosti vložení (včetně přímého odkazu) i živý náhled ji začnou používat hned. Zkopírujte nový kód na svůj web.

Přes skrytou adresu:

• seznam ukazuje typy schůzek se zapnutým Zobrazit ve vloženém widgetu,
• přímým odkazem jsou dostupné typy zobrazené ve widgetu nebo skryté z veřejné stránky; typy, které jsou jen na veřejné stránce, ani veřejný kalendář přes ni dostupné nejsou,
• rezervace si skrytou adresu ponechá i v e-mailech: odkazy na zobrazení, přesunutí a zrušení schůzky i tlačítko pro novou rezervaci vedou na skrytou adresu, ne na vaše uživatelské jméno.

Skrytá adresa funguje i samostatně, mimo widget, jako druhá, neveřejná adresa vaší stránky. Jeden účet má jednu skrytou adresu.

Tlačítkem Vytvořit novou adresu ji vyměníte a tlačítkem Odebrat zrušíte. Obojí je potřeba potvrdit, protože původní adresa okamžitě přestane fungovat – web s vloženým widgetem potřebuje nový kód a přestanou fungovat i odkazy v už odeslaných e-mailech k rezervacím přes ni.

8. Bezpečnost (povolené domény)

Aby widget na cizí doméně fungoval, musí být tato doména uvedena v seznamu povolených domén pro vkládání:

1. V dashboardu přejděte do sekce Vložení a sdílení.
2. Přidejte doménu, na které bude widget vložen (např. www.vasefirma.cz). Ve výchozím stavu je vkládání vypnuté, dokud žádnou doménu nepřidáte.
3. Bez schválené domény LockMyCal vložení widgetu odmítne a zobrazí místo něj informační hlášku.

V téže sekci najdete i Živý náhled zvoleného stylu vložení. Rezervace vytvořené z náhledu jsou označené jako testovací.