Модуль поиска туров 5.0

Материал из wiki.Sletat.ru
Перейти к: навигация, поиск

Модуль поиска туров 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.
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.

Возможные ошибки

Исправление ошибки "Ваш браузер не настроен для передачи HTTP REFERER." Проблема может заключаться в конфигурационном файле сервера, в частности, в файле apache.conf. Чтобы это исправить необходимо изменить значение заголовка Referrer-Policy на strict-origin-when-cross-origin
Apache conf.png