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

Материал из wiki.Sletat.ru
Перейти к: навигация, поиск
(Карточка тура)
(Карточка тура)
Строка 224: Строка 224:
 
|-
 
|-
 
|Карта
 
|Карта
|Карта Google с отмеченным расположением отеля.
+
|Карта Яндекс с отмеченным расположением отеля.
|[[Дополнительные настройки модуля поиска туров 5.0|Указать лицензионный ключ Карт Google]].
+
|Нет
|[[#googleMapKey|googleMapKey]]
+
|Нет
|Сайты с большим потоком посетителей должны приобрести лицензию на использование Карт Google.
+
|Сайты с большим потоком посетителей должны приобрести лицензию на использование Карт Яндекс.
 
|-
 
|-
 
|Информационный блок — Описание
 
|Информационный блок — Описание

Версия 14:59, 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

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

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

Параметр Описание Доступные настройки Параметр кода
Вывод ленты выдачи Лента выдачи выводится во всплывающем окне или под формой поиска. Нет results
Автоматический запуск поиска Модуль может запускать поиск автоматически, как только турист заходит на страницу. Включить автоматический поиск sta
Внимание! Маска скидки не уменьшает цену тура, а только выводит её как скидочную. Настоящую скидку вы можете настроить в Личном кабинете.

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

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

Блок Описание Доступные настройки Параметры кода Дополнительно
Заголовок Название тура и его короткий номер. Нет Нет Используйте короткий номер, чтобы быстро найти тур в системе Слетать.ру.
Описание тура Направление и город вылета, продолжительность (в ночах), тип номера и тип питания. Нет Нет
Цена Цена тура с минимальными обязательными доплатами, спецификация доплат (выводится по клику), кнопки «Купить в офисе» и/или «Купить онлайн». Включение формы онлайн-оплаты. useCard, useOrder
Фотографии Фотографии отеля Нет Нет На фотографиях размещается водяной знак вашего сайта.
Карта Карта Яндекс с отмеченным расположением отеля. Нет Нет Сайты с большим потоком посетителей должны приобрести лицензию на использование Карт Яндекс.
Информационный блок — Описание Сайт, телефон, e-mail отеля, количество мест, расстояние до аэропорта, текстовое описание и прогноз погоды на курорте. Нет Нет
Информационный блок — Услуги Краткий список услуг с иконками Нет Нет
Информационный блок — Карта Карта Яндекс с отмеченным расположением отеля. Нет Нет Сайты с большим потоком посетителей должны приобрести лицензию на использование карт Яндекс
Информационный блок — Отзывы Отзывы туристов, посетивших отель, с оценкой по десятибалльной шкале.

В дополнения к отзывам имеется возможность подключить отзывы TripAdvisor.

Нет Нет Блок отзывов требует отдельной лицензии, которую надо привязать к вашему сайту. За подключением обратитесь к вашему персональному менеджеру.
Блок контактов Блок рядом с заявкой на тур. Содержат ваш логотип, контактные данные (телефон и e-mail) и дополнительную информацию на ваше усмотрение. Добавить контактные данные agencyContact1, agencyContact2
Форма заявки С помощью формы турист отправляет вам свои ФИО, телефон, e-mail и комментарий длиной до 500 символов. Использовать форму заказа useOrder Режим многоофисности требует отдельной лицензии. За подключением обратитесь к вашему персональному менеджеру.
Форма онлайн-оплаты С помощью этой формы турист может сразу оплатить тур по банковской карте. Использовать форму онлайн-оплаты useOrder, buyingType Требует подключения системы биллинга Слетать.ру.
Над карточкой тура имеются кнопки поделиться в соцсетях и добавить в сравнение. При нажатии добавить "Сравнить", тур добавляется в список сравнения, открыв который, можно сравнить туры по основным параметрам. Список в закрытом виде показывается посетителям на протяжении всего времени нахождения на сайте.

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

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

Форма заявки

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

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

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

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

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

Внимание! Если вы не заполните раздел «Настройка уведомлений», уведомления туристу отправляться не будут, а вам будут приходить только электронные письма на адрес, указанный при регистрации на sletat.ru.

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

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

Внимание! Форма онлайн-оплаты требует подключения Системы биллинга Слетать.ру.

Параметры кода

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

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

  • 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.
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.