Руководство пользователя
Установка
Перед установкой модуля рекомендуется выполнить резервное копирование вашего сайта. Подробнее здесь.

Предварительные требования.
В зависимости от конфигурации вашего сервера установка модуля может занимать от нескольких секунд до 2 минут. Поэтому перед установкой модуля рекомендуется увеличить время исполнения скрипта php. В файле php.ini конфигурации php установите значение:

max_execution_time = 300;

В Ubuntu файл конфигурации php: /etc/php/8.2/apache2/php.ini. После внесения изменений перезагрузите apache.
В случае, если в качестве прокси используется сервер nginx, возможно появление ошибки 504 Gateway Time-out, т.к. по умолчанию таймаут в nginx равен 60 сек. В этом случае необходимо увеличить таймауты в настройках nginx. Создайте в папке /etc/nginx/conf.d/ файл timeout.conf со следующим содержимым:

proxy_connect_timeout 300;
proxy_send_timeout 300;
proxy_read_timeout 300;
send_timeout 300;

Для установки решения необходимо:
  • Авторизоваться в панели управления Вашего сайта под правами администратора.
  • Зайти в раздел Marketplace > Обновление решений - вкладка «Активация купона» и ввести купон в специальном поле.
  • После ввода купона в списке решений для установки появится купленное решение. Нажмите «Установить».
Мастер установки.
В начале установки мастер установки попросит указать следующие данные:
  • Сайт для установки модуля (обязательно). Мастер установки предложит выбрать один из сайтов, если в CMS их сконфигурировано несколько. Модуль не допускает установку на несколько сайтов одновременно.
  • URL сайта для установки модуля (обязательно). Это URL, по которому сайт доступен из интернет. Проверьте URL, который определил мастер установки. Исправьте, если нужно.
  • Имя каталога в корне сайта для установки файлов модуля. Мастер установки создаст каталог в корневой папке сайта и запишет туда файлы, необходимые для работы модуля. Если каталог уже существует, установка закончится ошибкой.
  • Имя каталога в файловой системе для установки файлов модуля. Значение выводится для информации. Проверьте путь установки в файловой системе, который определил мастер установки.
  • Название гостиницы (обязательно). Используется в хедере страниц модуля и в email уведомлениях.
  • E-mail гостиницы (обязательно). Используется для email-уведомлений.
  • Телефон гостиницы (опционально). Используется в хедере страниц модуля и в email уведомлениях.
  • Адрес гостиницы (опционально). Используется в хедере страниц модуля и в email уведомлениях.
  • E-mail для получения технических уведомлений (опционально). Используется для технических email уведомлениий. Если не указан, будет использован E-mail гостиницы.
  • Установить инфоблоки и демо-данные. При первой установке флаг должен быть установлен. При переустановке модуля флаг нужно снять, если необходимые инфоблоки уже были установлены и не удалялись при деинсталляции.

Результат установки.

После успешной установки модуля в системе будут созданы следующие объекты:
  • Основная папка с кодом модуля /bitrix/modules/vibook.booking.
  • Папка модуля в корневом каталоге сайта, по умолчанию /vibook.
  • Папка шаблона сайта /local/templates/vibook.
  • Инфоблоки с демо-данными:
    • Категории номеров
    • Тарифы
    • Цены
    • Брони
    • Гости
    • Промокоды
  • Компоненты модуля в папке /bitrix/components/vibook
  • Административные скрипты vibook_*.php в папке /bitrix/admin
  • Папка стилей административного раздела /bitrix/css/vibook.booking
  • Папка скриптов административного раздела /bitrix/js/vibook.booking
  • Каталог журналов, по умолчанию /vibooklogs, в домашней директории пользователя web-сервера
  • Почтовые события:
    • VIBOOK_BOOK, Бронирование на сайте
    • VIBOOK_BOOK_CANCEL, Отмена бронирования на сайте
    • VIBOOK_TECHALERT, Техническое уведомление системы бронирования
  • Почтовые шаблоны:
    • Подтверждение бронирования #HOTELNAME#
    • Уведомление о бронировании #HOTELNAME#
    • Подтверждение отмены бронирования #HOTELNAME#
    • Уведомление об отмене бронирования #HOTELNAME#
    • Техническое уведомление системы бронирования сайта #SITE_NAME#
  • Агент модуля vibook.booking