Описание модуля — различия между версиями

Материал из wiki.Sletat.ru
Перейти к: навигация, поиск
Строка 161: Строка 161:
 
|
 
|
 
|-
 
|-
 
== Параметры кода ==
 
В таблице ниже представлены все параметры, используемые в коде вызова Модуля поиска туров.
 
Обязательные параметры отмечены знаком *.
 
 
Типы параметров:
 
 
* '''int''' — целое число.
 
* '''str''' — строка (текст, ссылка, любые нечисловые символы). Помещается в кавычки ("").
 
* '''bool''' — логический оператор. Имеет два значения: true и false.
 
* '''obj''' — объект. Набор параметров,  которые вместе описывают одно сложное целое.
 
* '''arr[]''' — массив. Набор числовых или строковых значений. Помещается в квадратные скобки ([]). Строковые значения помещаются в кавычки ("").
 
 
{| class="wikitable"
 
! Параметр
 
! Тип
 
! Описание
 
|- 
 
| <div id="adults">adults</div>
 
| int
 
| Количество туристов (взрослых). Возможные значения: целое число от 1 до 4. Если параметр не передан, используется значение 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="kid1">kid1</div>
 
| int
 
| Возраст первого ребёнка. Возможные значения: целое число от 0 до 15. Если параметр не передан, используется значение 0.
 
|- 
 
| <div id="kid2">kid2</div>
 
| int
 
| Возраст второго ребёнка. Возможные значения: целое число от 0 до 15. Если параметр не передан, используется значение 0.
 
|- 
 
| <div id="kid3">kid3</div>
 
| int
 
| Возраст третьего ребёнка. Возможные значения: целое число от 0 до 15. Если параметр не передан, используется значение 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.
 
|}
 

Версия 12:35, 7 сентября 2023


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

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

Настройка модуля поиска туров 6.0 состоит из 2 блоков:

Форма поиска

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

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

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

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

Легенда:

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