Kompletný manuál k pluginu BBK BooKing. Klikni na sekciu ktorú potrebuješ:
- 📅 Google Calendar Setup
- 🛎 Správa služieb
- ➕ Doplnky (Extras)
- 👤 Zamestnanci a rozvrhy
- ✉️ Email notifikácie
📅 Google Calendar Setup
Tento návod ti krok za krokom ukáže, ako prepojiť BBK BooKing plugin s Google Kalendárom — vrátane automatického generovania Google Meet linkov pre online stretnutia.
Čo potrebuješ:
- BBK BooKing plugin v1.7.0+ nainštalovaný na WordPress webe
- Google účet (Gmail) — ten ktorý používaš pre Google Calendar
- Prístup do WordPress Admin → BooKing → Nastavenia
- Cca 15 minút času
KROK 1 — Zapnúť Google Calendar API
Otvor console.cloud.google.com a vyber (alebo vytvor) projekt pre BBK BooKing.
ℹ️ Ak ešte nemáš projekt: klikni na rozbaľovací zoznam projektov vľavo hore → „Nový projekt“ → zadaj názov napr. BBK BooKing → Vytvoriť.
- V ľavom menu klikni na ikonu menu (☰) → Knižnica API
- Do vyhľadávacieho poľa zadaj: Google Calendar API
- Klikni na výsledok „Google Calendar API“
- Klikni tlačidlo Zapnúť (Enable)
✅ Ak je API už zapnuté, uvidíš tlačidlo „Spravovať“ — to je v poriadku, pokračuj ďalej.
KROK 2 — Nastaviť OAuth súhlas (Google Auth Platform)
V ľavom menu klikni na Google Auth Platform (alebo vyhľadaj „OAuth consent screen“).
2a — Informácie o aplikácii
- Klikni na „Začíname“ alebo „Konfigurovať súhlas“
- Názov aplikácie: napr. „BBK BooKing [tvoja-domena.sk]“
- E-mail podpory: zadaj svoju Gmail adresu
- Klikni Ďalej
2b — Publikum — DÔLEŽITÉ
- Vyber: EXTERNÝ — správna voľba pre WordPress plugin
- Klikni Ďalej
⚠️ Interný je len pre Google Workspace organizácie. Pre osobné Gmail účty MUSÍ byť Externý.
2c — Scope (oprávnenie pre Google Calendar)
- Klikni v ľavom menu na „Prístup k údajom“
- Klikni „Pridať alebo odstrániť scopes“
- Vyhľadaj calendar a zaškrtni:
https://www.googleapis.com/auth/calendar - Klikni Aktualizovať a potom Uložiť
2d — Testovací používateľ — POVINNÉ
- Klikni v ľavom menu na „Klienti“ alebo „publikum“
- V sekcii Testovacie používatelia klikni „+ Pridať používateľov“
- Zadaj svoju Gmail adresu a klikni Uložiť
⚠️ BEZ tohto kroku dostaneš pri prepájaní chybu „Access blocked: app has not been verified“.
KROK 3 — Vytvoriť OAuth 2.0 klienta (Client ID + Secret)
V ľavom menu klikni na Klienti → tlačidlo „+ Vytvoriť klienta OAuth“.
- Typ aplikácie: Webová aplikácia — prvá možnosť v zozname
- Názov: napr. „BBK BooKing WordPress“
- Povolený pôvod JavaScript: NECHAJ PRÁZDNE
- Povolené presmerovanie URI: vlož Redirect URI z pluginu (pozri nižšie)
⚠️ Redirect URI nájdeš v WordPress Admin → BooKing → Nastavenia → sekcia Google Calendar → pole „Redirect URI“. Vlož ju sem presne.
- Klikni na „+ Pridať URI“, vlož Redirect URI, klikni Vytvoriť
- Skopíruj Client ID a Client Secret z okna ktoré sa objaví
⚠️ Client Secret vidíš IBA raz pri vytvorení. Ulož ho hneď!
KROK 4 — Zadať Client ID a Secret do pluginu
Prejdi do WordPress Admin → BooKing → Nastavenia → sekcia Google Calendar.
- Client ID: vlož hodnotu (tvar: xxxxxxx.apps.googleusercontent.com)
- Client Secret: vlož Client Secret
- Klikni Uložiť nastavenia
✅ Po uložení sa zobrazí nové tlačidlo „Prepojiť Google Calendar“.
KROK 5 — Prepojiť Google Calendar
- Klikni na tlačidlo „Prepojiť Google Calendar“ v nastaveniach pluginu
- Vyber Google účet ktorého kalendár chceš pripojiť
- Ak uvidíš upozornenie „Táto aplikácia nie je overená“ — klikni Pokračovať
- Zaškrtni všetky oprávnenia a klikni Allow
ℹ️ Upozornenie „nie je overená“ je normálne pre vlastné aplikácie v testing mode.
KROK 6 — Vybrať kalendár a zapnúť Google Meet
- Kalendár: vyber z rozbaľovacieho zoznamu
- Google Meet: zaškrtni „Automaticky vytvoriť Google Meet link“
- Klikni Uložiť nastavenia
✅ Meet link sa vygeneruje automaticky pre každú rezerváciu s typom stretnutia Google Meet.
Riešenie problémov
| Problém | Riešenie |
|---|---|
| Access blocked: app not verified | Pridaj svoju Gmail adresu ako testovacieho používateľa v Google Auth Platform → Klienti. |
| redirect_uri_mismatch | Redirect URI v Google Console sa nezhoduje s URI v plugine. Skopíruj ju znovu presne. |
| Tlačidlo „Prepojiť“ sa nezobrazí | Client ID alebo Secret nie je uložený. Skontroluj polia a ulož znovu. |
| Event sa nevytvorí | Expirovaný token — klikni Odpojiť a prepoj znovu. |
| Meet link chýba v emaili | Zaškrtni „Automaticky vytvoriť Meet link“ v nastaveniach a nastav meeting_type = google_meet na službe. |
🛎 Správa služieb
Návod na vytvorenie a správu služieb v BBK BooKing.
KROK 1 — Vytvorenie novej služby
Prejdi do WordPress Admin → BooKing → Služby → klikni Pridať službu.
- Názov: napr. „Konzultácia“, „Masáž“, „Koučing“
- Trvanie: zadaj v minútach (napr. 60 pre hodinový termín)
- Cena: základná cena bez doplnkov
- Popis: zobrazuje sa zákazníkovi vo formulári
- Klikni Uložiť
KROK 2 — Typy stretnutí (Meeting types)
Pre každú službu môžeš nastaviť aké typy stretnutí sú dostupné:
- Osobne — zákazník príde fyzicky
- Telefonicky — hovor na zákazníkov telefón
- Google Meet — automaticky sa vytvorí Meet link (vyžaduje prepojenie Google Calendar)
ℹ️ Ak služba ponúka viacero typov, zákazník si vyberie pri rezervácii. Ak len jeden, výber sa preskočí.
KROK 3 — Priradenie zamestnancov
V detaile služby môžeš vybrať ktorí zamestnanci ju poskytujú. Len priradení zamestnanci sa zobrazia vo formulári pre danú službu.
➕ Doplnky (Extras)
Doplnky (Extras) sú voliteľné položky ktoré si zákazník môže pridať k rezervácii — napr. predĺženie, doplnkové produkty, špeciálne požiadavky.
⚠️ Extras musíš najprv povoliť v BooKing → Nastavenia → Rezervácie → Doplnky (Extras).
KROK 1 — Vytvorenie doplnku
Prejdi do WordPress Admin → BooKing → Doplnky → klikni Pridať doplnok.
- Názov: napr. „Predĺženie o 30 min“, „Aromaterapia“
- Cena: cena doplnku v eurách
- Popis: krátky popis zobrazený zákazníkovi
- Obrázok: klikni „Vybrať obrázok“ — otvorí sa WP Media Library
- Klikni Uložiť
KROK 2 — Placeholders v emailoch
| Placeholder | Popis |
|---|---|
{extras_list} | HTML tabuľka vybraných doplnkov s cenami |
{extras_price} | Celková suma doplnkov |
{total_price} | Celková cena rezervácie vrátane doplnkov |
👤 Zamestnanci a rozvrhy
Návod na správu zamestnancov, pracovných hodín a prestávok.
KROK 1 — Pridanie zamestnanca
Prejdi do WordPress Admin → BooKing → Zamestnanci → klikni Pridať zamestnanca.
- Meno: zobrazuje sa zákazníkovi vo formulári
- Pozícia: napr. „Terapeut“, „Konzultant“ (voliteľné)
- Email: na tento email chodia notifikácie o rezerváciách
- Klikni Uložiť
KROK 2 — Nastavenie pracovných hodín
V detaile zamestnanca nastav pracovný rozvrh pre každý deň v týždni. Zákazníci si môžu rezervovať len v dostupných časoch.
⚠️ Ak zamestnanec nemá nastavený rozvrh, nie je dostupný pre žiadnu rezerváciu.
KROK 3 — Pracovné prestávky
Prestávky (obedňajšia pauza, príprava medzi klientmi) blokujú konkrétne časy v rámci pracovného dňa.
- V rozvrhu zamestnanca klikni Pridať prestávku
- Nastav čas od–do
- Ulož — zákazníci v tomto čase neuvidia voľné sloty
✉️ Email notifikácie
BBK BooKing odosiela automatické emaily zákazníkovi aj zamestnancovi. Tu je prehľad šablón a dostupných premenných.
Typy notifikácií
| Typ | Kedy sa odošle | Príjemca |
|---|---|---|
| Potvrdenie rezervácie | Rezervácia je schválená | Zákazník + zamestnanec |
| Zrušenie rezervácie | Rezervácia je zrušená | Zákazník + zamestnanec |
| Pripomienka | X hodín pred termínom (nastaviteľné) | Zákazník |
Dostupné placeholders
| Placeholder | Popis |
|---|---|
{customer_name} | Meno zákazníka |
{customer_email} | Email zákazníka |
{customer_phone} | Telefón zákazníka |
{service_name} | Názov služby |
{staff_name} | Meno zamestnanca |
{appointment_date} | Dátum rezervácie |
{appointment_time} | Čas rezervácie |
{appointment_price} | Cena bez doplnkov |
{extras_list} | Zoznam doplnkov s cenami (HTML) |
{extras_price} | Celková suma doplnkov |
{total_price} | Celková cena vrátane doplnkov |
{meeting_type} | Typ stretnutia (Osobne / Telefonicky / Google Meet) |
{meeting_url} | Odkaz na Google Meet |
{cancel_url} | Odkaz pre zrušenie rezervácie zákazníkom |
{company_name} | Názov firmy (zo Nastavení) |
{business_address} | Adresa prevádzky |
{navigate_button} | HTML tlačidlo „Navigovať“ s odkazom na Google Maps |
