Modul Hotelová recepcia systému OBERON podporuje hotel on-line check-in, t. j. webový on-line registračný formulár určený na vyplnenie osobných údajov potrebných na registráciu hosťa pred, resp. po príchode do ubytovacieho zariadenia na zrýchlenie procesu ubytovania. Táto téma Pomocníka popisuje jeden zo spôsobov implementácie tohto on-line registračného formulára do webovej stránky ubytovacieho zariadenia - bezplatnú inštaláciu zásuvného modulu OBERON - WP Add-in priamo do systému WordPress.

Základné informácie

• Hotel on-line check-in predstavuje webový on-line registračný formulár určený na vyplnenie osobných údajov potrebných na registráciu hosťa pred, resp. po príchode do ubytovacieho zariadenia na zrýchlenie procesu ubytovania. V závislosti od toho, kedy sa použije, zahŕňa tzv. Pre check-in alebo Rýchly check-in. Funkcia výraznou mierou minimalizuje čas hostí strávený na recepcii ubytovacích zariadení a umožňuje im významnú časť úkonov spojených s procesom ubytovania zvládnuť vo vlastnej réžii (bez priameho kontaktu s obsluhou).
• Pri Pre check-ine ide o elektronickú registráciu hosťa (on-line check-in) ešte pred jeho príchodom do ubytovacieho zariadenia, a to spravidla z pohodlia jeho domova. Realizuje sa na základe automaticky zasielanej výzvy (formou e-mailovej alebo SMS správy) na zadanie identifikačných údajov hosťa, prípadne aj ďalších osôb do osobitného on-line registračného formulára na webovej stránke ubytovacieho zariadenia. Viac informácií získate v téme Pre check-in.
• Ak hosť nevyplní svoje identifikačné údaje pred svojím príchodom, môže využiť funkciu Rýchly check-in, keď svoje identifikačné údaje zadá do on-line registračného formulára bezprostredne po svojom príchode do ubytovacieho zariadenia a prevzatí izby. Rýchly check-in sa realizuje na základe pripojenia mobilným zariadením (smartfónom, tabletom...) do lokálnej počítačovej WiFi siete a zadaním identifikačných údajov hosťa, prípadne aj ďalších osôb do on-line registračného formulára. Pri rýchlom check-ine sa používa osobitný tlačový výstup s QR kódom na pripojenie do lokálnej počítačovej WiFi siete a QR kódom s odkazom na on-line registračný formulár. Viac informácií získate v téme Rýchly check-in.
• Jedným zo spôsobov, ako zriadiť na webovej stránke ubytovacieho zariadenia on-line registračný formulár, je bezplatná inštalácia zásuvného modulu (add-in) OBERON – WP Add-in priamo do systému WordPress.
• Zásuvný modul obsahuje on-line registračný formulár, ktorý umožňuje elektronickú registráciu hosťa ešte pred jeho príchodom do ubytovacieho zariadenia (pre-check in) alebo bezprostredne po jeho príchode do ubytovacieho zariadenia a prevzatí izby (rýchly check-in). So systémom OBERON komunikuje na základe automatickej úlohy typu WebServices API - OBERON 1G, t. j. webových služieb. On-line registračný formulár v rámci komunikácie predstavuje klienta webovej služby.

Technické informácie  

• Formulár na zadanie identifikačných údajov o hosťovi (on-line check-in) zapisuje údaje do rezervácie priamo, a to pomocou API rozhrania pre webové služby. Formulár sa spravidla umiestňuje do webovej stránky ubytovacieho zariadenia - dôležitým faktom je, že webová stránka musí mať priamo dostupnú webovú službu, spravidla na statickej verejnej IP adrese.
• Pri Pre check-ine odkaz na formulár, ktorý sa zasiela v e-mailovej notifikácii hosťovi, je možné získať vo formulári rezervácie v záložke Iné záznamy - rezervácia sa identifikuje na základe tzv. GUID v danom odkaze, napr. https://hotel.sk/on-line-check-in/?guid=311b05ea-4461-49ce-b375-e7bc7c436b52&lang=sk.
• Pri Rýchlom check-ine by mal byť formulár (na rozdiel od režimu Pre check-in) technicky dostupný len z lokálnej počítačovej siete (interná URL). Dôvodom je fakt, že odkaz na formulár obsahuje číslo izby, čo by mohlo byť hosťom po skončení ubytovania (alebo kedykoľvek neskôr) zneužité (hosť by mohol zasielať SPAM údaje).

Jazykové mutácie    

• On-line registrač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),
  • český jazyk (príkaz lang=cs),
  • poľský jazyk (príkaz lang=pl).
• Ďalšie jazykové mutácie je možné implementovať veľmi jednoducho - vytvorením ďalšieho súboru wp-content\plugins\oberon-wpaddin\lang\frm-checkinguest-XX.txt, kde XX je kód jazyka (napr. wp-content\plugins\oberon-wpaddin\lang\frm-checkinguest-en.txt).
• Jazykovú mutáciu je možné zmeniť zmenou príkazu v url danej rezervácie, napr. https://hotel.sk/on-line-check-in/?guid=311b05ea-4461-49ce-b375-e7bc7c436b52&lang=en.

Implementácia on-line registračného formulára

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

1. Nastavenie lokálnej počítačovej siete

1. Na zabezpečenie potrebnej sieťovej infraštruktúry, nastavenie lokálnej počítačovej siete a jej následnú správu odporúčame kontaktovať servisného technika. Osloviť môžete niektorého z našich zmluvných partnerov (servisných stredísk).
2. Zvoľte počítač, na ktorom bude automatická úloha (webová služba) spustená. Mal by to byť počítač, ktorý je neustále zapnutý (spravidla sieťový databázový server).
3. Počítač, na ktorom je automatická úloha (webová služba) spustená, musí byť dostupný z vonkajšieho internetu. Z tohto dôvodu zabezpečte u poskytovateľa internetu (ISP) pre svoju prevádzku (ubytovacie zariadenie) verejnú statickú IP adresu alebo dynamické DNS.
4. Zároveň je potrebné nastaviť presmerovanie portu na smerovači (routri) z verejnej IP adresy na IP adresu počítača, na ktorom je automatická úloha (webová služba) spustená.

2. Nastavenie automatickej úlohy 

1. Pred nastavením automatickej úlohy v systéme OBERON sa uistite, že je na počítači, ktorý je neustále zapnutý (spravidla sieťovom databázovom serveri), správne nastavený server OBERON Automation Center. Postup nastavenia je dostupný v téme Nastavenie servera OBERON Automation Center. Správnosť nastavenia a fungovania servera OAC môžete skontrolovať v programe OBERON Automation Center (klient) (v programe OBERON - Agenda firmy, ponuka OBERON, OBERON Automation Center (klient)). Pri použití OBERON Automation Center odporúčame používať databázu SQL.
2. Na serveri (nie na klientskom počítači) spustite program OBERON - Agenda firmy a v ponuke OBERON, Otvorenie agendy (firmy) otvorte databázu účtovnej jednotky.
3. V ponuke Servis, Nastavenia programu, oddiel Firma, Všeobecné, záložka Rozšírenia zadajte verejnú, prípadne internú adresu (url). V prípade, že účtovná jednotka člení firmu na prevádzky, je možné každej prevádzke priradiť vlastnú verejnú a internú url adresu.
   • Verejná adresa (url) - najčastejšie je to adresa webovej stránky účtovnej jednotky, ktorá využíva webové služby OBERON, napr. http://booking.exalogic.sk. Dané url slúži na generovanie odkazu, napr. pre Pre check-in.
   • Interná adresa (url) - zadáva sa privátna url adresa webovej služby v rámci lokálnej počítačovej siete v tvare 192.168.16.20:22001. Je to url adresa, na ktorej fyzicky beží webová služba. Dané url sa používa na generovanie odkazu, napr. pre Rýchly check-in.
4. V ponuke Servis, Používatelia vytvorte nového používateľa typu Systémový (napr. s názvom sys_hotel).
5. V ponuke Servis, Automatické úlohy stlačte tlačidlo Nový. Otvorí sa formulár Automatická úloha, v ktorom vyberte typ úlohy WebServices API - OBERON 1G a zadajte názov úlohy.
6. Stlačením tlačidla  pri rozbaľovacom zozname Vykonávať na serveri aktualizujte zoznam dostupných serverov a vyberte príslušný server OAC, na ktorom sa má úloha vykonávať.
7. Vyberte používateľa systému OBERON vytvoreného v bode č. 4, pod ktorým sa má automatická úloha vykonávať.
8. Stlačte tlačidlo Nastaviť, zobrazí sa formulár Nastavenie automatickej úlohy 'WebServices API - OBERON 1G', v ktorom v záložke Komunikácia:
   • 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, pre OAC odporúčame používať hodnoty 22 001 a nasl.),
   • zvoľte spôsob autentifikácie používateľov Len systémový používateľ služby,
   • zvoľte spôsob zabezpečenia Bez autorizácie a zabezpečenia,
   • začiarknite pole Zasielať podrobné info do 'Prehľadu činností' (na OAC klienta) - prehľad záznamov o činnosti (logovania) bude dostupný v programe OBERON Automation Center (klient), oddiel Prehľad činností,
   • 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).
9. 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.
10. V záložke Nastavenia formulára Nastavenie automatickej úlohy 'WebServices API - OBERON 1G' stlačte tlačidlo Rozšírené nastavenia webovej služby. Otvorí sa formulár, v ktorom v oddiele Hotelová recepcia povoľte prístup k jednotlivým údajom modulu Hotelová recepcia.
11. Vykonané nastavenia potvrďte stlačením tlačidla OK.
12. V zozname úloh vo formulári Automatické úlohy v stĺpci Popis získate údaje (IP adresu počítača spolu s číslom komunikačného TCP/IP portu).
13. Ak je webová služba nakonfigurovaná korektne, vo webovom prehliadači je možné vykonať jej kontrolu - po zadaní IP adresy a portu v tvare 192.168.16.20:22001 sa zobrazí informácia o danej službe. Odkaz http://192.168.16.20:22001/login umožní zobraziť aplikáciu OBERON Web.
14. Otvorte program OBERON Automation Center (klient) (ponuka OBERON, OBERON Automation Center (klient)). V oddiele Automatické úlohy dvojklikom na danú úlohu otvorte okno Detaily, v ktorom sa nachádza odkaz v tvare napr. http://192.168.16.20:22001/html?c=checkInGuest&a=GUID&lang=sk na on-line zaevidovanie hosťa.

3. 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 - WP Add-in. 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 - WP Add-in do poľa OBERON Web - adresa webovej služby zadajte externú IP adresu spravidla s číslom portu, napr. v tvare http(s)://xxx.xxx.xxx.xxx:pppp. Zadaný port musí byť povolený v bráne firewall. 

   

5. Stlačte tlačidlo Save changes a až následne dajte komunikáciu otestovať (tlačidlo Test connection).
6. Systémové pomenovanie pluginu (shortcode) - [owpa_guestcheckin] vložte do stránky WordPressu. Stránka musí mať odkaz v tvare on-line-check-in, napríklad www.hotel.sk/on-line-check-in (to znamená, že na danej stránke musí byť vytvorená podstránka (page) s názvom On-line check-in).
7. V záložke Hotel je možné zadať url adresu, na ktorú bude presmerovaný hosť po úspešnom odoslaní údajov (redirect).
8. Inštalácia pluginu je dokončená.