Изменения

Перейти к навигации Перейти к поиску

FastSearch — передача параметров в форму поиска

1063 байта добавлено, 13:01, 20 августа 2018
Отмена правки 15015, сделанной Андрей Кизимов (обсуждение)
[[Категория:Плагины (Авиабилеты)]]
[[Категория:API (Авиабилеты)Интеграция]][[Категория:Модули]] [[Категория:Встроенные модули]]
<!-- -->
FastSearch в {{NameSystem|link}} — функция[http://www.nemo.travel системы онлайн-бронирования {{NameSystem}}], позволяющая перенаправлять пользователей на страницу с уже заполненными параметрами поиска или напрямую на результаты актуального поиска.
==Назначение==
== Примеры использования ==
Формирование ссылок для баннеровили спецпредложений для клиентов, при щелчке по клику на которые [[пользователь]] попадает на [[Форма поиска (Авиабилеты)|форму поиска]] с уже заполненными полями: пункт вылета и назначения, дата, количество и типы пассажиров и прочие параметры. Так же Также по ссылке можно сразу запускать процесс [[Поиск (Авиабилеты)|поиска]]по заданным заранее параметрам.
== Принцип работы ==
Для использования Fast Search включите одноименную опцию в разделе настроек '''Управление сайтом → Домены и протоколы → Включить Fast Search (передачу параметров поиска)'''.<!--{{Menu|Управление сайтом|Домены и протоколы|Включить Fast Search (передачу параметров поиска)}}.-->
Запрос Fast Search состоит из ''параметров'' и их ''значений'', которые в определенном порядке задаются в ссылке.
==Fast Search для Frontend 1.0==
 
{{Attention| Приведенные ниже инструкции актуальны только для старых тем оформления! Для тем оформления, унаследованных от темы wurst, см. подраздел '''Fast Search для Frontend 2.0''' данной статьи!}}<br>
При использовании Frontend 1.0 ссылка имеет следующий вид:
<pre>http://SITEMANESITENAME/?trip_type=OW&out_iata=MOW&in_iata=BER&departure_date=21.10.2009&adults=1&children=0&input_vendors=SU,PS&param_by_get=on</pre>
Имена переменных аналогичны именам полей на поисковой форме.
*Значения переменных должны удовлетворять ограничениям параметров настройкииз соответствующих настроек формы поиска. Например, если согласно настройкам поиск можно совершать не далее чем на 270 дней вперед, то для FastSearch это ограничение тоже будет действовать.
*Рекомендуется не включать в запрос переменные, которые предполагают в качестве значения ''true'' <!-- чтобы их логика не отработала.-->
*Чтобы перенаправить пользователя '''''на страницу форму с заполненными параметрами поиска''''', в конце запроса укажите добавьте get-параметр '''&param_by_get=on''', иначе сработают стандартные предустановки полей формы поиска.*Чтобы отправить пользователя напрямую '''''на результаты поиска''''', укажите добавьте get-параметр '''&fast_search=on'''.
=== Примеры ===
* '''''Запрос заполняет форму поиска'''''
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
http://SITEMANESITENAME/?trip_type=OW&out_iata=MOW&in_iata=PAR&departure_date=25.10.2016&direct=true&adults=2&param_by_get=on
</syntaxhighlight>
* '''''Запрос запускает процесс поиска'''''
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">http://SITEMANESITENAME/?trip_type=OW&out_iata=MOW&in_iata=PAR&departure_date=25.10.2016&direct=true&adults=2&param_by_get=on&fast_search=on
</syntaxhighlight>
* '''''Запрос заполняет форму поиска'''''
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
http://SITEMANESITENAME/?trip_type=RT&out_iata=MOW&in_iata=PAR&departure_date=25.10.2016&back_departure_date=27.10.2016&class=econom&adults=2&infants=1&param_by_get=on
</syntaxhighlight>
* '''''Запрос запускает процесс поиска'''''
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">http://SITEMANESITENAME/?trip_type=RT&out_iata=MOW&in_iata=PAR&departure_date=25.10.2016&back_departure_date=27.10.2016&class=econom&adults=2&infants=1&param_by_get=on&fast_search=on
</syntaxhighlight>
* '''''Запрос заполняет форму поиска'''''
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
http://SITEMANESITENAME/?trip_type=CR&cr_iata[0]=MOW&cr_back_iata[0]=PAR&cr_date[0]=25.10.2016&cr_iata[1]=PAR&cr_back_iata[1]=LED&cr_date[1]=26.10.2016&cr_iata[2]=LED&cr_back_iata[2]=MOW&cr_date[2]=29.10.2016&adults=1&param_by_get=on
</syntaxhighlight>
* '''''Запрос запускает процесс поиска'''''
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">http://SITEMANESITENAME/?trip_type=CR&cr_iata[0]=MOW&cr_back_iata[0]=PAR&cr_date[0]=25.10.2016&cr_iata[1]=PAR&cr_back_iata[1]=LED&cr_date[1]=26.10.2016&cr_iata[2]=LED&cr_back_iata[2]=MOW&cr_date[2]=29.10.2016&adults=1&param_by_get=on&fast_search=on
</syntaxhighlight>
==Fast Search для Frontend 2.0==
 === Параметры запроса ===При использовании Frontend 2.0 ссылка имеет следующий виддля ссылки доступны следующие переменные:<pre>httpПараметры в таблице приведены в том порядке, в котором они должны следовать в запросе.{| class="wikitable" style="width://SITEMANE/search/IEVMOW20160218MOWIEV20160420ADT3INS1CLD2800px;"! colspan="3" style="text-directalign:left;"| Параметры указания пассажиров в запросе поиска|-vicinityDates-class! scope="col" width=Business-GO</pre>"300" | Элементили! scope="col" width="250" | Формат ввода<pre>http://SITEMANE/search/IEVMOWd10MOWIEVd20ADT3INS1CLD2-direct-vicinityDates-class! scope="col" width=Business"250" | Допустимые значения |-GO</pre>где:* | rowspan="2" | Пункт вылета || rowspan="2" |Трехбуквенный '''IEV, PEWIATA код''' — [[Международная ассоциация воздушного транспортааэропорта || MOW |- |LED |- |rowspan="2"|IATA]] коды пунктов вылета/Пункт прилета* || rowspan="2" |Трехбуквенный '''20160420IATA код''' — дата аэропорта || IEV |- |MOW |- | rowspan="2" | Дата вылета || Дата вылета в формате ГГГММДД '''ГГГГММДД''' || 20160818* |- |'''d10,d20dX''' — дата в формате dXX ,где XX это величина смещения ''X'' - смещение даты вылета относительно текущей даты.Неотрицательное число. || d7 |-* '''ADT | rowspan="3 INS 1 CLD 2''' — типы [[Пассажир"|Типы пассажиров]] и их количество* ||rowspan="3"|Трехбуквенный '''directкод типа''' пассажира (ADT,CLD,INF,INS,YTH,SRC) с количеством || ADT2 |- |ADT2INF2 |- |ADT3INS1CLD2SRC1 |- | Искать только прямые рейсы || Команда || -direct |-* '''icinityDates''' — включить [[Поиск | Искать по окружным датам || Команда || -vicinityDates |- |rowspan="3"| Класс|| rowspan="3"|Название класса перелета (АвиабилетыEconomy, Business, First)|поиск по окружным датам]]| -class=Economy |-* ''' | -class=Business''' — выбор [[Класс обслуживания |- | -class=First |класса]]-* | Валюта || Трехбуквенный '''GOкод''' — параметр для запуска валюты (USD, EUR, RUB) || -ccCurrency=USD |- | Запуск процесса поиска|| Команда. Если он параметр не указан, параметры будут подставлены в форму поиска, но поиск запущен не будет|| -GO |- | Отключение перенаправления || Команда. Позволяет отключить использование перенаправления на другой домен для ссылок в формате FastSearch при включенной настройке [[Раздел_настроек_«Nemo_1.0_(JSON_API)»|"Перенаправлять указанные страницы на другой домен"]]. Если параметр не указан, перенаправление будет осуществляться в соответствии с параметрами настройки "Перенаправлять указанные страницы на другой домен"|| ?noredirect=1 |} '''Примечание.''' Если необходимо передать параметры в форму без дат вылета-прилета, оставив поля дат пустыми, можно вместо конкретных дат подставить 8 нулей, например: /search/MOWMAD00000000ADT1-class=Economy. Тогда пользователь сам выберет дату, а остальные переданные параметры будут заполнены.
===Примеры===
Прямые маршруты эконом класса в одну сторону из Москвы в Париж с вылетом 18.02.2016 на трех взрослых, двух детей и одного младенца с местом с поиском по окружным датам.
* '''''Запрос заполняет форму поиска'''''
<pre>http://SITEMANESITENAME/search/MOWPAR20160218ADT3INS1CLD2-direct-vicinityDates-class=Economy</pre>
* '''''Запрос запускает процесс поиска'''''
<pre>http://SITEMANESITENAME/search/MOWPAR20160218ADT3INS1CLD2-direct-vicinityDates-class=Economy-GO</pre>
{| class="wikitable"
|[[Файл:FS2Маршрут в одну сторону.png]]
|-
| Форма поиска , автоматически заполненная с помощью запроса Fast Search
|}
|[[Файл:FS2Маршрут в одну сторону. Пассажиры.png]]
|-
| Форма пассажиров , автоматически заполненная с помощью запроса Fast Search
|}
|}
|-
|
Маршрут бизнес -класса из Москвы в Берлин с вылетом через 10 дней от текущей даты и обратно через 20 дней от текущей даты на двух взрослых.
* '''''Запрос заполняет форму поиска'''''
<pre>http://SITEMANESITENAME/search/MOWBERd10BERMOWd20ADT2-class=Business</pre>
* '''''Запрос запускает процесс поиска'''''
<pre>http://SITEMANESITENAME/search/MOWBER20160218d10BERMOW20160222d20ADT2-class=Business-GO</pre>
{| class="wikitable"
|[[Файл:FS2Маршрут туда-обратно.png]]
|-
| Форма поиска , автоматически заполненная с помощью запроса Fast Search
|}
|}
* '''''Запрос заполняет форму поиска'''''
<pre>http://SITEMANESITENAME/search/IEVPEW20150710PEWMOW20150718MOWPAR20150719ADT1</pre>
* '''''Запрос запускает процесс поиска'''''
<pre>http://SITEMANESITENAME/search/IEVPEW20150710PEWMOW20150718MOWPAR20150719ADT1-GO</pre>
{| class="wikitable"
|[[Файл:FS2сложный маршрут.png]]
|-
| Форма поиска , автоматически заполненная с помощью запроса Fast Search
|}
|}
 
=== Параметры запроса ===
Параметры в таблице приведены в том порядке, в котором они должны следовать с запросе.
{| class="wikitable mw-collapsible mw-collapsed" style="width: 800px;"
! colspan="3" style="text-align:left;"| Параметры указания пассажиров в запросе поиска
|-
! scope="col" width="300" | Элемент
! scope="col" width="250" | Формат ввода
! scope="col" width="250" | Допустимые значения
|-
| rowspan="2" | Пункт вылета || rowspan="2" |Трехбуквенный '''IATA код''' аэропорта || MOW
|-
|LED
|-
|rowspan="2"| Пункт прилета || rowspan="2" |Трехбуквенный '''IATA код''' аэропорта || IEV
|-
|MOW
|-
| rowspan="2" | Дата вылета || Дата вылета в формате '''ГГГГММДД''' || 20160818
|-
|'''dX''', где ''X'' - смещение даты вылета относительно текущей даты. Неотрицательное число. || d7
|-
| rowspan="3"|Типы пассажиров и их количество ||rowspan="3"|Трехбуквенный '''код типа''' пассажира (ADT,CLD,INF,INS,YTH,SRC) с количеством || ADT2
|-
|ADT2INF2
|-
|ADT3INS1CLD2SRC1
|-
| Искать только прямые рейсы || Команда || -direct
|-
| Искать по окружным датам || Команда || -vicinityDates
|-
|rowspan="3"| Класс|| rowspan="3"|Название класса перелета (Economy, Business, First) || -class=Economy
|-
| -class=Business
|-
| -class=First
|-
| Запуск процесса поиска || Команда. Если параметр не указан, параметры будут подставлены в форму поиска, но поиск запущен не будет || -GO
|}
== Взаимодействие Fast Search и модуля метрики ==
<!-- -->
Чтобы зафиксировать источник ссылки, по которой перешел пользователь, необходимо передать в конце запроса дополнительный параметр:
<syntaxhighlight lang="text" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">&?utm_source=source_alias</syntaxhighlight>
где '''source_alias''' — алиас источника перехода [[Модуль метрики |модуля метрики]].
* '''''Запрос заполняет форму поиска'''''
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
http://SITEMANESITENAME/?trip_type=OW&out_iata=MOW&in_iata=PAR&departure_date=25.10.2016&direct=true&adults=2&param_by_get=on&utm_source=source_alias
</syntaxhighlight>
* '''''Запрос запускает процесс поиска'''''
<syntaxhighlight lang="text" enclose="div" style="font-size:9pt;background: #F9F9F9; border: 1px dashed #2F6FAB; padding: 10px 5px; margin: 10px 0;">
http://SITEMANESITENAME/?trip_type=OW&out_iata=MOW&in_iata=PAR&departure_date=25.10.2016&direct=true&adults=2&param_by_get=on&fast_search=on&utm_source=source_alias
</syntaxhighlight>
|}
|-
|
Прямые маршруты эконом -класса в одну сторону из Москвы в Париж с вылетом 18.02.2016 на трех взрослых, двух детей и одного младенца с местом с поиском по окружным датам (с учетом источника перехода модуля метрики).
* '''''Запрос заполняет форму поиска'''''
<pre>http://SITEMANESITENAME/search/MOWPAR20160918ADT3INS1CLD2-vicinityDates-class=Economy?ccCurrency=USD&utm_source=source_alias</pre>
* '''''Запрос запускает процесс поиска'''''
<pre>http://SITEMANESITENAME/search/MOWPAR20160918ADT3INS1CLD2MOWPAR20171218ADT1-vicinityDates-class=Economy-GO?ccCurrency=USD&utm_source=source_alias</pre>
|}
== См. также ==
*[[Поиск (Авиабилеты)]]
*[[(термин) Маршрут "В одну сторону"]]*[[(термин) Маршрут "Туда и обратно"]]*[[(термин) Сложный маршрутТип маршрута]]
*[[Модуль метрики]]
*[[Форма поиска (Авиабилеты)]]

Навигация

'