Ugrás a fő tartalomra

A szobafoglalási rendszer honlapba ágyazása

iFrame beillesztés és URL paraméterezése

Zoltán Gál avatar
Írta: Zoltán Gál
Több mint 12 hónappal ezelőtt frissítve

A RESnWEB szobafoglalási rendszert és moduljait be lehet ágyazni a szálláshely weboldalába, hogy egy egységes, designba illő, látszólag saját URL-en futó felhasználói élményt kapjon a foglalni szándékozó látogató. Illetve lehet használni a saját, külső URL-jén is.

Az URL-eken keresztül GET paraméterek segítségével átadhatóak adatok a foglalási rendszernek. Használatuk azonban eltér attól függően, hogy a foglalási rendszer iframe-en keresztül vagy közvetlenül érhető el.

A beágyazás előfeltételei

  1. A domain érvényes SSL tanúsítvánnyal rendelkezik

  2. A kód beillesztéséhez a szálláshely azonosítója és a beágyazási kulcs rendelkezésre áll

Hibás működést eredményezhet:

Forráskód generálása

  1. Az adminisztrációs felületen a bal oldali menüben kattintson a Hoteladatok/Webmestereknek menüpontra.

  2. Az "Integrációs kódok" fül alatt található táblázatban keresse meg azt az iframe kulcsot, amelyhez beágyazó kódot szeretne generálni.

  3. A világos kékkel kiemelt fejlécben kattintson a "Szerkesztés" feliratú gombra.

  4. A felugró ablakban töltse ki igényeinek megfelelően a mezőket, majd kattintson a "Forráskód generálás" feliratú gombra.

  5. Keresse ki a táblázatból az újonnan létrehozott beágyazási beállítást és kattintson a másolás ikonra a forráskód vágólapra másolásához.

1.) Összefoglaló információk

2.) A beágyazandó RESnWEB modul

3.) Sticky header HTML elem beazonosítására szolgáló CSS selector

4.) Az "Elküldöm magamnak e-mail-en" popup gombjának pozíciója a képernyőn (jobb vagy bal alsó sarok).

5.) A foglalási rendszer alapértelmezett nyelve

6.) A foglalói felület alapértelmezett valutaneme

A foglalói felület beágyazó kódjainak legenerálása azután lesz lehetséges, hogy rögzítésre kerülnek rendszerünkben azon aloldalak URL címei - idegen nyelvű verzióké is - , ahol a felületek meg fognak jelenni. Például: https://resnweb.com/online-foglalas

Abban az esetben, ha nem látja a felületekhez tartozó URL címeket a listában, kérjük, küldje el részünkre azokat az info@resnweb.com email címre! A rendszerbe való felvitelt követően az URL címek megjelennek a listában és a Szerkesztés gombra kattintás után lehetséges lesz a forráskódok legenerálása.

FONTOS! Nyelvenként és felületenként egy URL rögzíthető a rendszerben. Ez azt jelenti, hogy ha a weboldal több aloldaláról is szeretné elérhetővé tenni felületeinket, akkor ezeken az aloldalakon egy-egy gombot szükséges elhelyezni, melyek mögé a felületek aloldalainak URL címét szükséges beilleszteni. Így bármelyik oldalról is indul a vendég, ugyanarra az aloldalra kerül át.

A beágyazás beállításainak módosítása

  1. A világos kékkel kiemelt fejlécben kattintson a "Szerkesztés" feliratú gombra.

  2. A "Modul" feliratú lenyíló listából válassza ki azt a modult, amelyiknek módosítani szeretné a beágyazási beállításait.

  3. Végezze el a kívánt módosításokat, majd kattintson a "Mentés" gombra

Beágyazás

Beágyazás esetén a RESnWEB adminisztrációs felületén generált kód beillesztése szükséges a HTML dokumentum nyitó <body> címkéje után. Az iframe közvetlenül a beillesztett kód után ékelődik be a DOM-ba, ezért fontos szempont lehet a beillesztés helye.

A RESnWEB adminisztrációs felületének “Webmestereknek” menüpontjában generált kód a következőképpen néz ki:

Beágyazó kód minta

<script src="https://nethotelbooking.net/embed.RESnWEB.js?id=MINTA"></script>

Felület megjelenése

Asztali nézet: A felület úgy kerüljön beépítésre a honlapba, hogy 3 hónap legyen látható a naptárban, viszont ne legyen teljes oldalszélességre kiengedve.

Mobil nézet: A foglalói felület olyan mobil eszközökre lett optimalizálva, melyeknek a kijelző szélessége legalább 320 képpontból áll. A helyes megjelenés érdekében érdemes ügyelni arra, hogy a beágyazott felület ezeken az eszközökön teljes képernyőszélességben meg tudjon jelenni. Ennek érdekében szükségessé válhat a beágyazó kódot tartalmazó HTML elem padding és margin CSS tulajdonságainak 0-ra állítása kisebb kijelzők esetén.

Ez a beállítás a felhasználói élmény növelésén túl azért is fontos, hogy szűkebb kijelzőjű mobileszközökön se járjon funkcióvesztéssel a felület.

Foglalás gombbal kapcsolatos javaslatok

  • A gombon javasoljuk az Árkalkuláció & Foglalás kifejezést megjelentetni.

  • A gombot célszerű minden releváns aloldalon elhelyezni, hogy a vendégek könnyen megtalálják. pl: Főoldal, Hotel bemutatkozás, Szobatípusok, Galéria, Kapcsolat

Segítségképp további javaslatokat is összegyűjtöttünk a direkt foglalások növelése érdekében, melyek az alábbi gombra kattintva tekinthetők meg.

A foglalási rendszer paraméterezése

Bizonyos esetekben igény merülhet fel arra, hogy egy látogató korábban már megadott paramétereket felhasználva érkezzen a foglalói felületre (pl.: a szálláshely oldalán használt dátumválasztóval). Ezt elérhetjük az URL megfelelő összeállításával.

Iframe használata esetén a szálláshely azon aloldalának URL-jét kell kiegészíteni GET paraméterekkel, amelyen a foglalási rendszer megjelenik. Az első paramétert a felület URL címe mögé ‘?’ megadását követően szükséges elhelyezni. A paraméterek felsorolása ‘&’ jellel elválasztva és ‘rnw_’ előtag használatával történik.

Példa:

https://example.com/foglalas/?rnw_lang=hu&rnw_arrive=2020-09-21&rnw_departure=2020-09-26&rnw_roomrepls=2,1,3:2&rnw_curr=EUR&rnw_noredir=true

Megadható paraméterek

Paraméterek

Leírás

Példa

rnw_arrive

érkezés dátuma

2020-01-01

rnw_departure

távozás dátuma

2020-01-02

rnw_roomrepls

létszámadatok *

2,1,3:2,2,6,5

rnw_noredir

továbbirányítás letiltása

false

rnw_code

promó kód

pl: torzsvendeg

rnw_curr

valutanem ISO kódja (3 karakter, nagybetűkkel)

HUF

rnw_lang

foglalási felület nyelvének ISO kódja (2 karakter)

  • hu - magyar,

  • en - angol,

  • de - német,

  • it - olasz,

  • sk - szlovák,

  • ro - román,

  • sr - szerb,

  • cs - cseh,

  • ru - orosz,

  • pl - lengyel

rnw_servicePackage

a megadott kiegészítő szolgáltatás(ok) kijelölésre kerül(nek) a felületen **

2547,2:5755

rnw_pinToTop

pinToTop

a megadott szobatípus rögzítése a találati lista elejére

2117

* A létszámadatok az alábbiak szerint épülnek fel:

** A kiegészítő szolgáltatások megadása az alábbiak szerint lehetséges:

A paraméter tartalma minden esetben ugyanaz. Az azonosító kötelező elem, a darabszám elhagyható, ilyenkor a rendszer 1 darabbal számol.

Dátumválasztót érintő beállítások

1. A vendégnek ne legyen lehetősége manuálisan megadni a dátumot, hanem a gombokon

a) az Érkezés és Távozás felirat szerepeljen, vagy

b) az érkezés napjához alapértelmezetten az aznapi dátum, a távozás napjához pedig a másnapi vagy harmadnapi dátum kerüljön megadásra.

2. A naptár a gomb bármely területére kattintva jelenjen meg.

3. Fontos, hogy csak jövőbeli dátum kiválasztása legyen lehetséges, ezért a múltbéli dátumok letiltása szükséges a naptárban.

Hibaelhárítás

  • Ellenőrizze, hogy a megadott szálláshely azonosító és beágyazási kulcs megfelelő-e

  • Tartalomkezelő rendszerek (CMS) keretein belül történő beágyazásnál érdemes a böngésző fejlesztői eszköztárának segítségével meggyőződni arról, hogy a beillesztett kód felépítése megfelel a követelményeknek (a változónevek megfelelőek, a távoli JavaScript fájl hivatkozása helyesnek bizonyul).

  • Ellenőrizze, a böngésző fejlesztői eszközeivel, hogy program futás közben nem történt-e hiba

Automatikus görgetés beállítása

Beágyazott foglalási felület esetén a böngésző alapértelmezetten az iframe tetejéhez görget. Előfordulhat azonban, hogy a weboldalon található tartalom indokolja, hogy az oldal tetejére irányítsuk a látogatót. A RESnWEB adminisztrációs felületén beállítható, hogy mely lépéseknél görgessen a böngésző a lap tetejére. A beállítás az alábbi instrukciók követésével végrehajtható:

  1. Jelentkezzen be a RESnWEB adminisztrációs felületére!

  2. Kattintson a főmenüben a 'Hoteladatok' menüpontra, majd a lenyíló almenüben válassza ki a 'Webmestereknek' menüpontot!

    Kattintson a főmenüben a 'Hoteladatok' menüpontra, majd a lenyíló almenüben válassza ki a 'Webmestereknek' menüpontot


  3. Ezt követően keresse meg az 'Oldalak navigálása' szekciót!

  4. Jelölje be a foglalási folyamat azon lépéseit, amelyeknél az oldal tetejére szeretné irányítani a látogatót!


  5. A módosítások rögzítéséhez kattintson a 'Mentés' gombra!

Ragadós (sticky) fejléc használata

A weboldalon található ragadós fejléc releváns információkat és funkciókat takar ki a felületeinkből, így kérjük az alábbi beállítás elvégzését, melynek köszönhetően a felület figyelembe veszi a fejléc magasságát és az oldal tartalmát az alatt jeleníti meg.

A RESnWEB adminisztrációs felületén a "Webmestereknek" menüpontban van lehetőség a rögzített fejléc beállítására.

Használható ID, class, illetve attributum is.

Pl. #sticky-headers, .sticky-headers


FONTOS! HTML tag nem adható meg.

Választ kapott a kérdésére?