V systéme OBERON existuje možnosť vytvoriť rezervačný formulár ubytovania (web booking engine, internet booking engine, smart booking engine, on-line booking system...) na internetovej stránke ubytovacieho zariadenia a prepojiť ho s modulom Hotelová recepcia. Táto téma Pomocníka popisuje jeden zo spôsobov implementácie rezervačného formulára ubytovania do webovej stránky ubytovacieho zariadenia - bezplatnú inštaláciu zásuvného modulu (pluginu) OBERON - Hotel Reservation priamo do systému WordPress.

Základné informácie

• Modul Hotelová recepcia systému OBERON podporuje priamu on-line rezerváciu izieb pomocou rezervačného formulára ubytovania na webovej stránke ubytovacieho zariadenia.
• Rezervačný formulár umožňuje po vykonaní rezervácie hosťom na internetovej stránke automaticky zapísať rezerváciu (alebo dopyt na ubytovanie) do evidencie rezervácií a vzápätí ju zobraziť v grafickom prehľade izieb. Rezervovať je možné jednu, prípadne aj viac izieb, pričom je možné overiť stav voľných izieb aj s automatickým výpočtom ceny za ubytovanie. Viac informácií získate v téme Rezervačný formulár ubytovania.
• Jedným zo spôsobov, ako zriadiť na webovej stránke ubytovacieho zariadenia rezervačný formulár ubytovania, je bezplatná inštalácia zásuvného modulu (pluginu) OBERON - Hotel Reservation priamo do systému WordPress. Oproti iným možnostiam implementácie je tento spôsob najjednoduchší.
• Zásuvný modul obsahuje rezervačný formulár ubytovania, ktorý umožňuje hosťom rezervovať si ubytovanie priamo a bezplatne z webovej stránky ubytovacieho zariadenia. So systémom OBERON komunikuje pomocou webovej služby (REST API) spustenej v programe OBERON Center. V prípade, že je webová služba spustená v počítači v lokálnej počítačovej sieti, je potrebné ju sprístupniť z vonkajšieho internetu.

Možnosti rezervačného formulára

• Overenie dostupnosti voľných izieb vo vybranom termíne, čím poskytuje údaje o obsadenosti v danom termíne (o evidovaných rezerváciách a zaevidovaných ubytovaniach).
• Rezervovať je možné tak typ izby, ako aj konkrétnu izbu.
• Pri typoch izieb systém automaticky priradí najvhodnejšiu izbu (podľa obsadenosti a nadväznosti na koniec iného pobytu, prípadne začiatok ďalšieho pobytu).
• Možnosť rezervácie viacerých izieb.
• Pri skupinovej rezervácii presný rozpis osôb v izbách a vek detí.
• On-line výpočet ceny za ubytovanie.
• Rezervácia alebo dopyt sa automaticky zapíše do knihy rezervácií a zobrazí v grafickom prehľade izieb.
• Viaceré jazykové mutácie.

Jazykové mutácie    

• Rezervačný formulár môže fungovať vo viacerých jazykových mutáciách - momentálne sú k dispozícii tieto:
  - slovenský jazyk (predvolené)
  - anglický jazyk - (príkaz lang=en)
  - nemecký jazyk - (príkaz lang=de)
  - poľský jazyk - (príkaz lang=pl)
  - český jazyk - (príkaz lang=cs)    
• Ďalšie jazykové mutácie je možné implementovať veľmi jednoducho - vytvorením ďalšieho súboru wp-content\plugins\exalogic-oberon-hotel-reservation\lang\frm-reservation-XX.txt, kde XX je kód jazyka (napr. wp-content\plugins\exalogic-oberon-hotel-reservation\lang\frm-reservation-en.txt).
• Jazyková mutácia sa nastavuje pre každý formulár zvlášť nasledujúcim vložením príslušného príkazu do skráteného kódu (shortcode), napr. [oberon_hotel_reservation lang='en'].

Implementácia rezervačného formulára

Implementácia rezervačného formulára pre systém WordPress pozostáva z nasledujúcich krokov:

1. Zabezpečenie verejnej IP adresy u poskytovateľa internetu (ISP) - ubytovacie zariadenie (počítač s webovou službou) musí byť dostupný z vonkajšieho internetu.
2. Konfigurácia lokálnej počítačovej siete - nastavenie presmerovania paketov zo smerovača (routera) na počítač s webovou službou (spravidla nastavuje správca lokálnej počítačovej siete).
3. Konfigurácia rozhrania webovej služby v programe OBERON Center (pozri postup nižšie).
4. Pridanie rezervačného formulára do webovej stránky - možno ho vykonať dvojakým spôsobom:
   • v ponuke Vzhľad - Widgety presuňte plugin OBERON – Hotel reservation do dostupných panelov,
   • vložte formulár do webovej stránky pomocou skráteného kódu (shortcode) [oberon_hotel_reservation].

OBERON Center - konfigurácia rozhrania webovej služby

1. Pred inštaláciou webovej služby je potrebné zvoliť počítač, v ktorom bude webová služba hosťovaná (t. j. spustená). Mal by to byť počítač, ktorý je neustále zapnutý (spravidla sieťový databázový server). Na tomto počítači je potrebné vykonať Inštaláciu OBERON-u. Po inštalácii otvorte účtovnú jednotku (databázu) a v nastaveniach programu (ponuka Servis, oddiel Firma - Všeobecné, záložka Rozšírenia) začiarknite Umožniť používať webové služby. 
2. V ďalšom kroku vytvorte pre webovú službu nového používateľa (ponuka Servis - Používatelia) typu Systémový, pod týmto používateľom sa bude webová služba spúšťať.
3. Otvorte program OBERON Center. Kvôli neskoršiemu úspešnému zaregistrovaniu webovej služby je nutné program spustiť s právami administrátora.
4. Otvorte oddiel Rozhranie webovej služby a stlačte tlačidlo Pridať. Otvorí sa formulár, v ktorom v záložke Základné:
   - zadajte Názov webovej služby,
   - vyberte Typ služby OBERON,
   - zadajte číslo TCP/IP portu, pod ktorým bude daná služba dostupná (port musí byť voľný - t. j. v systéme Windows ho nesmie používať iná služba),
   - začiarknite pole Pridať výnimku do Windows firewall (ak používate bránu firewall iného výrobcu, je potrebné povoliť zadaný port manuálne).
5. V záložke Databáza stlačte tlačidlo Nastaviť a vyberte príslušnú databázu. Ďalej zvoľte používateľa na spúšťanie webovej služby (podľa bodu č. 2).
6. Prejdite späť do záložky Základné, v ktorej stlačte tlačidlo Nastaviť na podrobné nastavenie služby. Otvorí sa formulár Nastavenia webovej služby OBERON, v ktorom:
   - vyberte systémového používateľa vytvoreného v bode č. 2,
   - začiarknite možnosť Povoliť webovú službu,
   - vyberte typ zabezpečenia Bez autorizácie a zabezpečenia.
7. Aby systém Windows webovú službu povolil, je nevyhnutné vykonať jej registráciu - stlačte tlačidlo Zaregistrovať službu. Pred prípadnou dodatočnou zmenou napr. čísla portu je potrebné najprv zrušiť registráciu danej služby, zmeniť port a následne opätovne vykonať registráciu.
8. Po nadefinovaní webovej služby je možné spustiť server rozhrania webovej služby. Skontrolujte nastavenie, či sa má tento server automaticky spúšťať pri spustení programu OBERON Center: v oddiele Rozhranie webové služby stlačte tlačidlo Nastavenia (vpravo hore). Otvorí sa okno, v ktorom danú možnosť povoľte, resp. zakážte. V záložke Prehľad komunikácie sa zobrazujú správy o priebehu komunikácie s webovou službou. V prehľade komunikácie sa nachádza odkaz v tvare napr. http://169.254.183.187:21001, ktorý zobrazí stránku s WSDL popisom SOAP komunikácie. Odkaz http://169.254.183.187:21001/login umožní zobraziť stránku OBERON Web.
9. Ak je webová služba nainštalovaná korektne, vo webovom prehliadači je možné vykonať jej kontrolu - zobrazí sa informácia o danej službe.
10. Webovú službu v lokálnej počítačovej sieti je potrebné sprístupniť z vonkajšieho internetu - je potrebné nastaviť presmerovanie portu na smerovači (routri) z verejnej IP adresy na IP adresu počítača v lokálnej sieti, na ktorom je služba spustená (predpokladá sa, že ubytovacie zariadenie má verejnú statickú IP adresu alebo dynamické DNS).

WordPress - inštalácia zásuvného modulu

1. Prihláste sa do administračného rozhrania systému WordPress. V hlavnej ponuke vyberte položku Pluginy a stlačte tlačidlo Pridať nový.
2. Do vyhľadávacieho poľa zadajte názov pluginu OBERON – Hotel reservation. Po automatickom vyhľadaní pluginu stlačte tlačidlo Nainštalovať.
   
      
   
3. Po inštalácii plugin aktivujte stlačením tlačidla Aktivovať.
4. V ponuke Nastavenia/OBERON – Hotel reservation do poľa OBERON Web - adresa webovej služby zadajte verejnú IP adresu a číslo portu v tvare http(s)://xxx.xxx.xxx.xxx:pppp. Zadaný port musí byť povolený v bráne firewall.
   
      
   
5. Na uloženie nastavení stlačte tlačidlo Uložiť zmeny.
6. V ponuke Vzhľad - Widgety presuňte plugin OBERON – Hotel reservation do zvoleného panela, prípadne vložte rezervačný formulár do webovej stránky pomocou skráteného kódu (shortcode) [oberon_hotel_reservation].
7. Priamo v sktátenom kóde (shortcode) môžete nastaviť jazykovú mutáciu formulára (pozri časť Jazykové mutácie) a predvolený spôsob spracovania údajov: pre Dopyt - získanie informácie o voľnom termíne a cene zadajte reservation_type=1, pre Záväzná rezervácie zadajte reservation_type=2, napr. [oberon_hotel_reservation lang='en' reservation_type=2].
8. Inštalácia pluginu je dokončená.