WordPress vtičnik — Hermes urnik

Vtičnik Hermes Schedule Calendar omogoča prikaz skupinskih terminov iz aplikacije Hermes neposredno na vaši WordPress spletni strani. Urnik se samodejno posodablja vsako uro, tako da so vaše stranke vedno obveščene o aktualnem urniku.

Predpogoji

Pred namestitvijo preverite:

  • WordPress različica 5.0 ali novejša
  • PHP različica 7.4 ali novejša
  • Dostop do administracije aplikacije Hermes (za ustvaritev API ključa)
  • Dostop do WordPress administracije

Korak 1: Aktivacija pravic za API ključe v Hermesu

Preden ustvarite API ključ, morate svoji admin skupini dodeliti pravico za upravljanje API ključev.

  1. V Hermesu odprite Nastavitve → Uporabniki → Skupine.
  2. Dvokliknite na vrstico z admin skupino.
  3. V oknu poiščite razdelek Integracije in nato Urejanje api ključev.
  4. Obkljukajte pravico in kliknite Shrani.

Korak 2: Ustvarjanje API ključa v Hermesu

  1. Odprite Nastavitve → Integracije → API Ključi.
  2. Kliknite gumb za dodajanje novega ključa.
  3. Ko se ključ pojavi v seznamu, dvokliknite na vrstico in si skopirajte generirani ključ (npr. v odložišče s Ctrl+C).

!!! note "Ključ shranite" API ključ boste potrebovali pri konfiguraciji WordPress vtičnika. Priporočamo, da ga začasno shranite v besedilni urejevalnik.

Korak 3: Nastavitev vidnosti skupinskih terminov

Vtičnik prikazuje samo tiste skupinske obiske, ki imajo nastavljeno vidnost VSI. Vidnost je potrebno nastaviti neposredno na vsakem skupinskem obisku v urniku:

  1. V Hermesu odprite Urnik in poiščite skupinski obisk, ki ga želite prikazovati na spletni strani.
  2. Odprite termin v urniku za urejanje.
  3. V polju Vidnost izberite možnost VSI.
  4. Kliknite Shrani.

Ponovite za vse termine, ki jih želite prikazati na spletni strani.

Za prihodnje termine: Vidnost lahko nastavite tudi na predlogi rezervacij, da bodo novi termini, ustvarjeni iz te predloge, samodejno dobili vidnost VSI. Obstoječih terminov predloga ne posodobi — te je treba urediti ročno, kot je opisano zgoraj.

Korak 4: Namestitev vtičnika v WordPress

  1. Prenesite vtičnik (ZIP datoteka): hermes-schedule-calendar.zip

  2. Odprite WordPress administracijo.

  3. V levem meniju izberite Vtičniki → Dodaj novi vtičnik.

  4. Kliknite gumb Naloži vtičnik (na vrhu strani).

  5. Kliknite Izberi datoteko, izberite preneseni ZIP in kliknite Namesti zdaj.

  6. Po uspešni namestitvi kliknite Aktiviraj vtičnik.

Korak 5: Konfiguracija vtičnika

  1. V WordPress meniju odprite Nastavitve → Hermes Schedule Calendar.

  2. V razdelku API konfiguracija izpolnite naslednja polja:

  3. API Base URL — pustite privzeto vrednost (ne spreminjajte).

  4. Tenant ID — vnesite vašo Hermes domeno (npr. mojepodjetje). To je podatek, ki ste ga dobili na začetku pri navodilih za namestitev Hermesa.

  5. API Key — vnesite API ključ, ki ste ga ustvarili v 2. koraku.

  6. V razdelku Polja za prikaz izberite, katere podatke o terminu želite prikazati obiskovalcem:

  7. Vodja — ime vodje oz. trenerja termina

  8. Max. prisotnih — največje število udeležencev
  9. Prijavljenih — trenutno število prijavljenih
  10. Čakalna vrsta — število oseb na čakalni vrsti
  11. Opombe — dodatne opombe k terminu

Naziv termina ter čas začetka in konca se vedno prikažeta.

  1. V razdelku Sinhronizacija nastavite, koliko tednov naprej naj vtičnik prikazuje termine (vrednost med 1 in 52).

  2. Kliknite Shrani spremembe.

  3. Kliknite gumb Sinhronizacija zdaj, da opravite prvo sinhronizacijo podatkov.

Po uspešni sinhronizaciji se v razdelku Stanje sinhronizacije prikaže potrditev.

Korak 6: Dodajanje urnika na WordPress stran

Urnik dodajte na katerokoli stran ali objavo z uporabo kratke kode (shortcode):

[hermes_calendar]

Opcijski parametri

Prikaz urnika lahko prilagodite s parametri:

Parameter Opis Privzeta vrednost
start_hour Začetna ura na časovni osi 0
end_hour Končna ura na časovni osi 23
weeks Število tednov v prihodnost 4

Primer — urnik od 7. do 22. ure, za 2 tedna v prihodnost:

[hermes_calendar start_hour=7 end_hour=22 weeks=2]

Kako dodati kratko kodo na stran

  1. V WordPress odprite ali ustvarite stran (Strani → Dodaj novo).
  2. V urejevalniku dodajte blok Kratka koda (Shortcode).
  3. Vnesite [hermes_calendar] (ali z želenimi parametri).
  4. Objavite ali posodobite stran.

Avtomatska sinhronizacija

Vtičnik samodejno posodablja podatke vsako uro. Ni potrebno ničesar nastavljati — po prvi ročni sinhronizaciji vse deluje samodejno.

Čas naslednje sinhronizacije je viden v nastavitvah vtičnika pod Naslednja sinhronizacija.

Če želite podatke posodobiti takoj, kliknite gumb Sinhronizacija zdaj v nastavitvah vtičnika.

Reševanje težav

Sinhronizacija ne deluje ali javi napako:

  • Preverite, da ste pravilno vnesli API ključ in Tenant ID.
  • Preverite, da je API ključ aktiven v Hermesu (Nastavitve → Integracije → API Ključi).

Urnik se ne prikaže na strani:

  • Preverite, da je bila vsaj ena sinhronizacija uspešno izvedena (Stanje sinhronizacije v nastavitvah vtičnika).
  • Preverite, da je kratka koda [hermes_calendar] pravilno vstavljena na strani.

Dogodki se ne prikažejo v urniku:

  • Preverite vidnost predlog rezervacij v Hermesu — prikazujejo se samo skupinski obiski z vidnostjo nastavljeno na VSI. Glejte Korak 3.

Samodejne posodobitve ne delujejo:

  • Na nekaterih gostovanjih je WordPress Cron onemogočen. V tem primeru vsakič ročno sprožite sinhronizacijo ali se posvetujte z vašim ponudnikom gostovanja.