BBK BooKing — Manuál

Kompletný manuál k pluginu BBK BooKing. Klikni na sekciu ktorú potrebuješ:


📅 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ť.

  1. V ľavom menu klikni na ikonu menu (☰) → Knižnica API
  2. Do vyhľadávacieho poľa zadaj: Google Calendar API
  3. Klikni na výsledok „Google Calendar API“
  4. 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

  1. Klikni na „Začíname“ alebo „Konfigurovať súhlas“
  2. Názov aplikácie: napr. „BBK BooKing [tvoja-domena.sk]“
  3. E-mail podpory: zadaj svoju Gmail adresu
  4. Klikni Ďalej

2b — Publikum — DÔLEŽITÉ

  1. Vyber: EXTERNÝ — správna voľba pre WordPress plugin
  2. Klikni Ďalej

⚠️ Interný je len pre Google Workspace organizácie. Pre osobné Gmail účty MUSÍ byť Externý.

2c — Scope (oprávnenie pre Google Calendar)

  1. Klikni v ľavom menu na „Prístup k údajom“
  2. Klikni „Pridať alebo odstrániť scopes“
  3. Vyhľadaj calendar a zaškrtni: https://www.googleapis.com/auth/calendar
  4. Klikni Aktualizovať a potom Uložiť

2d — Testovací používateľ — POVINNÉ

  1. Klikni v ľavom menu na „Klienti“ alebo „publikum“
  2. V sekcii Testovacie používatelia klikni „+ Pridať používateľov“
  3. 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“.

  1. Typ aplikácie: Webová aplikácia — prvá možnosť v zozname
  2. Názov: napr. „BBK BooKing WordPress“
  3. Povolený pôvod JavaScript: NECHAJ PRÁZDNE
  4. 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.

  1. Klikni na „+ Pridať URI“, vlož Redirect URI, klikni Vytvoriť
  2. 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.

  1. Client ID: vlož hodnotu (tvar: xxxxxxx.apps.googleusercontent.com)
  2. Client Secret: vlož Client Secret
  3. Klikni Uložiť nastavenia

✅ Po uložení sa zobrazí nové tlačidlo „Prepojiť Google Calendar“.


KROK 5 — Prepojiť Google Calendar

  1. Klikni na tlačidlo „Prepojiť Google Calendar“ v nastaveniach pluginu
  2. Vyber Google účet ktorého kalendár chceš pripojiť
  3. Ak uvidíš upozornenie „Táto aplikácia nie je overená“ — klikni Pokračovať
  4. 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

  1. Kalendár: vyber z rozbaľovacieho zoznamu
  2. Google Meet: zaškrtni „Automaticky vytvoriť Google Meet link“
  3. Klikni Uložiť nastavenia

✅ Meet link sa vygeneruje automaticky pre každú rezerváciu s typom stretnutia Google Meet.


Riešenie problémov

ProblémRiešenie
Access blocked: app not verifiedPridaj svoju Gmail adresu ako testovacieho používateľa v Google Auth Platform → Klienti.
redirect_uri_mismatchRedirect 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 emailiZaš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.

  1. Názov: napr. „Konzultácia“, „Masáž“, „Koučing“
  2. Trvanie: zadaj v minútach (napr. 60 pre hodinový termín)
  3. Cena: základná cena bez doplnkov
  4. Popis: zobrazuje sa zákazníkovi vo formulári
  5. 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.

  1. Názov: napr. „Predĺženie o 30 min“, „Aromaterapia“
  2. Cena: cena doplnku v eurách
  3. Popis: krátky popis zobrazený zákazníkovi
  4. Obrázok: klikni „Vybrať obrázok“ — otvorí sa WP Media Library
  5. Klikni Uložiť

KROK 2 — Placeholders v emailoch

PlaceholderPopis
{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.

  1. Meno: zobrazuje sa zákazníkovi vo formulári
  2. Pozícia: napr. „Terapeut“, „Konzultant“ (voliteľné)
  3. Email: na tento email chodia notifikácie o rezerváciách
  4. 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.

  1. V rozvrhu zamestnanca klikni Pridať prestávku
  2. Nastav čas od–do
  3. 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í

TypKedy sa odošlePríjemca
Potvrdenie rezervácieRezervácia je schválenáZákazník + zamestnanec
Zrušenie rezervácieRezervácia je zrušenáZákazník + zamestnanec
PripomienkaX hodín pred termínom (nastaviteľné)Zákazník

Dostupné placeholders

PlaceholderPopis
{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
Vďaka Vám za zdieľanie ❤️