Propojení přes CalDAV (Obecný průvodce)

CalDAV je otevřený internetový standard (RFC 4791) pro přístup ke kalendářovým datům a jejich obousměrnou synchronizaci. Díky podpoře CalDAV v LockMyCal nejste vázáni na žádného proprietárního poskytovatele a můžete snadno propojit jakýkoliv vlastní nebo cloudový server.

Note

Synchronizace přes CalDAV probíhá přímo mezi vaší instancí LockMyCal a vaším kalendářovým serverem. Žádná data neprocházejí přes cizí servery třetích stran.

Jak CalDAV v LockMyCal funguje

sequenceDiagram
    participant C as Klient (Rezervační web)
    participant L as LockMyCal Server
    participant D as Váš CalDAV Server

    C->>L: Zobrazení dostupných termínů
    L->>D: REPORT / kalendářový dotaz na obsazenost (Busy)
    D-->>L: Seznam událostí a časových bloků
    L-->>C: Zobrazení pouze skutečně volných slotů
    C->>L: Odeslání nové rezervace
    L->>D: PUT / vytvoření nové události (.ics)
    D-->>L: Potvrzení zápisu (201 Created)

Čtení obsazenosti: LockMyCal pravidelně a v reálném čase dotazuje vybrané kalendáře na stav událostí (Busy/Free) a automaticky vylučuje obsazené časy z rezervačního formuláře.
Zápis nových schůzek: Po dokončení rezervace LockMyCal vytvoří novou kalendářovou událost s formátovaným popisem, účastníky a odkazem na video schůzku přímo ve vašem CalDAV kalendáři.
Detekce změn a zrušení: Pokud událost v externím kalendáři smažete nebo posunete, LockMyCal tyto změny zohlední při dalším vyhodnocení dostupnosti.

Obecný postup propojení

V dashboardu přejděte do Integrace → Kalendáře → Připojit kalendář.
Zvolte poskytovatele – Nextcloud, Apple iCloud, Baïkal, Radicale, Zimbra, mailbox.org nebo obecný CalDAV server.
Vyplňte:
- Název integrace: Vlastní pojmenování (např. Firemní Nextcloud).
- Adresa serveru: URL vašeho CalDAV serveru (lze zadat i bez https://).
- Uživatelské jméno: Váš přihlašovací login nebo e-mail.
- Heslo / heslo pro aplikaci: Silné heslo nebo vygenerované heslo pro aplikaci.
Klikněte na Vyhledat kalendáře, vyberte kalendáře a klikněte na Uložit výběr.

Podporována je Basic i Digest autentizace. Servery na interních adresách (např. 192.168.x.x) vyžadují při self-hostingu proměnnou ALLOW_PRIVATE_IPS_FOR_CALENDAR=true.

Tip

Z bezpečnostních důvodů důrazně doporučujeme v nastavení vašeho CalDAV serveru vygenerovat samostatné aplikační heslo (App Password) s omezenými právy pouze pro kalendář namísto vašeho hlavního hesla k účtu.

Průvodci pro konkrétní poskytovatele

Detailní návody krok za krokem pro nejpopulárnější CalDAV servery:

Nextcloud Calendar – Návod na propojení s privátním Nextcloud cloudem.
Apple iCloud – Nastavení Apple ID a aplikačního hesla pro iCloud kalendář.
Baïkal – Konfigurace lehkého open-source CalDAV serveru.
Radicale – Propojení s minimalistickým Python CalDAV serverem.
Zimbra – Integrace s podnikovým groupware řešením.
mailbox.org – Zabezpečený německý e-mailový a kalendářový poskytovatel.