Параметры ссылки на модуль


Зачем	Экономить гостю шаги: ссылка из рассылки, поста или лендинга открывает модуль сразу с датами, составом гостей, нужными категориями, промокодом или языком.
Кому	Тем, кто ведёт сайт и кампании отеля: рассылки, посты, объявления, страницы-лендинги. Программист не нужен — параметры дописываются к адресу страницы.
Что получится	Ссылки на модуль бронирования, которые открывают его с уже подставленными датами, гостями, категориями, промокодом и языком.
Ограничения	В статье — основные параметры и сценарии; полный перечень — в справочнике «Параметры ссылки» в PMS. Параметра валюты в ссылке нет: валюту просмотра гость выбирает сам.

Ссылка на модуль бронирования — это адрес страницы, где модуль встроен, плюс параметры: короткие указания о том, что модуль должен знать ещё до первого касания гостя. Модуль открывается сразу в нужном состоянии: лендинг одной квартиры — с этой квартирой, рассылка с акцией — с датами и промокодом, письмо на немецком — на немецком. Параметры сочетаются: одна ссылка может нести и даты, и промокод, и язык.

Дата заезда

Самый частый параметр — даты: checkIn — дата заезда, checkOut — дата выезда. Даты пишутся в формате ГГГГ-ММ-ДД, например 2026-12-11. Вместо даты заезда можно передать слово today или tomorrow — модуль подставит сегодняшнюю или завтрашнюю дату. Число ночей задаётся параметром nights.

Даты в ссылке — способ привести гостя к готовому выбору. Пост про рождественские заезды, рассылка со спецпредложением на выходные — в таких сообщениях ссылка с датами избавляет гостя от первого шага: календарь откроется с уже подставленными днями.

Итог: модуль открывается с подставленными датами заезда и выезда — гость сразу видит, что доступно на его даты.

Состав гостей

Сколько человек поедет — тоже часть поиска: adults — взрослые, children — дети. Для детей через запятую можно передать возрасты; число номеров в поиске задаёт параметр rooms.

Ссылка «на семью с детьми» открывает модуль с уже заполненной компанией: гостю не нужно расставлять счётчики — поиск сразу ведётся по номерам, которые вмещают его компанию.

У виджета есть собственные значения по умолчанию — поля «Взрослых по умолчанию» и «Детей по умолчанию» на странице «Виджет» в PMS; они работают, когда гость открывает виджет без параметров.

Итог: ссылка приносит с собой состав гостей — модуль открывается с заполненными взрослыми, детьми и числом номеров.

Категории номеров

Параметр roomTypeIds указывает, какие категории показывать: модуль откроется только с выбранными категориями, остальные в поиске не появятся. Параметр повторяемый — он дописывается по одному разу на каждую категорию, так можно собрать и одну, и несколько.

Главный сценарий — лендинг одной квартиры. В апарт-отеле каждая квартира — отдельная категория; страница квартиры на вашем сайте получает собственную ссылку, которая открывает модуль сразу на этой квартире. Так же собираются ссылки «только люксы» для рекламной кампании или «двухместные» для рассылки к годовщине.

Какие категории вообще продаются на сайте, вы определяете тарифами; параметр сужает выбор внутри уже доступных. Полный перечень параметров — в справочнике «Параметры ссылки» в PMS.

Итог: одна ссылка — один набор категорий: от квартиры целиком на её лендинге до подборки под конкретную кампанию.

Промокод

Параметр promoCode приносит код в модуль: гость открывает ссылку, и код уже подставлен в поле «Промокод» в корзине — как будто он ввёл его сам. Дальше всё привычно: кнопка «Применить», ответ появляется под полем, без перезагрузки страницы.

Поле «Промокод» есть в корзине по умолчанию; за его показ отвечает тумблер «Показывать поле „промокод“» на странице «Виджет». Как устроены скидки, сроки действия кода и статистика применений — в статье о промокодах.

В паре с датами параметр собирает акцию целиком: «даты заезда плюс код» в одном письме — гость открывает модуль с уже готовыми условиями кампании.

Итог: код из ссылки уже в поле «Промокод» — гостю остаётся применить его одним нажатием.

Язык

Параметр lang задаёт язык модуля для этой ссылки: модуль откроется сразу на выбранном языке. Это нужно там, где язык известен заранее: рассылка на немецком, страница для итальянских гостей, пост в иностранной соцсети.

Набор языков модуля определяете вы — восемь гостевых языков, включать можно любые из них; переключатель языка в шапке модуля остаётся гостю. Валюты среди параметров ссылки нет: язык ссылке передать можно, валюту гость всегда выбирает сам.

Итог: ссылка открывает модуль на языке аудитории — без лишнего шага «найди свой язык».

Рецепты ссылок

Основа любой ссылки — адрес страницы, где встроен модуль. Для виджета эта страница зафиксирована в PMS: на странице «Виджет», в блоке «Поведение», есть поле «URL страницы бронирования» — страница, где встроен модуль; кнопка виджета ведёт именно на неё. Ссылка с параметрами — это этот же адрес плюс дописанные параметры: первый — после знака «?», остальные — через &.

Несколько готовых рецептов:

Акция в рассылке — даты и промокод одним сообщением:
```
https://hotel.example/booking?checkIn=2026-12-11&checkOut=2026-12-14&promoCode=WELCOME_10
```
Лендинг квартиры — одна категория, параметр повторяется по разу на каждую:
```
https://hotel.example/booking?roomTypeIds=ИДЕНТИФИКАТОР
```
Рассылка на языке гостя — к любому набору параметров добавляется lang: немецкая версия письма ведёт на ссылку с датами и языком, итальянская — со своим.

Код встраивания при этом не меняется: сниппет из PMS подключает модуль с серверов HotelsCalendar, поэтому ссылки с параметрами живут только там, где вы их раздаёте — в письмах, постах и на страницах-лендингах. Ничего править на сайте не нужно.

Итог: берёте адрес страницы бронирования, дописываете параметры — и ссылка для кампании готова.

Смотрите также

Промокоды — создать код, который ссылка подставит в корзину: скидки, сроки, ограничения и статистика.
Языки и валюты модуля — выбрать набор языков модуля и понять, почему валюты среди параметров ссылки нет.
Мульти-отельный виджет — несколько объектов в одном виджете: кому подходит и как включить выбор объекта.