Модуль поиска туров 5.0
Модуль поиска туров 5.0 состоит из 3 блоков:
- Формы поиска, в которой турист задаёт параметры тура;
- Ленты выдачи, в которой списком выведены результаты поиска;
- Карточки тура, содержащей подробное описание тура, ваши контактные данные и форму обратной связи.
Чтобы настроить работу и оформление блоков, воспользуйтесь Генератором модуля в Личном кабинете или отредактируйте код вызова модуля вручную. Некоторые малоупотребительные настройки не выведены в Генератор. Их можно изменить только посредством редактирования кода.
Если вы не нашли ответа на свой вопрос в этой статье, вам помогут в службе технической поддержки Слетать.ру по телефону 8(800)700-33-09 (звонок бесплатный для всех регионов России).
Содержание
Форма поиска
Модуль поиска 5.0 ищет туры по следующим параметрам:
- город вылета;
- направление, курорт и отель;
- даты вылета;
- продолжительность тура;
- количество туристов (взрослых и детей);
- возраст детей;
- тип питания;
- категория отеля;
- диапазон цен;
- валюта выдачи;
- пляжная линия;
- наличие авиабилетов;
- включены ли авиабилеты в стоимость.
Чтобы туристу было проще ориентироваться, параметры разделены между основной формой, которая размещается на сайте, и сокращённой формой и пост-фильтром, которые появляются во всплывающем окне вместе с Лентой выдачи, когда турист нажимает кнопку «Найти».
В таблице ниже описаны все элементы основной формы, сокращённой формы и пост-фильтра.
Легенда:
- Контроллер — элемент формы (кнопка, поле, выпадающий список и т. д.);
- Функция — действие, за которое отвечает контроллер;
- Доступные настройки — то, как вы можете настроить контроллер, используя Генератор модуля или непосредственно редактируя код вызова модуля;
- Значения — диапазон допустимых значений контроллера;
- Параметр кода — ссылка на параметр кода вызова модуля, который нужно редактировать, чтобы настроить контроллер;
- Дополнительно — прочая информация (нюансы настройки, возможности применения и т. д.).
Контроллер | Функция | Доступные настройки | Значения | Параметр кода | Дополнительно |
---|---|---|---|---|---|
Основная и сокращённая форма поиска | |||||
«Поиск туров из...» | Выбор города вылета. | Город вылета по умолчанию. | Любой доступный город вылета. | city | |
«Направление» | Выбор страны, курорта и отеля. | Страна, курорт и отель по умолчанию. | Любые доступные страна, курорт и отель. | country, resorts, hotels | Турист выбирает последовательно: сначала страну, потом курорт, потом отели. В отдельный столбец слева выведен список популярных стран. |
«Период вылета» | Выбор интервала дат вылета. | Значения по умолчанию: а) точный интервал дат; б) точная дата (+/3 дня - опционально); в) день поиска + n дней. | Интервал дат. | date1, date2, date, threeDays, dateOffset, dateRange | Выбор точных дат полезен, если вы ставите модуль на страницу «Новогодние туры». Когда выбранная дата пройдёт Модуль автоматически начнёт искать туры на скользящий недельный диапазон, начинающийся датой поиска. |
«Ночей» | Выбор продолжительности тура. | Значения по умолчанию. | Числа от 1 до 29. | nightsMin, nightsMax | Во всплывающем календаре турист выбирает начальную и конечную дату интервала. |
«Найти» | Поиск туров. | Автоматический старт поиска, задержка при старте поиска. | Нет. | sta, pause | |
Основная форма поиска и пост-фильтр | |||||
«Туристы» | Выбор количества туристов — взрослых и детей. | Значения по умолчанию. | Взрослые — числа от 1 до 4; дети — числа от 1 до 3; возраст детей — числа от 0 до 15. | adults, kids, kid1, kid2, kid3 | Кликнув по иконке ребёнка, турист сразу выбирает его возраст. |
«Питание» | Выбор типа питания. | Питание по умолчанию. | RO, BB, HB, HB+, FB, FB+, AI, UAI, любое. | meals | |
«Категория отеля» | Выбор категории отеля. | Категория по умолчанию. | 2*-5*, Apts, Villas, HV-1,HV-2, любая. | minHotelCategory | |
Пост-фильтр | |||||
«Цена» | Установка диапазона цен. | Значения по умолчанию. | Любое число. | priceMin, priceMax | |
«Валюта» | Выбор валюты, в которой будут отображаться цены. | Валюты для отображения, валюта по умолчанию. | Рубль (RUB), доллар (USD), евро (EUR). | disabledCurrencies, currency | |
«Пляжная линия» | Выбор пляжной линии. | Пляжная линия по умолчанию. | 1—3 линии, любая. | beachLines | |
«Есть билеты» | Исключение из поиска туров с проданными авиабилетами. | Значение по умолчанию. | Искать только туры с билетами (галочка стоит). / Искать все туры (галочка не стоит). | useAccountSettings, ticketsExists | Значения по умолчанию задаются в разделе «Настройки» Личного кабинета отдельно для пары «Город вылета — направление». |
«Перелёт включён» | Исключение из поиска туров без перелёта. | Значение по умолчанию. | Искать только туры с перелётом (галочка стоит). / Искать все туры (галочка не стоит). | useAccountSettings, ticketsIncluded | Значения по умолчанию задаются в разделе «Настройки» Личного кабинета отдельно для пары «Город вылета — направление». |
«Применить» | Запуск уточнённого поиска. | Задержка при старте поиска. | Нет. | pause | |
«Сбросить» | Возврат к значениям по умолчанию. | Нет. | Нет. | Нет. |
Лента выдачи
Лента выдачи — это список найденных туров. В ней представлена следующая информация:
- название и категория отеля;
- страна и курорт;
- пляжная линия;
- тип питания;
- тип номера;
- дата вылета и продолжительность тура;
- стоимость тура.
Формат выдачи
Модуль поиска 5.0 поддерживает два формата выдачи:
- Группировка по отелям. В основной выдаче представлено по одному самому дешёвому туру в каждый отель. Остальные туры в этот отель выводятся в выпадающем списке. Группировка по отелям позволяет выбрать недорогой тур и не тратить время на просмотр всей выдачи.
- Без группировки. Каждый тур выводится отдельно, вне зависимости от того, встречался ли отель в выдаче выше.
Турист может свободно переключаться между форматами. Выберите формат по умолчанию в дополнительных настройках Генератора или задайте нужное значение параметра results.
Вне зависимости от формата в каждой строке выдачи есть описание отеля (список услуг, расположение на карте и отзывы туристов).
Внимание! Блок отзывов об отелях требует отдельной лицензии. Закажите лицензию у вашего персонального менеджера. |
Прочие параметры
Прочие параметры выдачи сведены в таблицу.
Параметр | Описание | Доступные настройки | Параметр кода |
---|---|---|---|
Валюта | Модуль поддерживает три валюты: рубли (RUB), доллары (USD) и евро (EUR). Турист выбирает удобную валюту в форме поиска. | Задать валюту по умолчанию, ограничить выбор валюты. | currency, disabledCurrencies |
Задержка при старте поиска | Время, по истечении которого модуль покажет первые результаты поиска (в миллисекундах). По умолчанию равно 3000 мс (3 с). | Настроить задержку | pause |
Вывод ленты выдачи | Лента выдачи выводится во всплывающем окне на текущей или на отдельной странице (на этой странице должен быть размещён код вызова модуля). | Адрес страницы для перехода, открывать целевую страницу в новой вкладке, | useJumpTo, jumpToAddress, jumpToTarget |
Автоматический запуск поиска | Модуль может запускать поиск автоматически, как только турист заходит на страницу. | Включить автоматический поиск | sta |
Внимание! Маска скидки не уменьшает цену тура, а только выводит её как скидочную. Настоящую скидку вы можете настроить в Личном кабинете. |
Карточка тура
Карточка тура содержит структурированное описание тура описание отеля и форму обратной связи.
Блок | Описание | Доступные настройки | Параметры кода | Дополнительно |
---|---|---|---|---|
Заголовок | Название тура и его короткий номер. | Нет | Нет | Используйте короткий номер, чтобы быстро найти тур в системе Слетать.ру. |
Описание тура | Направление и город вылета, продолжительность (в ночах), тип номера и тип питания. | Нет | Нет | |
Блок актуализации | Когда открывается Карточка тура, Модуль запрашивает у оператора размеры доплат, наличие билетов и мест в отеле, номер рейса, время и аэропорт вылета. | Отключить детальную актуализацию. | useDetailedActualization | Если мест в отеле или билетов не осталось, Модуль отмечает тур как проданный. |
Цена | Цена тура с минимальными обязательными доплатами, спецификация доплат (выводится по клику), кнопки «Купить в офисе» и/или «Купить онлайн». | Отключить кнопки «Купить в офисе» или «Купить онлайн». | useCard, useOrder | |
Фотографии | Фотографии отеля | Нет | Нет | На фотографиях размещается водяной знак вашего сайта. |
Карта | Карта Google с отмеченным расположением отеля. | Указать лицензионный ключ Карт Google. | googleMapKey | Сайты с большим потоком посетителей должны приобрести лицензию на использование Карт Google. |
Информационный блок — Описание | Сайт, телефон, e-mail отеля, количество мест, расстояние до аэропорта, текстовое описание и прогноз погоды на курорте. | Нет | Нет | |
Информационный блок — Услуги | Краткий список услуг с иконками | Нет | Нет | |
Информационный блок — Карта | Карта Google с отмеченным расположением отеля. | Указать лицензионный ключ Карт Google. | googleMapKey | Сайты с большим потоком посетителей должны приобрести лицензию на использование Карт Google. |
Информационный блок — Отзывы | Отзывы туристов, посетивших отель, с оценкой по десятибалльной шкале.
В дополнения к отзывам имеется возможность подключить отзывы TripAdvisor. |
Нет | Нет | Блок отзывов требует отдельной лицензии, которую надо привязать к вашему сайту. За подключением обратитесь к вашему персональному менеджеру. |
Блок контактов | Блок рядом с заявкой на тур. Содержат ваш логотип, контактные данные (телефон и e-mail) и дополнительную информацию на ваше усмотрение. | Добавить контактные данные | agencyContact1, agencyContact2 | |
Форма заявки | С помощью формы турист отправляет вам свои ФИО, телефон, e-mail и комментарий длиной до 500 символов. | Отключить форму, настроить форму по умолчанию, включить режим многоофисности, указать адрес офиса, выбрать офис по умолчанию, настроить высоту блока офисов | useOrder, buyingType, useManyOffices, manyOfficesHeight, manyOfficesNonHeight, useSpecificOffice, officeId | Режим многоофисности требует отдельной лицензии. За подключением обратитесь к вашему персональному менеджеру. |
Форма онлайн-оплаты | С помощью этой формы турист может сразу оплатить тур по банковской карте. | Отключить форму, настроить форму по умолчанию | useOrder, buyingType | Требует подключения системы биллинга Слетать.ру. |
В окне списка сравнения также имеется кнопка "Поделиться в сети". Туры для сравнения хранятся в списке в течении суток после добавления.
Обработка заявок
Форма заявки
Форма заявок защищена от ввода неправильных данных. В поле «Email» можно ввести только латинские буквы, цифры, знак нижнего подчёркивание; обязательно — точку и знак @. В поле «Телефон» — только сочетание цифр длиной до 10 символов.
Заявки поступают в раздел «Статистика» вашего Личного кабинета.
Вам придёт уведомление о новом заказе по SMS и на email. В нём будут указаны контактные данные туриста и описание тура (в том числе информация об операторе). Вы можете указать несколько адресов и телефонов и настроить список стран, по которым будут приходить уведомления.
Турист также получит уведомление от вашего имени.
Указать email-адреса и телефоны для уведомлений и ввести данные для отправки уведомлений туристам вы можете в разделе «Настройка уведомлений» в Личном кабинете.
Внимание! Если вы не заполните раздел «Настройка уведомлений», уведомления туристу отправляться не будут, а вам будут приходить только электронные письма на адрес, указанный при регистрации на sletat.ru. |
Если вы подключили режим многоофисности, турист сможет выбрать офис, в который придёт заявка. Ввести данные об офисах вы можете в разделе «Офисы» в Личном кабинете.
Форма онлайн-оплаты
Заявки из формы онлайн-оплаты попадают в раздел «Список заказов».
Внимание! Форма онлайн-оплаты требует подключения Системы биллинга Слетать.ру. |
Внешний вид
Параметры кода
В таблице ниже представлены все параметры, используемые в коде вызова Модуля поиска туров. Обязательные параметры отмечены знаком *.
Типы параметров:
- int — целое число.
- str — строка (текст, ссылка, любые нечисловые символы). Помещается в кавычки ("").
- bool — логический оператор. Имеет два значения: true и false.
- obj — объект. Набор параметров, которые вместе описывают одно сложное целое.
- arr[] — массив. Набор числовых или строковых значений. Помещается в квадратные скобки ([]). Строковые значения помещаются в кавычки ("").
Параметр | Тип | Описание |
---|---|---|
adults
|
int | Количество туристов (взрослых). Возможные значения: целое число от 1 до 4. Если параметр не передан, используется значение 2. |
agencyContact1
|
obj | Контактные данные для дополнительного блока. |
agencyContact2
|
obj | Контактные данные для основного блока. |
agencyContactX.header
|
str | Заголовок блока контактов. |
agencyContactX.phone
|
str | Контактный телефон. |
agencyContactX.email
|
str | Контактный e-mail. |
agencyContactX.logo
|
str | Ссылка на логотип. |
agencyContactX.content
|
str | Дополнительная информация для блока контактов. |
buyingType
|
str | Если передано значение card, в карточке тура по умолчанию используется форма онлайн-оплаты. В противном случае используется форма заказа. |
beachLines
|
arr[] | Пляжные линии по умолчанию. Возможные значения: 1 — 1-я линия, 2 — 2-я линия, 3 — 3-я линия; пустой массив [] — любая линия. |
city
|
int | Идентификатор города вылета. Если параметр не передан, используется город по умолчанию — Москва. |
country
|
int | Идентификатор направления. |
currency
|
str | Валюта, используемая при выдаче результатов поиска. |
customStyles
|
str | Пользовательский CSS-код. |
date
|
str | Точная дата вылета. |
dateOffset
|
int | Модификатор, прибавляемый к дате поиска для определения начальной даты диапазона дат вылета. Возможные значения: целое число от 0 до 90. |
dateRange
|
int | Модификатор, прибавляемый к дате поиска для определения конечной даты диапазона дат вылета. Возможные значения: целое число от 0 до 90, но не меньше значения dateOffset. |
date1
|
str | Начальная дата диапазона дат вылета. Если параметр не передан, используется дата поиска. |
date2
|
str | Начальная дата диапазона дат вылета. Если параметр не передан, используется значение «дата поиска + 7 дней». |
disabledCurrencies
|
arr[] | Идентификаторы валют, запрещённых для выбора в форме поиска. Возможные значения: RUB, USD, EUR (не более двух одновременно). |
files
|
arr[] | Ссылка на css-файл темы оформления Модуля. Используйте одну из стандартных тем или дайте ссылку на собственный css-файл. Если параметр не передан, используется тема «Default». |
googleMapKey
|
str | Лицензионный ключ Google-карт. |
hasTickets
|
bool | Выводить в результат поиска только туры с параметром «Есть билеты». Возможные значения: true - только с билетами, false - и те, и другие. Если параметр не передан, используется false. |
isExtendedFromOpened
|
bool | Раскрывает форму поиска по умолчанию. Возможные значения: true — форма развернута, false — форма свернута. Если параметр не передан, используется false. |
hotels
|
int | Идентификаторы отелей. |
kids
|
int | Количество туристов (детей). Возможные значения: целое число от 0 до 3. Если параметр не передан, используется значение 0. |
kid1
|
int | Возраст первого ребёнка. Возможные значения: целое число от 0 до 15. Если параметр не передан, используется значение 0. |
kid2
|
int | Возраст второго ребёнка. Возможные значения: целое число от 0 до 15. Если параметр не передан, используется значение 0. |
kid3
|
int | Возраст третьего ребёнка. Возможные значения: целое число от 0 до 15. Если параметр не передан, используется значение 0. |
manyOfficesHeight
|
int | Высота блока офисов в пикселях. |
manyOfficesNonHeight
|
bool | Ограничение высоты блока офисов. Возможные значения: true — ограничение включено; false — ограничение выключено. Если параметр не передан, используется значение false. |
meals
|
arr[] | Идентификаторы типов питания. |
minHotelCategory
|
int | Минимальная категория отеля по умолчанию. Возможные значения: 2 — от 2*; 3 — от 3*; 4 — от 4*; 5 — от 5*. Если параметр не передан, используется значение 1 — от 1*. |
nightsMax
|
int | Максимальная продолжительность тура (ночей). Возможные значения: целое число от 1 до 29, но не меньше значения nightsMin (при нарушении этого условия введённые значения меняются местами на этапе передачи запроса в Систему поиска). Если параметр не передан, используется значение 11. |
nightsMin
|
int | Минимальная продолжительность тура (ночей). Возможные значения: целое число от 1 до 29, но не больше значения nightsMax (при нарушении этого условия введённые значения меняются местами на этапе передачи запроса в Систему поиска). Если параметр не передан, используется значение 3. |
officeId
|
int | Идентификатор офиса для поля useSpecificOffice. |
popupZIndex
|
str | Z-индекс для попапа карточки тура. Если параметр не передан, используется значение 100000000. |
priceMax
|
int | Максимальная цена тура. Возможные значения: не меньше значения priceMin (при нарушении этого условия введённые значения меняются местами на этапе передачи запроса в Систему поиска). |
priceMin
|
int | Минимальная цена тура. Возможные значения: не больше значения priceMax (при нарушении этого условия введённые значения меняются местами на этапе передачи запроса в Систему поиска). |
resorts
|
arr[] | Идентификаторы курортов. |
resultFullCountRows
|
int | Количество результатов на странице в полном формате выдачи. Если параметр не передан, используется значение 10. |
resultGroupCountRows
|
int | Количество результатов на странице в выдаче с группировкой по отелям. Если параметр не передан, используется значение 10. |
sta
|
bool | Автоматический запуск поиска. Возможные значения: true – запуск включён; false – запуск выключен. Если параметр не передан, используется значение false. |
threeDay
|
bool | Модификатор даты вылета (+/-3 дня). Возможные значения: true – модификатор применяется; false – модификатор не применяется. Если параметр не передан, используется значение true. Требует передачи параметра date. |
ticketsExists
|
int | Значение по умолчанию опции «Есть билеты». Если передано значение 1, по умолчанию опция будет отмечена галочкой. Если параметр не передан, используется значение 0. |
ticketsIncluded
|
bool | Значение по умолчанию опции «Перелёт включён». Если передано значение false, по умолчанию галочка напротив опции будет снята. Если параметр не передан, используется значение true. |
tourAgentCountry
|
str | Телефонный код страны в карточке тура. Возможные значения: belarus – Беларусь; ukraine – Украина. Если параметр не передан, используется страна по умолчанию - Россия. |
useAccountSettings
|
bool | Использовать настройки модуля из личного кабинета sletat.ru. Возможные значения: true - использовать, false - не использовать |
useCard*
|
bool | Форма онлайн-оплаты и кнопка «Купить онлайн». Возможные значения: true – включить форму; false – отключить форму. По умолчанию передаётся false. |
useDetailActualization
|
bool | Детальная актуализация. Возможные значения: true – использовать, false – не использовать. Если параметр не передан, используется значение true. |
useHasTicketsControl
|
bool | Отображать галочку «Есть билеты». Возможные значения: true - показывать, false - не показывать. Если параметр не передан, используется значение true. |
useManyOffices
|
bool | Режим многоофисности. Возможные значения: true – режим включён; false – режим выключен. Если параметр не передан, используется значение false. |
useOrder
|
bool | Форма заказа и кнопка «Купить в офисе». Возможные значения: true – включить форму; false – отключить форму. Если параметр не передан, используется значение true. |
useRequest
|
bool | Приём параметров поискового запроса из адресной строки браузера. Возможные значения: true – приём включён; false – приём выключен. Если параметр не передан, используется значение true. |
useSpecificOffice
|
bool | Офис по умолчанию. Возможные значения: true – офис с идентификатором officeId используется как офис по умолчанию; false – не используется. Если параметр не передан, используется значение false. |
useTitle
|
bool | Замена заголовка страницы с карточкой тура на название отеля. Возможные значения: true – заменять заголовок; false – не заменять заголовок. Если параметр не передан, используется значение true. |
useticketsIncludedControl
|
bool | Отображать галочку «Перелет включен». Возможные значения: true – показывать; false – не показывать. Если параметр не передан, используется значение true. |