Описание модуля — различия между версиями
Материал из wiki.Sletat.ru
Kdadmin (обсуждение | вклад) |
Kdadmin (обсуждение | вклад) |
||
| Строка 182: | Строка 182: | ||
| <div id="adults">adults</div> | | <div id="adults">adults</div> | ||
| int | | int | ||
| − | | Количество туристов (взрослых). Возможные значения: целое число от 1 до | + | | Количество туристов (взрослых). Возможные значения: целое число от 1 до 6. Если параметр не передан, используется значение 2. |
|- | |- | ||
| <div id="agencyContact1">agencyContact1</div> | | <div id="agencyContact1">agencyContact1</div> | ||
Версия 12:40, 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] | Кликнув по иконке "Добавить ребенка", турист сразу выбирает его возраст. |
| «Найти» | Поиск туров. | Начинать поиск автоматически. | Нет. | 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 | |
Параметры кода
В таблице ниже представлены все параметры, используемые в коде вызова Модуля поиска туров. Обязательные параметры отмечены знаком *.
Типы параметров:
- int — целое число.
- str — строка (текст, ссылка, любые нечисловые символы). Помещается в кавычки ("").
- bool — логический оператор. Имеет два значения: true и false.
- obj — объект. Набор параметров, которые вместе описывают одно сложное целое.
- arr[] — массив. Набор числовых или строковых значений. Помещается в квадратные скобки ([]). Строковые значения помещаются в кавычки ("").
| Параметр | Тип | Описание |
|---|---|---|
| adults
|
int | Количество туристов (взрослых). Возможные значения: целое число от 1 до 6. Если параметр не передан, используется значение 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. |
| 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. |
