konfiguracja i podłączenie

WYSZUKIWARKA SAMOCHODÓW
XCAR
KONFIGURACJA I PODŁĄCZENIE
(wersja z 23.10.2014)
1 / 26
Spis treści
I. KONFIGURACJA.............................................................................................3
1. Dodawanie i usuwanie afiatu.......................................................................................................... 3
2. Profl Agencji................................................................................................................................... 4
2.1. Dane Agencji................................................................................................................................4
2.2. Profl IBE.......................................................................................................................................4
2.3. Zgłoszenia.....................................................................................................................................4
3. Konfguracja szablonu....................................................................................................................... 4
3.1. Kolory...........................................................................................................................................4
3.2. Szerokość......................................................................................................................................5
3.3. Ustawienia wyglądu.....................................................................................................................5
3.4. Teksty...........................................................................................................................................6
4. Wypożyczalnie................................................................................................................................. 7
5. KONFIGURACJA PŁATNOŚCI.............................................................................................................. 7
5.1. Płatność ofine............................................................................................................................8
5.2. Płatność online..........................................................................................................................10
5.3 Założenia:....................................................................................................................................14
6. Portale społecznościowe................................................................................................................ 15
7. Reklamy........................................................................................................................................ 15
8. Boxy ofertowe............................................................................................................................... 16
8.1. Lista boxów................................................................................................................................16
8.2. Modyfkuj Boxa..........................................................................................................................18
8.3. Dodaj nowy box.........................................................................................................................20
II. PODŁĄCZENIE.............................................................................................21
1. FREE-install – jako odwołanie bezpośrednio do naszych serwerów.................................................21
1.1. Podłączenie w ramce.................................................................................................................21
1.2. Wywołanie w osobnym oknie....................................................................................................21
2. GATE – wyszukiwarka osadzona na Twojej stronie internetowej.....................................................22
2.1. Osadzenie wyszukiwarki - kroki 1 - 3.........................................................................................22
2.2. Osadzenie – krok 4 i 5................................................................................................................23
2.3. Rozpoznanie etapu wyszukiwania.............................................................................................23
3. Boksy ofertowe.............................................................................................................................. 24
3.1. Implementacja boksów na stronie z wyszukiwarką Hoteli........................................................24
3.2. Implementacja boksów na stronie bez wyszukiwarki Hoteli (PHP)...........................................25
3.2. Implementacja boksów na stronie bez wyszukiwarki Hoteli (JavaScript)..................................26
2 / 26
I. KONFIGURACJA
Aby skonfgurować własną wyszukiwarkę należy przejść do panelu administracyjnego. W tym celu
logujemy się na stronie htp://ibe01.merlinx.pl/panel/, używając loginu i hasła, które otrzymaliśmy
przy zakupie usługi.
1. Dodawanie i usuwanie afiatu
Przy pierwszym logowaniu należy zacząć od utworzenia nowego afiatu. W tym celu należy nacisnąć
przycisk DODAJ znajdujący się w prawym górnym rogu.
Następnie podajemy nazwę afiatu (prosimy nie używać znaków specjalnych – kropek, spacji,
wykrzykników, nawiasów itp. oraz polskich liter; dozwolone są: litery, cyfry, myślniki, znak
podkreślenia), aktywujemy easyCar i klikamy ZAPISZ.
Możemy stworzyć kilka różnych afiatów. Przy kolejnym logowaniu wystarczy wybrać afiat który
chcemy edytować / konfgurować z listy znajdującej się w lewym górnym rogu panelu.
Aby usunąć afiat należy wybrać jego nazwę z listy afiatów, a następnie nacisnąć przycisk USUŃ.
Po kliknięciu ikony OTWÓRZ skonfgurowana wyszukiwarka otworzy się w nowym oknie przeglądarki
internetowej, gdzie możemy ją przetestować.
3 / 26
2. Profl Agencji
2.1. Dane Agencji
Podaj podstawowe dane Agencji takie jak nazwa Agencji, a także inne dane teleadresowe. Ważne jest
podanie adresu e-mail.
2.2. Profl IBE
W tej zakładce podajemy dane dotyczące wyszukiwarki m.in. na jakiej stronie zostanie ona
umieszczona. Bardzo ważne jest podanie adresu url dla kroku 3 (formularz rezerwacyjny). Po
konfguracji należy pamiętać o zapisaniu ustawień.























Adres strony www – adres strony, na której zostanie umieszczona wyszukiwarka
Adres podstrony z wyszukiwarką (dla GATE) – jeżeli jest inny niż strona główna
Adres podstrony z rezerwacją (dla GATE) – adres podstrony z formularzem rezerwacyjnym
Mail dla zgłoszeń – adres mailowy, na który będą wysyłane zgłoszenia ze strony
Język lokalizacji wyszukiwarki – język, w którym będzie obsługiwana wyszukiwarka
Ustawienie domyślnego kraju płatnika – domyśly kraj pochodzenia płatnika
Ustawienia sugestera – ustawienia podpowiedzi dla wyszukiwarki
Ilość ofert na stronę – ilość ofert prezentowanych na 2 kroku
Kolumna Boczna – umiejscowienie kryteriów wyszukiwania i fltrów na 2 kroku
Zwrot w innym miejscu – możliwość zwrotu auta w innym miejscu niż był odebrany
Wyszukiwarka boczna – może być zwinięta, rozwinięta bądź niewidoczna
Postęp ładowania – pasek stanu wyszukiwania ofert
Pokazuj klasę pojazdów – położenie informacji o klasie pojazdu w 2 kroku
Filtry - mogą być zwinięte lub rozwinięte
Konfguracja wyświetlanie fltrów – co mają zawierać fltry na 2 kroku
Przydatne informacje - mogą być zwinięte lub rozwinięte
Deeplink – możliwość wygenerowania linku do strony z ofertami
Ostatnio oglądane – obejrzane oferty
Reklama – mozliwość umieszczenia reklamy na 2 kroku
Ważne informacje - mogą być zwinięte lub rozwinięte
Społeczności – możliwość opublikowania ofert na portalach społecznościowych
Wyświetlanie ofert– mogą być wyświetlane w tym samym lub nowym oknie
Konfguracja Własnego Serwera SMTP – możliwość konfgurowania poczty e-mail
2.3. Zgłoszenia
W tej zakładce możemy przeglądać zgłoszenia rezerwacji dokonane na naszej stronie.
3. Konfguracja szablonu
3.1. Kolory
W zakładce KOLORY ustawiamy kolory poszczególnych elementów korzystając z palety kolorów.
Zmiany należy zapisać.
4 / 26
3.2. Szerokość
W zakładce SZEROKOŚĆ używając suwaka ustawiamy szerokość wyszukiwarki dopasowaną do własnej
strony internetowej. Osobne ustawienie dla wyszukiwarki głównej (step 1) oraz dla pozostałych
kroków (step 2-4). Uwaga, przy pozostałych krokach ustawienie dotyczy części głównej wyszukiwarki,
bez ftrów i wyszukiwarki pomocniczej pionowej. Te dodatkowe elementy mają stałą szerokość. Po
ustawieniu szerokości zmiany należy zapisać.
3.3. Ustawienia wyglądu
W zakładce tej możemy dokonać ustawień wyglądu wyszukiwarki:
5 / 26
Zaokrąglenia nagłówków – zaokrąglenie rogów wyszukiwarki
Zaokrąglenia pól – zaokrąglenie pól wyszukiwarki
Zaokrąglenia przycisków Zaokrąglenia okienek – zaokrąglenie okienek z informacjami na 2 kroku
3.4. Teksty
Są to domyślne teksty wysyłane klientowi na maila. Teksty można edytować.
6 / 26
4. Wypożyczalnie
Lista dostawców dostępnych w wyszukiwarce.
5. KONFIGURACJA PŁATNOŚCI
Aby skonfgurować obsługę płatności dla wyszukiwarki, należy przejść do panelu konfguracyjnego.
W tym celu logujemy się na stronie htp://ibe01.merlinx.pl/panel/, używając loginu i hasła, które
otrzymaliśmy przy zakupie usługi.
Po zalogowaniu przechodzimy do zakładki "Profl Agencji", następnie wybieramy pod zakładkę
"Płatności".
Możemy stworzyć dwie formy obsługi płatności: Płatność ofine lub Płatność online.
Istnieje możliwość dodania odstępu pomiędzy rodzajami płatności
Obrazek 1. Wybór płatności.
Obrazek2. po wybraniu płatności ofine.
7 / 26
Aby nazwa usługi wyświetlała się na stronie z podłączeniem xfy na 3/4 stepie, niezbędne jest
uzupełnienie pól:
• Nazwa płatności do remarków (Uwaga: Nazwa może składać się tylko z dużych/małych liter (bez
znaków diakrytycznych) i cyfr)
• Nazwa płatności (po wprowadzeniu- domyślnie jest wyświetlana na xfy na 3/4 stepie,
jeżeli nie będzie uzupełniona, będzie pokazywało dla podanej usługi nazwę z pola ”Nazwa
płatności
do reemarków ”
Po zdefniowaniu nazw płatności, przechodzimy do ustawień:
Marża/upust
• Aby uruchomić dane ustawienie zaznaczamy checkbox "Wł."
• Wszystkie wprowadzone wartości w polu Marża/upust - przelicza domyślnie z wartości
procentowej.
• Możemy sterować obsługą danej płatności poprzez przekierowanie Online (dokonując rezerwacji)
bądź ofine (wysyłając tylko zgłoszenie).
W Panelu IBE xHotele - zakładka ”Profil Agencji” - pod zakładka ”Profl IBE” - w Ustawieniach kroku 3
• możemy określić sposób wyświetlenia kosztów płatności (na podstawie tego co
zdefiniowaliśmy w marży) jako: wartość procentową, kwotową, bądź pokazywanie w usłudze
cene całkowitą.
Po wybraniu formy płatności: Płatność ofine – mamy do wyboru 3 opcje obsługi:
5.1. Płatność ofine
a) Płatność ofine – procedura Domyślna
Jest to płatność która po włączeniu w panelu XFLY - występuje na stronie z podłączeniem xfy
na 3/4 stepie:
• nie ma żadnego formularza do karty,
8 / 26
• nie przekazuje informacji do serwisu płatności.
Jeżeli dla "Płatności ofine – Domyślnej" – ustawimy tryb online, przekaże informacje o
płatności w reemarkach do do Organizatora jeżeli to obsługuje (np. Sabre GDS (XSAB)
obsługuje reemarki)
b) Płatność ofine - procedura Płatność manualna
Jest to płatność która po włączeniu w panelu XFLY - występuje na stronie z podłączeniem xfy
na 3/4 stepie:
• pojawi się dodatkowy formularz z kartą kredytową
• dane z karty zostaną przekazane mailowo do Agenta i do reemarków do Organizatora jeżeli
to obsługuje
(np. Sabre GDS (XSAB) obsługuje reemarki)
c) Płatność ofine – procedura Faktura
• Po wybraniu typu "Płatność ofine z procedurą: Faktura" – klikamy na przycisk: "Dane
kontaktowe" w celu uzupełnienia niezbędnych pól do prawidłowej obsługi opcji faktury:
• Dla opcji: "Cena" - mamy możliwość wyboru ustawienia obsługi: VAT i marża, bądź tylko
koszt przelotu
• Możemy ustawić wysyłkę kopi do agenta i tekst jaki ma być widoczny na potwierdzeniu.
Obrazek3. po wybraniu płatności ofine – Procedura Faktura.
9 / 26
5.2. Płatność online
Po wybraniu formy płatności: Płatność online – mamy do wyboru 6 opcji obsługi:
a) Płatność online: procedura Domyślna (taka co była dotychczas: przelew/karta kredytowa)
10 / 26
b) Płatność online: procedura dotPay
• Po wybraniu typu "Płatność online: z procedurą: dotPay" – klikamy na przycisk: "Dane
kontaktowe"
w celu uzupełnienia niezbędnych pól: ”Klient ID”, ”URLC PIN ” do prawidłowej obsługi.
c) Płatność online: procedura payU
• Po wybraniu typu "Płatność online: z procedurą: payU" – klikamy na przycisk: "Dane
kontaktowe" w celu uzupełnienia niezbędnych pól: ”Klient ID”, ”Hasło” do prawidłowej
obsługi.
11 / 26
d) Płatność online: procedura Akbank
• Po wybraniu typu "Płatność online: z procedurą: Akbank" – klikamy na przycisk: "Dane
kontaktowe" w celu uzupełnienia niezbędnych pól: ”Klient ID”, ”Klucz”, ”Użytkownik”, ”Hasło”
do prawidłowej obsługi.
12 / 26
e) Płatność online: procedura Garant
• Po wybraniu typu "Płatność online: z procedurą: Garant" – klikamy na przycisk: "Dane
kontaktowe" w celu uzupełnienia niezbędnych pól: ”ProvUserID”, ”MerchantID”, ”Hasło”,
”Securekey” do prawidłowej obsługi.
f) Płatność online: procedura GT Bank
• Po wybraniu typu "Płatność online: z procedurą: Akbank" – klikamy na przycisk: "Dane
kontaktowe" w celu uzupełnienia niezbędnych pól: ”MerchantID”, ”Klucz”, ”Użytkownik”, ”Hasło”
do prawidłowej obsługi.
13 / 26
5.3 Założenia:
Jeżeli włączymy Płatność online - na stronie z podłączeniem xfy na 3/4 stepie:
Dla Touroperatorów: Sabre GDS (XSAB), Word Span (XWTP), Turkish airlines (XTKY), Atlasjet
(XFKK)
• obsługa płatności - zostanie dokonana po rezerwacji
• przy obsłudze płatności bierze pod uwagę całkowitą kwotę rezerwacji
(tj. Cena całkowita za wszystkich pasażerów, Podatki, Opłata transakcyjna)
Jeżeli włączymy Płatność online - na stronie z podłączeniem xfy na 3/4 stepie:
Dla Touroperatorów: Travel Fusion (XTVF)
• obsługa płatności - zostanie dokonana przed rezerwacją
• przy obsłudze płatności bierze pod uwagę tylko opłatę transakcyjną i na podstawie tego
wyliczana jest
wartość w procentach.
Jeżeli włączymy Płatność ofine - na stronie z podłączeniem xfy na 3/4 stepie:
dla wszystkich Touroperatorów:
• zostanie wysłana tylko informacja o typie płatności do agenta,
• sama płatność nie zostanie dokonana i możliwe jest wysłanie dodatkowych informacji w
reemarkach w zależności od wybranej procedury.
14 / 26
6. Portale społecznościowe
Możliwość publikowania ofert na poszczególnych portalach społecznościowych
7. Reklamy
możliwość umieszczenia banerów reklamowych na 2 kroku wyszukiwania
15 / 26
8. Boxy ofertowe
Do konfguracji boxów ofertowych wykorzystujemy panel konfguracyjny IBE. W nowej
zakładce „Boxy ofertowe” możemy zapoznać się z aktualną listą zaprojektowanych już boxów,
a także je modyfkować oraz tworzyć nowe.
8.1. Lista boxów
16 / 26
Na liście boxów widzimy:
 aktualną nazwę boxa wraz z informacją, ile ofert znaleziono na podane w boxie
parametry,
 informację, czy box był gdzieś wykorzystywany w ciągu ostatniego miesiąca
(aktywny),
 informację o numerze identyfkacyjnym boxa, który wykorzystujemy przy
implementacji,
 przycisk umożliwiający skopiowanie parametrów boxa do nowego,
17 / 26
 przycisk umożliwiający usunięcie danego boxa.
8.2. Modyfkuj Boxa
Edycja boxa umożliwia szeroki wachlarz ustawień. Ustawienia generacji boxa ograniczyliśmy
do 4 elementów:
 Nagłówek
 Ogólny wygląd boxa
 Wygląd ofert
 Kryteria wyszukiwania ofert.
O wyglądzie nagłówka decydują następujące parametry:
 „Typ nagłówka” – ogólna budowa tego elementu.
 „Tytuł boxa” – zarówno nazwa boxa na liście jak i główny tekst widoczny u góry.
 „Krój czcionki” – możliwość ustawienia stylu tekstu.
 „Tytuł – rozmiar czcionki” – opcja zmiany rozmiaru tekstu w pikselach.
 „Kolor tła nagłówka” – otwiera paletę barw nagłówka.
 „Tytuł – kolor tekstu” – otwiera paletę barw tekstu tytułu.
Na ogólny wygląd boxa składają się poniższe parametry:
 „Typ boxa” – decyduje o rodzaju wyświetlanego boxa. Można tu również wybrać tryb
czystych danych tekstowych, który zaawansowanym użytkownikom pozwoli na
stworzenie swoich własnych stylów prezentacji danych.
 „Adres landing page” – należy tu podać stronę, na którą zostanie przekierowany
18 / 26






użytkownik po kliknięciu w ofertę na boxie. Do adresu zostaną dodane parametry
zawierające lotnisko wylotowe i docelowe klikniętej oferty.
„Zdjęcie główne” – tutaj wybieramy zdjęcie, które przy wytypowaniu odpowiedniego
boxa będzie w nim zawarte. Proponowane rozmiary zdjęć posiadają wymiary
szerokość : wysokość w stosunku 2 : 1 .
„Typ ramki” – parametr decydujący o obramowaniu boxa.
„Grubość ramki”.
„Szerokość boxa”.
„Kolor ramki”.
„Dodaj cień pod boxem”.
Część „Wygląd oferty” decyduje w jaki sposób dane zostaną przedstawione na boxie.
Parametry składające się na ten element to:
 „Typ oferty” – wygląd lewej części oferty.
 „Typ ceny” – wygląd prawej części oferty.
 „Kategoria hotelu“ - wybór sposobu wyświetlania gwiazdek
 „Oferta – rozmiar czcionki”.
 „Cena – rozmiar czcionki”.
 „Tekst dodatkowy – rozmiar” – parametr decydujący o wielkości liter wszystkich
elementów dodatkowych dla wybranych trybów wyświetlania ofert oraz cen.
 „Krój czcionki”.
 „Oferta – wielkość liter” – sposób wyświetlania głównego elementu opisowego
oferty.
 „Cena – wielkość liter” - sposób wyświetlania cen.
 „Typ separatora ofert” – określa styl linii oddzielającej oferty: ciągła, przerywana,
kropkowana, brak linii.
 „Kolor ikony gwiazdki”.
 „Kolor tekstu oferta”.
 „Kolor tekstu cena”.
 „Kolor tekstów dodatkowych”.
 „Kolor tła ofert nieparzystych”.
 „Kolor tła ofert parzystych”.
 „Kolor tła ofert – podświetlenie” – parametr decydujący o kolorze tła oferty, po
najechaniu na nią myszką.
 „Kolor linii separującej oferty”.
Ostatnim elementem decydującym o wyświetlanym boxie są „Kryteria wyszukiwania ofert”.
Poprzez wykorzystanie tych opcji możemy zadecydować o ofertach wyświetlanych na boxie.
Dwa rodzaje parametrów wchodzą w skład tego elementu.
 „Ilość ofert w boxie” – maksymalna ilość ofert.
 Istnieje również możliwość użycia check boxa „Posortuj po cenie”. Ten parametr
zachowuje kolejność wyświetlanych ofert zgodnie z ustawioną kolejnością lub sortuje
oferty po cenie.
19 / 26
 „Język prezentacji“ - język w jakim mają być prezentowane oferty
Pozostałe parametry w „Kryteriach wyszukiwania ofert” są indywidualne dla każdej oferty:
 „Cel podróży” – wybieramy miasto, gdzie chcemy znaleźć hotele.
 „Promień” – defniuje maksymalną odległość od centrum miasta.
 „Goście” – ilość gości w pokoju.
 „Tekst własny zamiast destynacji” – jeśli nie odpowiada nam proponowany tekst
opisujący ofertę możemy go zastąpić własnym.
 „Szukaj w terminie (od – do)” – parametr decydujący o tym, między którymi datami
ma wystąpić wyszukiwany przez nas pobyt. Możliwe są dwa sposoby wypełnienia tych
parametrów. Pierwszy to podanie konkretnych dat, natomiast drugi, bardziej
dynamiczny, jest taki, iż wpisujemy liczbę dni od dnia dzisiejszego. Np.: wpisując 7 i 14
chcemy aby w momencie wyświetlania boxa pokazywał on oferty dostępne w dniach
pomiędzy tą za tydzień a tą za dwa tygodnie.
 „Ilość dni (od – do)” – w przypadku lotów w obie strony możemy wyznaczyć jak dużo
dni ma minąć pomiędzy wylotem w jedną i w drugą stronę.
 „Kategoria” - ilość gwiazdek.
 „Ocena” – ocena gości.
 „Wyżywienie” – wybieramy rodzaj posiłku.
 „Cena maksymalna” – decyduje o wyświetlaniu lotów w przypadku, gdy cena
przekroczy podaną wartość.
8.3. Dodaj nowy box
Z zakładki tej korzystamy gdy chcemy utworzyć całkiem nowy box ofertowy.
20 / 26
II. PODŁĄCZENIE
1. FREE-install – jako odwołanie bezpośrednio do naszych serwerów
Przy tej opcji nie występuje opłata instalacyjna. Przy pomocy panelu konfguracyjnego
przygotowujemy wyszukiwarkę, w wyniku otrzymujemy link (opis rozdz. I, pkt. 5), który
umieszczamy na własnej stronie internetowej w ramce lub jako hiperłącze do osobnej strony.
1.1. Podłączenie w ramce
Wstawiamy ramkę z wyszukiwarką na swoją stronę. Podajemy adres wygenerowany w
panelu konfguracyjnym np:
<iframe width="900" height="1000" frameborder="0"
src="http://hydra.merlinx.eu/nragencji/
nazwa-afilatu/"></iframe>
1.2. Wywołanie w osobnym oknie
Internauta klika link i zostaje przekierowany na stronę gdzie robi rezerwacje (po kliknięciu
linka użytkownik zobaczy stronę z samą wyszukiwarką).
21 / 26
2. GATE – wyszukiwarka osadzona na Twojej stronie internetowej
Opcja GATE – podłączenie w języku programowania. Oferujemy pełne wsparcie dla PHP.
Nie ma możliwość podłączenia do strony HTML. Wymagania co do serwera: PHP 5.2 z
dostępnymi funkcjami:
 json_decode() htp://www.php.net/manual/en/functon.json-decode.php
 cURL htp://www.php.net/manual/en/book.curl.php
W pierwszej kolejności wgrywamy na swój serwer dostarczoną przez nas bibliotekę
hydra_gate.class.php, jest to biblioteka odpowiadająca za połączenie z naszym serwerem,
(plik modyfujemy tylko w przypadku gdy chcemy podłączyć wyszukiwarkę używając innego
języka programowania niż PHP). Następnie umieszczamy w kodzie strony głównej (lub innej)
wyszukiwarkę.
2.1. Osadzenie wyszukiwarki - kroki 1 - 3
Decydujemy gdzie i czy chcemy umieścić poszczególne części wyszukiwarki (część główną,
ftry, wyszukiwarka pomocniczą). Należy pamiętać, aby wszystkie instrukcje znalazły się w
znacznikach języka PHP ( <?php … ?> )
1. Na samym początku pliku podłączamy bibliotekę którą wgraliśmy wcześniej na
serwer: require_once('hydra_gate.class.php');
UWAGA: Powyżej należy podać właściwą ścieżkę do pliku, np.
<?php require_once('hydra_gate.class.php'); ?>
W tym pliku NIE należy podawać parametrów dotyczących kodowania przy
wywołaniu biblioteki hydra_gate. Zwracana zawartość powinna być w kodowaniu
UTF-8 (domyślne). Nie należy także dodawać żadnej innej zawartości do tego pliku.
2. W nagłówku dodajemy:
$hydra_gate = new ef_gate('1496', 'hotele-desk');
Gdzie parametry w nawiasie to odpowiedno:
1. Nr agencji (w przykładzie to „1496“)
2. Nazwa afliatu (w przykładzie „hotele-desk“)
3. Pobieramy fragmenty wyszukiwarki, które następnie przy pomocy funkcji
getPart() będą wyświetlane na stronie.:
$hydra_parts = array('header', 'main', 'step');
$hydra_gate->fetchParts($hydra_parts);
4. W sekcji HEAD dołączamy potrzebne pliki css i javascript:
echo $hydra_gate->getPart('header', false);1
5. W wybranych miejscach (gdzie chcemy) wyświetlamy część główną wyszukiwarki
echo $hydra_gate->getPart('main');
1 Drugi parametr „false“ oznacza brak opakowania części wyszukiwarki w dodatkowy blok (<div>), który akurat
w nagłówku strony jest niepożądany.
22 / 26
2.2. Osadzenie – krok 4 i 5
UWAGA: dla kroku czwartego, gdzie znajduje się formularz rezerwacji wymagane jest użycie
serwera HTTPS (szyfrowana wersja protokołu HTTP) ze względu bezpieczeństwa (ochrony
danych osobowych min. Danych karty kredytowej podawanych przy płatności).
Krok 5 zawierający informację o potwierdzeniu rezerwacji także powinien być szyfrowany.
Jeśli nie dysponujemy serwerem HTTPS użytkownik zostanie przekierowany na serwer
MerlinX (opcja domyślna). Jeśli dysponujemy serwerem z prot. szyfrowanym tworzymy
dodatkowy plik i osadzamy w nim wyszukiwarkę, w sposób analogiczny jak w pkt 2.1.
Bardzo ważne jest podanie adresu url do tej strony z formularzem w panelu konfguracyjnym:
 Profl Agencji
 Prof IBE
 Adres podstrony z rezerwacją (dla GATE)
2.3. Rozpoznanie etapu wyszukiwania
Dodatkowo dostępnym elementem jest aktualny nr kroku. Pozwala on dzięki instrukcji
warunkowej zmieniać zawartość naszej strony w zależności od etapu wyszukiwania, np.
Pokazanie lub ukrycie boksów promocyjnych na 1. kroku wyszukiwania, gdzie mamy więcej
miejsca na dodatkową treść.
<?php
if ($hydra_gate->getPart('step', false2) == 1) {
//instrukcje do wykonania w kroku 1, np. box ofertowy:
echo $hydra_gate->getPart('mxBox_1');
}
?>
2 W przypadku sprawdzania kroku wyszukiwania także nie potrzebujemy dodatkowego opakowania (bloku
<div>) elementu.
23 / 26
3. Boksy ofertowe
Boksa możemy zaimplementować na dwa sposoby, w zależności od tego, czy na stronie jest
zainstalowana wyszukiwarka hoteli.
3.1. Implementacja boksów na stronie z wyszukiwarką Hoteli
Dodanie boksów ofertowych do strony, na której zaimplementowana jest już wyszukiwarka
jest bardzo proste.
1. Podczas wykonywania instrukcji podłączenia z pkt. 2.1 tego rozdziału, w kroku 3
(wyszczególnienie elementów wyszukiwarki, które chcemy pobrać z serwera)
podajemy także ID boksów, które będziemy chcieli umieścić na stronie:
$hydra_parts = array('header', 'main', 'step',
'mxBox_XX');
Gdzie:
 „mxBox_“ to przedrostek oznaczający boks ofertowy,
 „XX“ to ID z panelu IBE.
2. Po wykonaniu kolejnej instrukcji:
$hydra_gate->fetchParts($hydra_parts);
Możemy już wykorzystać boksa w dowolnym miejscu na stronie.
3. W analogiczny sposób jak inne części webgate, umieszczamy go w kodzie PHP lub
HTML z dodanymi znacznikami PHP:
<body>
...
<?php echo $hydra_gate->getPart('mxBox_1'); ?>
...
</body>
24 / 26
3.2. Implementacja boksów na stronie bez wyszukiwarki Hoteli (PHP)
Jeśli nie posiadamy wyszukiwarki na stronie, potrzebujemy bezpośrednio odpytać o boxy, np.
tak:
<?php
$searchEngineURL =
'http://hydra.merlinx.eu/agent/1496/twojewycieczki-hotel/htl';
$boxes = array('mxBox_1', 'mxBox_2);
$params = array(
'parts' => implode(',', $boxes),
'gate' => 'hd3' );
$c = curl_init($searchEngineURL . http_build_query($params));
curl_setopt($c, CURLOPT_ENCODING, 'gzip');
curl_setopt($c, CURLOPT_RETURNTRANSFER, true);
$res= curl_exec($c);
curl_close($c);
if (!empty($res)) {
$result = json_decode($res, true);
}
?>
<?php
echo '<div id="mxBox_1" class="mxContent">'.$result['mxBox_1']
['content'].'</div>';
?>
Gdzie poszczególne parametry to:
1. $searchEngineURL – adres wyszukiwarki z panelu IBE
2. $boxes – id boksów ofertowych z panelu IBE
25 / 26
3.2. Implementacja boksów na stronie bez wyszukiwarki Hoteli (JavaScript)
Boksy ofertowe mogą być wyświetlone bez użycia języka PHP, dzięki wykorzystaniu
odpowiedniego skryptu JavaScript. Aby to zrobić, musimy wcześniej przygotować
miejsce dla boksów, np. tworząc w HTML bloki (div) lub komórki tabeli z określonymi
parametrami id:
<tr>
<td class="htlBox" id="htlBox1"></td>
<td class="htlBox" id="htlBox2"></td>
<td class="htlBox" id="htlBox3"></td>
</tr>
Mając przygotowane miejsce, możemy pobrać skryptem zawartość boksów z serwera. Skrypt
powinien być umieszczony przed zamknięciem tagu </body> w kodzie HTML.
<script type="text/javascript">
/* id's of prepared HTML box containers */
var
elemId = 'htlBox1,htlBox2,htlBox3',
/* agency nr */
agnNr = 1496,
/* afliate name */
afname = 'twojewycieczki-hotel',
/* id's of boxes from IBE panel */
id = 'mxBox_19,mxBox_20,mxBox_22';
functon reloadBox() {
document.write('<script src="htp://hydrabox.merlinx.pl:10080/' + agnNr + '/' +
afname + '/?jsoncallback=getBoxes&parts=' + id.replace(',', '%2C') + '&xfughy=' +
Math.random() + '"></scr' + 'ipt>');
}
functon getBoxes(parsed) {
var ids = id.split(','),
divs = elemId.split(',');
for (var x = 0; x < ids.length; x++) {
document.getElementById(divs[x]).innerHTML=parsed[ids[x]].content;
}
}
reloadBox();
</script>
Należy zwrócić uwagę na parametry, które muszą zostać ustawione:
1. elemId – ID elementów HTML, w których umieszczone będą boksy,
2. agnNr – nr agencji,
3. afname – nazwa afliatu
4. id – ID boksów z prefxami3. Ważne aby ilość boksów była równa ilości elemId
3 Prefksy boksów ofertowych to „mxBox_“
26 / 26