Просмотр исходного текста страницы Описание модуля

[[Category:Модуль поиска туров 6.0]]

Все настройки модуля поиска 6.0 осуществляются через личный кабинет [https://sletat.ru sletat.ru]  в настройках каждого модуля.

После включения или отключения настроек в личном кабинете правки сразу сохраняются и применяются на действующем модуле поиска без задержек.

'''Настройка модуля поиска туров 6.0''' состоит из 2 блоков:
* [[Список доступных настроек визуального оформления|Настройки визуального оформления]], в котором можно настроить внешний вид модуля;
* [[Список доступных настроек поисковой выдачи|Настройки поисковой выдачи]], в котором можно настроить выдачу туров в модуле;

== Форма поиска ==

Модуль поиска 6.0 ищет туры по следующим параметрам:

* город вылета;
* направление, курорт и отель;
* даты вылета;
* продолжительность тура;
* количество туристов (взрослых и детей);
* возраст детей;
* тип питания;
* категория отеля;
* валюта выдачи;
* пляжная линия;
* наличие авиабилетов;
* включены ли авиабилеты в стоимость.

Чтобы туристу было проще ориентироваться, параметры разделены между основной формой, которая размещается на сайте, и сокращённой формой и пост-фильтром, которые появляются во всплывающем окне вместе с Лентой выдачи, когда турист нажимает кнопку «Найти».

<gallery>
Файл:short6.png|Сокращённая форма поиска.
Файл:post6.png|Пост-фильтр.
</gallery>

В таблице ниже описаны все элементы основной формы, сокращённой формы и пост-фильтра.

Легенда: 

* '''Контроллер''' &mdash; элемент формы (кнопка, поле, выпадающий список и т. д.);
* '''Функция''' &mdash; действие, за которое отвечает контроллер;
* '''Доступные настройки''' &mdash; то, как вы можете настроить контроллер, используя [[Список доступных настроек визуального оформления|Настройки визуального оформления]] или непосредственно редактируя код вызова модуля;
* '''Значения''' &mdash; диапазон допустимых значений контроллера;
* '''Параметр кода''' &mdash; ссылка на [[#Параметры кода|параметр кода вызова модуля]], который нужно редактировать, чтобы настроить контроллер;
* '''Дополнительно''' &mdash; прочая информация (нюансы настройки, возможности применения и т. д.).

{| class="wikitable"
!Контроллер
!Функция
!Доступные настройки
!Значения
!Параметр кода
!Дополнительно
|-
! colspan="6" |Основная и сокращённая форма поиска
|-
|«Откуда»
|Выбор города вылета.
|[[Список доступных настроек визуального оформления#Предзаполненная информация|Откуда по-умолчанию]].
|Любой доступный город вылета.
|[[#city|city]]
| 
|-
|«Куда»
|Выбор страны, курорта и отеля.
|[[Список доступных настроек визуального оформления#Предзаполненная информация|Куда по-умолчанию]].
|Любые доступные страна, курорт и отель.
|[[#country|country]]
|Турист выбирает страну. Сперва выведен список популярных стран.
|-
|«Даты вылета»
|Выбор интервала дат вылета.
|[[Список доступных настроек визуального оформления#Предзаполненная информация|Даты вылета по-умолчанию]]: а) точный интервал дат; б) точная дата (+/3 дня - опционально); в) день поиска + n дней. 
|Интервал дат.
|[[#date1|date1]], [[#date2|date2]], [[#date|date]], [[#threeDays|threeDays]], [[#dateOffset|dateOffset]], [[#dateRange|dateRange]]
|Выбор точных дат полезен, если вы ставите модуль на страницу «Новогодние туры». Когда выбранная дата пройдёт Модуль автоматически начнёт искать туры на скользящий недельный диапазон, начинающийся датой поиска. 
|-
|«Сколько ночей»
|Выбор продолжительности тура.
|[[Список доступных настроек визуального оформления#Предзаполненная информация|Количество ночей по-умолчанию]].
|Числа от 1 до 30.
|[[#nightsMin|nightsMin]], [[#nightsMax|nightsMax]]
|Во всплывающем окне турист выбирает начальную и конечную дату интервала.
|-
|«Сколько туристов»
|Выбор количества туристов &mdash; взрослых и детей.
|[[Список доступных настроек визуального оформления#Предзаполненная информация|Количество туристов по-умолчанию]].
|Взрослые &mdash; числа от 1 до 6; дети &mdash; числа от 1 до 5; возраст детей &mdash; числа от 0 до 17.
|[[#adults|adults]], [[#kids|kids]]
|Кликнув по иконке "Добавить ребенка", турист сразу выбирает его возраст. 
|-
|«Найти»
|Поиск туров.
|[[Список доступных настроек визуального оформления#Начинать поиск автоматически|Начинать поиск автоматически]].
|Нет.
|[[#sta|sta]]
|
|-
! colspan="6" |Основная форма поиска и пост-фильтр
|-
|«Транспорт»
|Выбор транспорта.
|[[Список доступных настроек визуального оформления#Добавить возможность выбора ж/д транспорта в поисковой выдаче|Добавить возможность выбора ж/д транспорта в поисковой выдаче]].
|Авиаперелёт, Чартерный авиарейс, Регулярный авиарейс, Ж/Д
|Нет
|Ж/Д можно отключить в шаблоне модуля
|-
|«Питание»
|Выбор типа питания.
|Нет
|RO, BB, HB, HB+, FB, FB+, AI, UAI, любое.
|[[#meals|meals]]
|
|-
|«Звёздность»
|Выбор категории отеля.
|Нет
|2*-5*,  Apts, Villas, HV-1,HV-2, любая.
|[[#minHotelCategory|minHotelCategory]]
|
|-
|«Рейтинг отеля»
|Выбор рейтинга отеля.
|Нет
|6+,7+,8+,9+
|[[#minHotelRaiting|minHotelRaiting]]
|
|-
|«Пляжная линия»
|Выбор пляжной линии.
|Нет
|1-ая,2-ая,3-ая
|[[#minHotelBeach|minHotelBeach]]
|
|-
|«Бронирование»
|Поиск туров с моментальным бронированием
|Нет
|Моментальное подтверждение
|Нет
|
|-
|«Операторы»
|Список туроператоров от которых турист получает туры
|[[Список доступных настроек поисковой выдачи#Список операторов|Подключение операторов]]
|[[Список доступных настроек поисковой выдачи#Список операторов|Список операторов]]
|Нет
|
|-
|«Отели»
|Список отелей доступных отелей для выбранного курорта
|Нет
|[[#hotels|hotels]]
|Нет
|
|-
|«Валюта»
|Валюта в которой будут выводится цены на тур
|Нет
|Моментальное подтверждение
|[[#currency|currency]]
|
|-
|}

=== Прочие параметры ===

Прочие параметры выдачи сведены в таблицу.

{| class="wikitable"
!Параметр
!Описание
!Доступные настройки
!Параметр кода
|-
|Вывод ленты выдачи
|Лента выдачи выводится во всплывающем окне или под формой поиска.
|Нет
|[[Список доступных настроек визуального оформления#Расположение результатов поиска|results]]
|-
|Автоматический запуск поиска
|Модуль может запускать поиск автоматически, как только турист заходит на страницу.
|Включить автоматический поиск
|sta
|}

{| class="standard sWarning"
|'''Внимание!''' Маска скидки не уменьшает цену тура, а только выводит её как скидочную. Настоящую скидку вы можете настроить в Личном кабинете.
|}

== Карточка тура ==

Карточка тура содержит структурированное описание тура описание отеля и [[#Обработка заявок|форму обратной связи]]. 

{| class="wikitable"
!Блок
!Описание
!Доступные настройки
!Параметры кода
!Дополнительно
|-
|Заголовок
|Название тура и его короткий номер.
|Нет
|Нет
|Используйте короткий номер, чтобы [[Быстрый поиск тура по короткому номеру|быстро найти тур в системе Слетать.ру]].
|-
|Описание тура 
|Направление и город вылета, продолжительность (в ночах), тип номера и тип питания.
|Нет
|Нет
|
|-
|Цена
|Цена тура с минимальными обязательными доплатами, спецификация доплат (выводится по клику), кнопки «Купить в офисе» и/или «Купить онлайн».
|[[Список доступных настроек визуального оформления#Форма онлайн-оплаты|Включение формы онлайн-оплаты]].
|[[#useCard|useCard]], [[#useOrder|useOrder]]
|
|-
|Фотографии
|Фотографии отеля
|Нет
|Нет
|На фотографиях размещается водяной знак вашего сайта.
|-
|Карта
|Карта Google с отмеченным расположением отеля.
|[[Дополнительные настройки модуля поиска туров 5.0|Указать лицензионный ключ Карт Google]].
|[[#googleMapKey|googleMapKey]]
|Сайты с большим потоком посетителей должны приобрести лицензию на использование Карт Google.
|-
|Информационный блок &mdash; Описание
|Сайт, телефон, e-mail отеля, количество мест, расстояние до аэропорта, текстовое описание и прогноз погоды на курорте.
|Нет
|Нет
|
|-
|Информационный блок &mdash; Услуги
|Краткий список услуг с иконками
|Нет
|Нет
|
|-
|Информационный блок &mdash; Карта
|Карта Google с отмеченным расположением отеля.
|Указать лицензионный ключ Карт Google.
|googleMapKey
|Сайты с большим потоком посетителей должны приобрести лицензию на использование Карт Google.
|-
|Информационный блок &mdash; Отзывы
|Отзывы туристов, посетивших отель, с оценкой по десятибалльной шкале.
В дополнения к отзывам имеется возможность подключить отзывы TripAdvisor. 
|Нет
|Нет
|Блок отзывов требует отдельной лицензии,  которую надо [[Лицензия#Привязка домена к Лицензии|привязать к вашему сайту]]. За подключением обратитесь к вашему персональному менеджеру.
|-
|Блок контактов
|Блок рядом с заявкой на тур. Содержат ваш логотип, контактные данные (телефон и e-mail) и дополнительную информацию на ваше усмотрение.
|Добавить контактные данные
|[[#agencyContact1|agencyContact1]], [[#agencyContact2|agencyContact2]]
|
|-
|Форма заявки
|С помощью формы турист отправляет вам свои ФИО, телефон, e-mail и комментарий длиной до 500 символов. 
|[[Список доступных настроек визуального оформления#Форма заказа|Использовать форму заказа]]
|[[#useOrder|useOrder]]
|Режим многоофисности требует отдельной лицензии. За подключением обратитесь к вашему персональному менеджеру.
|-
|Форма онлайн-оплаты
|С помощью этой формы турист может сразу оплатить тур по банковской карте.
|[[Список доступных настроек визуального оформления#Форма онлайн-оплаты|Использовать форму онлайн-оплаты]]
|[[#useOrder|useOrder]], [[#buyingType|buyingType]] 
|Требует подключения [[Начало работы|системы биллинга Слетать.ру]].
|}

<gallery>
Файл:tourinfo6.png|Карточка тура - Описание тура.
Файл:hotel6.png|Карточка тура - Описание отеля.
Файл:opera_lbhetXAweC.png|Карточка тура - Форма обратной связи.
Файл:tourdescrip6.png|Описание тура.
Файл:opera_PKfgEvq6sF.png|Ценовой блок.
Файл:touract6.png|Блок актуализации.
Файл:sold6.png|Блок актуализации (если нет мест или билетов).
Файл:hotelsphoto6.png|Фотографии отеля.
Файл:contacts6.png|Ваши контакты.
Файл:uslugi6.png|Список услуг отеля.
Файл:map6.png|Карта в информационном блоке.
Файл:otzivi6.png|Отзывы в информационном блоке.
</gallery>Над  карточкой тура имеются кнопки поделиться в соцсетях и добавить в сравнение.  При нажатии добавить "Сравнить", тур добавляется в список сравнения, открыв который, можно сравнить туры по основным параметрам. Список в закрытом виде показывается посетителям на протяжении всего времени нахождения на сайте.

В окне списка сравнения также имеется кнопка "Поделиться в сети". Туры для сравнения хранятся в списке в течении суток после добавления.  

<gallery>
Файл: share.png | Кнопка "Поделиться в сети" в карточке тура.
Файл: check.png | Кнопка "Поделиться в сети" в карточке тура.
Файл: tourschecker6.png | Список туров на сравнение в закрытом виде. 
Файл: Mp5_sravnenie.png | Форма сравнения туров.
Файл: Mp5_sravnenie_vk.png | Вид ссылки на сравнение туров на примере соцсети ВВконтакте.
Файл: Mp5_vk_pod.png | Вид ссылке на тур на примере соцсети ВВконтакте.

</gallery>

=== Обработка заявок ===

==== Форма заявки ====

Форма заявок защищена от ввода неправильных данных. В поле «Email» можно ввести только латинские буквы, цифры, знак нижнего подчёркивание; обязательно &mdash; точку и знак @. В поле «Телефон» &mdash; только сочетание цифр длиной до 10 символов.

Заявки поступают в раздел «Статистика» вашего Личного кабинета. 

Вам придёт уведомление о новом заказе по SMS и на email. В нём будут указаны контактные данные туриста и описание тура (в том числе информация об операторе). Вы можете указать несколько адресов и телефонов и настроить список стран, по которым будут приходить уведомления.

Турист также получит уведомление от вашего имени.

<gallery>
Файл:Claim.png|Уведомление о новой заявке.
Файл:Claim_tourist.png|Уведомление для туриста.
</gallery>

Указать email-адреса и телефоны для уведомлений и ввести данные для отправки уведомлений туристам вы можете в разделе [[Настройка уведомлений|«Настройка уведомлений»]] в Личном кабинете.

{| class="standard sWarning"
|'''Внимание!''' Если вы не заполните раздел [[Настройка уведомлений|«Настройка уведомлений»]], уведомления туристу отправляться не будут, а вам будут приходить только электронные письма на адрес, указанный  при регистрации на sletat.ru.
|}

Если вы подключили [[Дополнительные настройки модуля поиска туров 5.0|режим многоофисности]], турист сможет выбрать офис, в который придёт заявка. Ввести данные об офисах вы можете [[Добавление офисов|в разделе «Офисы»]] в Личном кабинете.

==== Форма онлайн-оплаты ====

Заявки из формы онлайн-оплаты попадают [[Список заказов|в раздел «Список заказов»]]. 

{| class="standard sWarning"
|'''Внимание!''' Форма онлайн-оплаты требует подключения [[Начало работы|Системы биллинга Слетать.ру]].
|}

== Параметры кода ==
В таблице ниже представлены все параметры, используемые в коде вызова Модуля поиска туров.
Обязательные параметры отмечены знаком *.

Типы параметров:

* '''int''' &mdash; целое число.
* '''str''' &mdash; строка (текст, ссылка, любые нечисловые символы). Помещается в кавычки ("").
* '''bool''' &mdash; логический оператор. Имеет два значения: true и false.
* '''obj''' &mdash; объект. Набор параметров,  которые вместе описывают одно сложное целое.
* '''arr[]''' &mdash; массив. Набор числовых или строковых значений. Помещается в квадратные скобки ([]). Строковые значения помещаются в кавычки ("").

{| class="wikitable"
! Параметр
! Тип
! Описание
|-  
| <div id="adults">adults</div>
| int
| Количество туристов (взрослых). Возможные значения: целое число от 1 до 6. Если параметр не передан, используется значение 2.
|-  
| <div id="agencyContact1">agencyContact1</div>
| obj
| Контактные данные для дополнительного блока.
|-  
| <div id="agencyContact2">agencyContact2</div>
| obj
| Контактные данные для основного блока.
|-  
| <div id="agencyContactX.header">agencyContactX.header</div>
| str
| Заголовок блока контактов.
|-  
| <div id="agencyContactX.phone">agencyContactX.phone</div>
| str
| Контактный телефон.
|-  
| <div id="agencyContactX.email">agencyContactX.email</div>
| str
| Контактный e-mail.
|-  
| <div id="agencyContactX.logo">agencyContactX.logo</div>
| str
| Ссылка на логотип.
|-  
| <div id="agencyContactX.content">agencyContactX.content</div>
| str
| Дополнительная информация для блока контактов.
|-  
| <div id="buyingType">buyingType</div>
| str
| Если передано значение card, в карточке тура по умолчанию используется форма онлайн-оплаты. В противном случае используется форма заказа.
|-  
| <div id="beachLines">beachLines</div>
| arr[]
| Пляжные линии по умолчанию. Возможные значения: 1 &mdash; 1-я линия, 2 &mdash; 2-я линия, 3 &mdash; 3-я линия; пустой массив [] &mdash; любая линия.
|-  
| <div id="city">city</div>
| int
| Идентификатор города вылета. Если параметр не передан, используется город по умолчанию &mdash; Москва.
|-  
| <div id="country">country</div>
| int
| Идентификатор направления.
|-  
| <div id="currency">currency</div>
| str
| Валюта, используемая при выдаче результатов поиска.
|-  
| <div id="customStyles">customStyles</div>
| str
| Пользовательский CSS-код.
|-  
| <div id="date">date</div>
| str
| Точная дата вылета.
|-  
| <div id="dateOffset">dateOffset</div>
| int
| Модификатор, прибавляемый к дате поиска для определения начальной даты диапазона дат вылета. Возможные значения: целое число от 0 до 90.
|-  
| <div id="dateRange">dateRange</div>
| int
| Модификатор, прибавляемый к дате поиска для определения конечной даты диапазона дат вылета. Возможные значения: целое число от 0 до 90, но не меньше значения dateOffset.
|-  
| <div id="date1">date1</div>
| str
| Начальная дата диапазона дат вылета. Если параметр не передан, используется дата поиска.
|-  
| <div id="date2">date2</div>
| str
| Начальная дата диапазона дат вылета. Если параметр не передан, используется значение «дата поиска + 7 дней».
|-  
| <div id="disabledCurrencies">disabledCurrencies</div>
| arr[]
| Идентификаторы валют, запрещённых для выбора в форме поиска. Возможные значения: RUB, USD, EUR (не более двух одновременно).
|-  
| <div id="files">files</div>
| arr[]
| Ссылка на css-файл темы оформления Модуля. Используйте [[Создание модуля поиска туров 5.0#Внешний вид|одну из стандартных тем]] или дайте ссылку на собственный css-файл. Если параметр не передан, используется тема «Default».
|-  
| <div id="googleMapKey">googleMapKey</div>
| str
| Лицензионный ключ Google-карт.
|-  
| <div id="hasTickets">hasTickets</div>
| bool
| Выводить в результат поиска '''только''' туры с параметром «Есть билеты». Возможные значения: true - только с билетами, false - и те, и другие. Если параметр не передан, используется false.
|-  
| <div id="hotels">isExtendedFromOpened</div>
| bool
| Раскрывает форму поиска по умолчанию. Возможные значения: true — форма развернута, false — форма свернута. Если параметр не передан, используется false.
|-  
| <div id="hotels">hotels</div>
| int
| Идентификаторы отелей.
|-  
| <div id="kids">kids</div>
| int
| Количество туристов (детей). Возможные значения: целое число от 0 до 3. Если параметр не передан, используется значение 0.
|- 
| <div id="manyOfficesHeight">manyOfficesHeight</div>
| int
| Высота блока офисов в пикселях.
|-  
| <div id="manyOfficesHeight">manyOfficesNonHeight</div>
| bool
| Ограничение высоты блока офисов. Возможные значения: true &mdash; ограничение включено; false &mdash; ограничение выключено. Если параметр не передан, используется значение false.
|-  
| <div id="meals">meals</div>
| arr[]
| Идентификаторы типов питания.
|-  
| <div id="minHotelCategory">minHotelCategory</div>
| int
| Минимальная категория отеля по умолчанию. Возможные значения: 2 &mdash; от 2*; 3 &mdash; от 3*; 4 &mdash; от 4*; 5 &mdash; от 5*. Если параметр не передан, используется значение 1 &mdash; от 1*.
|-
| <div id="nightsMax">nightsMax</div>
| int
| Максимальная продолжительность тура (ночей). Возможные значения: целое число от 1 до 29, но не меньше значения nightsMin (при нарушении этого условия введённые значения меняются местами на этапе передачи запроса в Систему поиска). Если параметр не передан, используется значение 11.
|-  
| <div id="nightsMin">nightsMin</div>
| int
| Минимальная продолжительность тура (ночей). Возможные значения: целое число от 1 до 29, но не больше значения nightsMax (при нарушении этого условия введённые значения меняются местами на этапе передачи запроса в Систему поиска). Если параметр не передан, используется значение 3.
|-  
| <div id="officeId">officeId</div>
| int
| Идентификатор офиса для поля useSpecificOffice.
|-  
| <div id="popupZIndex">popupZIndex</div>
| str
| Z-индекс для попапа карточки тура. Если параметр не передан, используется значение 100000000.
|-  
| <div id="priceMax">priceMax</div>
| int
| Максимальная цена тура. Возможные значения: не меньше значения priceMin (при нарушении этого условия введённые значения меняются местами на этапе передачи запроса в Систему поиска).
|-  
| <div id="priceMin">priceMin</div>
| int
| Минимальная цена тура. Возможные значения: не больше значения priceMax (при нарушении этого условия введённые значения меняются местами на этапе передачи запроса в Систему поиска).
|-  
| <div id="resorts">resorts</div>
| arr[]
| Идентификаторы курортов.
|-  
| <div id="resultFullCountRows">resultFullCountRows</div>
| int
| Количество результатов на странице в полном формате выдачи. Если параметр не передан, используется значение 10.
|-  
| <div id="resultGroupCountRows">resultGroupCountRows</div>
| int
| Количество результатов на странице в выдаче с группировкой по отелям. Если параметр не передан, используется значение 10.
|-  
| <div id="sta">sta</div>
| bool
| Автоматический запуск поиска. Возможные значения: true – запуск включён; false – запуск выключен. Если параметр не передан, используется значение false.
|-  
| <div id="threeDay">threeDay</div>
| bool
| Модификатор даты вылета (+/-3 дня). Возможные значения: true – модификатор применяется; false – модификатор не применяется. Если параметр не передан, используется значение true. Требует передачи параметра date.
|-  
| <div id="ticketsExists">ticketsExists</div>
| int
| Значение по умолчанию опции «Есть билеты». Если передано значение 1, по умолчанию опция будет отмечена галочкой. Если параметр не передан, используется значение 0. 
|-  
| <div id="ticketsIncluded">ticketsIncluded</div>
| bool
| Значение по умолчанию опции «Перелёт включён». Если передано значение false, по умолчанию галочка напротив опции будет снята. Если параметр не передан, используется значение true. 
|-  
| <div id="tourAgentCountry">tourAgentCountry</div>
| str
| Телефонный код страны в карточке тура. Возможные значения: belarus – Беларусь; ukraine – Украина. Если параметр не передан, используется страна по умолчанию - Россия.
|-  
| <div id="useAccountSettings">useAccountSettings</div>
| bool
| Использовать настройки модуля из личного кабинета sletat.ru. Возможные значения: true - использовать, false - не использовать
|-  
| <div id="useCard">useCard*</div>
| bool
| Форма онлайн-оплаты и кнопка «Купить онлайн». Возможные значения: true – включить форму; false – отключить форму. По умолчанию передаётся false.
|-  
| <div id="useDetailActualization">useDetailActualization</div>
| bool
| Детальная актуализация. Возможные значения: true – использовать, false – не использовать. Если параметр не передан, используется значение true.
|-  
| <div id="useHasTicketsControl">useHasTicketsControl</div>
| bool
| Отображать галочку «Есть билеты». Возможные значения: true - показывать, false - не показывать. Если параметр не передан, используется значение true.
|-  
| <div id="useManyOffices">useManyOffices</div>
| bool
| Режим многоофисности. Возможные значения: true – режим включён; false – режим выключен. Если параметр не передан, используется значение false.
|-  
| <div id="useOrder">useOrder</div>
| bool
| Форма заказа и кнопка «Купить в офисе». Возможные значения: true – включить форму; false – отключить форму. Если параметр не передан, используется значение true.
|-  
| <div id="useRequest">useRequest</div>
| bool
| Приём параметров поискового запроса из адресной строки браузера. Возможные значения: true – приём включён; false – приём выключен. Если параметр не передан, используется значение true.
|-  
| <div id="useSpecificOffice">useSpecificOffice</div>
| bool
| Офис по умолчанию. Возможные значения: true – офис с идентификатором officeId используется как офис по умолчанию; false – не используется. Если параметр не передан, используется значение false.
|-  
| <div id="useTitle">useTitle</div>
| bool
| Замена заголовка страницы с карточкой тура на название отеля. Возможные значения: true – заменять заголовок; false – не заменять заголовок. Если параметр не передан, используется значение true.
|-  
| <div id="useTicketsIncludedControl">useticketsIncludedControl</div>
| bool
| Отображать галочку «Перелет включен». Возможные значения: true – показывать; false – не показывать. Если параметр не передан, используется значение true.
|}