Parametry do widgetu Booking Engine

Widget rezerwacyjny NFHotel pozwala osadzić na stronie internetowej funkcjonalność rezerwacji pobytu w obiekcie. Dzięki niemu gość może wybrać datę, liczbę osób, sprawdzić dostępność i przejść do finalizacji rezerwacji – bez konieczności opuszczania strony hotelu. Poniższa instrukcja pokazuje, jak poprawnie osadzić widget i dostosować go do potrzeb obiektu.

1. Identyfikator obiektu (id)

Opis:

Unikalne ID obiektu w systemie Booking Engine. Można przekazać jedno ID (dla jednego obiektu) lub listę ID, jeśli chcemy użyć rozwijanego menu.

Przykłady:

[{ id: 129, name: 'Pokoje' }]

Z językami:

[{ id: 129, name: 'Pokoje', locale: { en: 'Rooms' } }]

Alternatywnie, bez name:

[{ id: 129, locale: { pl: 'Pokoje', en: 'Rooms' } }]

Zasady:

  • name lub locale przynajmniej jedno jest wymagane.
  • Jeśli podano oba, locale ma wyższy priorytet.
  • name domyślnie odnosi się do języka polskiego.

2. Opcje konfiguracji (options)

Style (style):

  • color: Domyślnie: #880d1e (bordowy) – kolor tła przycisku.
  • textColor: Domyślnie: #fff (biały) – kolor tekstu w przycisku.
  • side: Domyślnie: right – pozycja przycisku (left lub right).
  • zIndex: Domyślnie: 99997 – z-index widgetu.

Zachowanie widgetu:

  • startClosed: Domyślnie: false – czy widget ma być początkowo zamknięty.
  • startClosedOnMobile: Domyślnie: false – czy widget ma być zamknięty tylko na urządzeniach mobilnych.

Pozycja przełącznika:

  • mobileToggleY: Domyślnie: 0 – odległość od dołu ekranu na telefonach.
  • mobileToggleX: Domyślnie: 0 – odległość od boku ekranu na telefonach.
  • toggleY: Domyślnie: 0 – odległość od dołu ekranu na desktopach.
  • toggleX: Domyślnie: 0 – odległość od boku ekranu na desktopach.

3. Lokalizacja (locale)

  • [code]: kod języka (np. pl, en, de).
  • arrival: tekst dla "przybycie".
  • departure: tekst dla "wyjazd".
  • reserve: tekst dla "rezerwacja".
  • months: nazwy miesięcy.
  • days: skrócone nazwy dni tygodnia.
  • forPets: Domyślnie: false – czy rezerwacja dotyczy zwierząt.

Domyślne języki: Polski (pl), angielski (en), niemiecki (de), czeski (cs), rosyjski (ru).

Przykłady konfiguracji

Przykład 1: Konfiguracja prostego widgetu

nfHotelBooking.setup(129, {
style: { color: '#880d1e', side: 'left' },
locale: {
pl: { reserve: 'Sprawdź dostępność' },
fr: { arrival: 'oui on', departure: 'un departure', reserve: 'croissant' }
}
});

Przykład 2: Widget z listą obiektów

nfHotelBooking.setup([
{ id: 129, name: 'Pokoje' },
{ id: 128, locale: { pl: 'Apartamenty', en: 'Apartments' } }
], {
style: { textColor: '#000', startClosedOnMobile: true }
});