Podstawowe ustawienia Reservation+

Jak załadować silnik R+ na stronę www:
1. Wstaw następujący kod na stronę:

<!-- Reservation PLUS start -->
<script type="text/javascript" src="https://booking.previo.cz/iframe/"></script>
<iframe src="https://booking.previo.cz/?hotId=123456" scrolling="no" frameborder="0"
width="727" height="2000" name="previo-booking-iframe" id="previo-booking-iframe"
allowTransparency="true"></iframe>
<!-- Reservation PLUS end -->


Obowiązkowe parametry iframe atrybutu SRC:

hotId=123456 – ID Twojego obiektu noclegowego widoczne jest w pasku adresu przeglądarki po zalogowaniu do Previo:

Znajdziesz je też zawsze w menu Pomoc -> O aplikacji 

Opcjonalne parametry elementu iframe atrybutu SRC:
 Parametry ogólne

• lang=en – oznaczanie poszczególnych wersji językowych (cs = czeski, en = angielski, de = niemiecki, ru =
  rosyjski, sk = słowacki, it = włoski, fr = francuski, es = hiszpański, pl = polski, zh –
  chiński, ro = rumuński, sl = słoweński, uk = ukraiński)
• currency=CZK – oznaczanie dostępnych walut (CZK = korona czeska, USD = dolar amerykański, EUR = euro, GBP – funt brytyjski, RUB – rubel rosyjski, PLN – złoty polski, UAH – hrywna ukraińska, HUF – forint węgierski)
• showTabs=reservation-maps – pozwoli na wybór zakładek ramki silnika, które chcesz w niej wyświetlać; w podanym tutaj przykładzie wskazujesz, że chcesz wyświetlić 2 sekcje ramki: zakładkę “rezerwacja” i “mapa”, pozostałe zakładki pozostaną ukryte w ramce silnika.
  —
  Zakładki do wyboru w ramach parametru showTabs to:„reservation” – wyszukiwarka z formularzem rezerwacji
  „stay” – pakiety pobytowe, które oferujesz jako oddzielną usługę (ustawienia w Previo w sekcji Ceny / Pakiety pobytowe), np.:
  „review” – zatwierdzone i opublikowane przez Ciebie opinie gości o pobycie w Twoim obiekcie.
  Szczegółowy opis działania i ustawień modułu recenzji w PMS Previo
  „pricelist” – kalendarz cen z możliwością przejścia do formularza rezerwacji online
  „occupancy” – kalendarz dostępności w obiekcie z możliwością przejścia do formularza rezerwacji online
  „map” – mapa ze wskazaniem lokalizacji obiektu/ów
  „coupon” – formularz zamówienia voucherów upominkowych
  „hotels” (pl: Lista obiektów) – lista wszystkich obiektów w grupie, dotyczy sieci hoteli, których licencje w Previo zostały zgrupowane w jedną grupę hotelową. Więcej informacji na ten temat uzyskasz w naszym Dziale Wsparcia.Oto zrzut przykładowego silnika R+ z listą najpopularniejszych zakładek:
  A tu przykład zastosowania jedynie kilku wybranych zakładek:
  Nazwy poszczególnych zakładek w parametrze showTabs oddzielaj myślnikiem.

hideTabs=stay-review-pricelist-occupancy – ukryj wybraną sekcję z listy j.w. Jeśli zakładek, które chcsz ukryć ma być więcej, ich nazwy oddziel myślnikiem, jak widać na naszym przykładzie.
theme=kolor szablonu – możliwe opcje to: dark, orange, red, green, gray, bordo, brown, purple, theme01, darkblue, black, darkbrown, lightorange, darkgreen, lightgreen, wine, violet, darkpink, gold, naturegreen, pink, darkmode-gold, darkmode-cyan, darkmode-gray, darkmode-pink, darkmode-blue, darkmode-orange, darkmode-green:

ga=UA-1234567-8 – kod konta Google Analytics (Identyfikator usługi) do pomiaru ruchu
hotelDetail=1, pokazuje szczegóły w nagłówku (logo, nazwa, liczba gwiazdek, adres, opinie, krótki opis i zdjęcia). Odpowiednie zwłaszcza, jeśli formularz znajduje się w nowym oknie lub gdy odsyłasz do niego z innych stron:
showHotels=XXX-YYY, za pomocą parametru można wybrać, które hotele z grupy będą wyświetlane w sekcji „Lista obiektów” oraz w zakładce „Mapa” w IBE. Po = po prostu wprowadź identyfikatory profili, a jeśli chcesz wyświetlić więcej niż jeden profil, oddziel identyfikatory myślnikiem. Np.: showHotels=730562-730700

Parametry zakładki Rezerwacja:

guestFilter=1, wyświetla filtr dla liczby gości. Może być używany razem z parametrem „arrival”. Konkretną liczbę gości można ustawić dodatkowymi parametrami numberOfAdults=X i childAges=X-Y. Bez tych parametrów automatycznie wypełnimy wstępnie 2 osoby dorosłe jako najczęstszą opcję.
showRoomType=546, formularz rezerwacji wyświetli tylko niektóre pokoje (zgodnie z identyfikatorami pokoi), jeśli chcesz wyświetlić więcej pokoi, oddziel je myślnikiem: showRoomType=12345-6543-8974
highlightRoomType=546, wybrany typ pokoju zostanie podświetlony w Twoim IBE (zastąp 546 numerem identyfikacyjnym typu pokoju) Pokój zostanie przeniesiony na pierwsze miejsce wśród wszystkich pokoi, a jego cena zostanie automatycznie rozwinięta, więc opcje cen (nrr itp.) widoczne będą od razu.
DiscountCoupon=ABC2017, automatycznie wypełnia kupon rabatowy w pierwszym kroku formularza rezerwacji
expandPrices=1 – pokaż ceny dla wszystkich ilości gości w pokoju w drugim kroku rezerwacji
expandServices=1, w trzecim kroku IBE w usługach hotelowych zostanie wyświetlona zakładka „Wszystkie” pokazująca wszystkie niewymienione usługi + zostaną również wyświetlone wszystkie usługi z grup usług.
hideSoldRooms=1 ukryje wyprzedane lub zamknięte do sprzedaży pokoje z listy.
hideBenefits=1 ukryje motywatory tekstowe i graficzne w pierwszym kroku procesu rezerwacji

selectionRoomType=button/number, który decyduje o tym, czy wyświetlić pole wyboru z liczbą pokoi, czy przycisk „wybierz” na liście pokoi w wynikach wyszukiwania

Parametry ostatniego kroku rezerwacji:

showGuestDetail=1, rozwija formularz z informacjami o gościu w ostatnim kroku formularza rezerwacji
showNote=1, rozwija notatkę w czwartym kroku formularza rezerwacji.
mandatoryData: name-address-country-passport-visa – określa obowiązkowe dane, które klient musi wypełnić w trzecim kroku formularza rezerwacji. („name” – pełna nazwa/godność, „country” – kraj, „adress” – pełny adres, „viza” – numer wizy)
redirectUrl=http://www.mydomain.com/thank-you-for-reservation – adres URL, na który zostanie przekierowany
ostatni krok formularza rezerwacyjnego po złożeniu zamówienia. Możesz także użyć opcjonalnego parametru redirectType=iframe/parent, który przekieruje Cię na wybraną stronę wewnątrz iframe lub w witrynie nadrzędnej. Jeśli nie użyjesz tego parametru, opcja iframe zostanie wybrana automatycznie. Wówczas przesłane zostaną następujące parametry GET:

– Pole comIds – numery właśnie utworzonych rezerwacji, szczegółowe informacje można wtedy uzyskać funkcjami API (np. Hotels.searchBonuses).
– price – całkowita cena rezerwacji
– currency – waluta rezerwacji
– arrival – data przybycia w formacie RRRR-MM-DD
– departure – data wyjazdu w formacie RRRR-MM-DD
– customerName – imię i nazwisko osoby kontaktowej
– customerEmail – email osoby kontaktowej

Parametry dla zakładek Cennik/Dostępność:

pricelistType=seasons / pricelistType=rooms, cennik wyświetla się automatycznie w wariancie „rooms” (po wybraniu pokoju do wyświetlenia kalendarza), jeśli masz więcej niż 4 sezony cenowe w przyszłości. Jeśli użyjesz parametru pricelistType=seasons lub masz mniej niż 4 sezony cennikowe w przyszłości, cennik wyświetli się jako tabela z cenami wszystkich pokoi, gdzie zamiast rodzaju pokoju wybierasz tylko datę wyświetlenia ceny.
numOfGuests=min/max/liczba – określa liczbę gości, która jest wstępnie wybrana przy wyborze pokoju. Min. zawsze pokazuje ceny za 1 osobę (niezależnie od pojemności pokoju). Max zawsze wyświetla cenę za pełną pojemność głównych łóżek w danym pokoju.
showOccupancyTabs=object/objectKind/object-objectKind – parametr określa, które zakładki będą wyświetlane w sekcji Dostępność. Obiekt (object) to obłożenie określonych pokoi, rodzaj obiektu (objectKind) to obłożenie kategorii pokoi, a użycie obu parametrów oddzielonych myślnikiem spowoduje wyświetlenie obu zakładek.
drawOccupancyBy=object/objectKind – określa, która zakładka będzie wyświetlana domyślnie w sekcji Dostępność. “object” – według konkretnych pokoi”, “objectKind” – według typów pokoi

Parametry dla pakietów:

showStays=12345, wyświetlą się tylko wybrane pakiety pobytowe (zgodnie z ID pakietu), aby wprowadzić kilka pakietów użyj myślnika: showStays=123-456-789
stayPricesPerRoom=1, wyświetli pakiety liczone za pokój (i ich cenę) zgodnie z tą logiką i nie przeliczy ceny za osobę (czyli przy zamówieniu zostanie wyświetlona najniższa cena za cały pokój, a nie najniższa cena obliczona za osobę w pakiecie)

Parametry dla kuponów:

Jeśli używamy parametrów &showTabs=coupon&couponType=cash lub &showTabs=coupon&couponType=stay dodatkowo można też dopasować zdjęcie nagłówka za pomocą parametru:

couponHeader=1-5 (#1 to domyślne zdjęcie “natury”, inne opcje są bardziej neutralne i pasujące do kuponów sprzedawanych jako upominek).

Parametry sprzedaży usług dodatkowych/godzinowych/minutowych bez/niezależnie od rezerwacji zakwaterowania (showTabs=service)

• serviceListType=XXX (lista/kafelki) – domyślnie usługi można wyświetlić w R+ w formie listy lub kafelek z opcją przełączania pomiędzy nimi. Użycie tego parametru spowoduje, że jeden z tych sposobów będzie wskazany odgórnie bez możliwości zmiany.
• showServices=12345-23456-34567 – Zakładka z usługami pokaże tylko te usługi wkazane konkretnymi numerami ID (ID usługi widoczne jest na liście usług w Previo, w lewej kolumnie obok wybranej usługi).
• showServicesGroup=222333 – pokaże grupę usług o określonym ID (ID grupy usług widoczne jest w szczegółach usługi)
• serviceId=12345 – link for booking of specific service by ID (see showServices parameter above). Using the extra parameter &arrival=DD.MM.YYYY you can also preselect specific date. Arrival parameter is optional.
  Szczegółowa instrukcja sprzedaży online usług dodatkowych bez noclegu

Przykład użycia parametrów opcjonalnych:

Ukrywanie zakładki obłożenia i wyświetlanie formularza w języku angielskim:

<!-- Reservation PLUS start -->
<div class="previo-reservation-form">
<script type="text/javascript" src="https://booking.previo.cz/iframe/"></script>
<iframe src="https://booking.previo.cz/?hotId=123456&lang=en&hideTabs=occupancy" scrolling="no" frameborder="0" width="100%" height="2000" name="previo-booking-iframe" id="previo-booking-iframe" allowTransparency="true"></iframe>
</div>
<!-- Reservation PLUS end -->

PAMIĘTAJ, aby parametry podawać zawsze w jęz. angielskim, np. hideTabs=occupancy, showTabs=stay-review