Промо-баннер

Описание установки и настройки решения «Промо Баннер»

Версия документа: 1.0 · Версия решения: 1.0.0

1. Требования к системе

• Платформа «1С-Битрикс: Управление сайтом» (редакции «Первый сайт» и выше) или «Битрикс24» (коробочная версия).

• PHP 8.1 и выше.

• Модуль main (устанавливается вместе с ядром платформы, дополнительная установка не требуется).

• Доступ к административной панели сайта с правами на установку модулей.

2. Установка
2.1. Через Маркетплейс

1. Перейдите в раздел Marketplace → Установленные решения → Скачать решения.

2. Найдите решение «Промо Баннер» и нажмите «Установить».

3. Дождитесь завершения загрузки и установки - система автоматически создаст структуру модуля и зарегистрирует обработчик события. Отдельных файлов стилей/скрипта решение не устанавливает: весь HTML, CSS и JS баннера собираются модулем «на лету» и вставляются напрямую в код страницы.

4. На экране подтверждения установки нажмите «Закрыть».

3. Первоначальная настройка

Настройки модуля находятся в разделе: Настройки → Настройки продукта → Модули → Промо Баннер.

Вкладка «Общие»

Параметр	Описание
Баннер активен	Общий переключатель показа баннера на сайте
Показывать на десктопе / планшетах / мобильных	Определение аудитории выполняется на сервере по User-Agent посетителя
Где показывать баннер	«На всех страницах сайта» или «Только на указанных страницах»
Страницы показа	Список адресов, по одному на строку. Поддерживается точное совпадение (/promo/leto-2026/) и маска по префиксу (/catalog/*). Заполняется только при выборе «Только на указанных страницах»

Вкладка «Позиция и размер»

Настраиваются: фиксированная позиция (сверху/снизу слева, по центру, справа, а также по центру экрана), ширина и высота контейнера, внутренние отступы, радиус скругления углов.

Вкладка «Оформление»

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

• Тип фона: сплошной цвет или градиент (два цвета + угол).

• Цвет текста.

Вкладка «Изображение и текст»

• Изображения загружаются файлом, а не по ссылке - стандартный загрузчик с превью и возможностью удаления текущего файла.

• Режим изображения: без изображения / с одной стороны / с двух сторон одновременно (отдельные файлы для левой и правой стороны) / изображение как фон баннера.

• Текст баннера, шрифт, размер и начертание.

Вкладка «Ссылка и закрытие»

• URL целевой страницы - куда ведёт клик по баннеру (это не то же самое, что «Страницы показа» на вкладке «Общие» - там задаётся, где баннер показывается).

• «Весь баннер - ссылка» - если включено, кликабелен весь блок; если выключено, внутри баннера отображается отдельная кнопка перехода.

• Отдельные настройки оформления кнопки: цвет фона, цвет текста, обводка, радиус, внутренние отступы, начертание.

• Открытие ссылки в новой вкладке.

• Кнопка закрытия баннера (крестик) и срок, на который запоминается закрытие - в днях, значение 0 означает «до конца сессии браузера».

После изменения любых настроек нажмите «Сохранить» - изменения применяются сразу, без правки файлов шаблона.

4. Проверка работы

1. Откройте страницу сайта, подпадающую под настроенную область показа, в приватном окне браузера (или удалите cookie закрытия баннера).

2. Убедитесь, что баннер отображается в выбранной позиции с заданным оформлением, изображением и текстом.

3. Проверьте клик по баннеру/кнопке - должен открываться указанный URL целевой страницы.

4. Нажмите кнопку закрытия (×) - баннер должен скрыться и не появляться повторно до истечения заданного срока.

5. Откройте страницу вне заданной области показа - баннер на ней отображаться не должен.

6. Проверьте на мобильном устройстве и в режиме эмуляции планшета - баннер должен показываться/скрываться согласно настройкам аудитории.

5. Удаление модуля

1. Перейдите в Настройки → Настройки продукта → Модули, найдите модуль и нажмите «Удалить».

2. На экране подтверждения отметьте чекбокс «Также удалить настройки модуля», если хотите полностью очистить оформление, тексты и загруженные изображения. Если оставить чекбокс не отмеченным - настройки сохранятся и будут применены автоматически при повторной установке.

3. Подтвердите удаление.

6. Возможные проблемы

Проблема	Решение
Баннер не отображается	Проверьте, что модуль активен на вкладке «Общие», аудитория для текущего устройства включена, область показа соответствует открытой странице, и в браузере нет cookie от предыдущего закрытия баннера
Баннер показывается не на той странице	Проверьте формат адресов на вкладке «Общие» в поле «Страницы показа» - путь указывается без домена, маска * работает только в конце строки
Изображение не отображается	Убедитесь, что файл действительно загружен (виден в превью на вкладке «Изображение и текст»), а не указан только режим изображения без самого файла
Кнопка закрытия не запоминает выбор	Проверьте, что в браузере разрешены cookie для сайта; при значении «0 дней» закрытие действует только до конца текущей сессии браузера
Изменения в настройках не применяются	Сбросьте кеш сайта (Настройки → Автокэширование → Очистить кеш); при включённом Композите см. раздел 5