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

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

Версия документа: 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

Описание технической поддержки и контактных данных

Решение: «Промо Баннер» (webjox.prommobanner) Разработчик: ООО "Вебджокс"

1. Состав технической поддержки

Техническая поддержка включает:

• консультации по установке и настройке решения;

• помощь в диагностике проблем, связанных непосредственно с работой решения (баннер не отображается, не применяются настройки оформления, не загружается изображение и т.п.);

• исправление ошибок в работе решения;

• предоставление обновлений решения в рамках оплаченного срока поддержки.

Техническая поддержка не включает:

• юридическую консультацию по содержанию рекламных материалов, размещаемых в баннере, и по вопросам их соответствия рекламному законодательству - эти вопросы находятся вне компетенции технической поддержки;

• доработку решения под нестандартные требования Пользователя (нетиповые сценарии показа, интеграция со сторонними системами аналитики/рекламы и т.п.) - такие работы выполняются на условиях отдельного соглашения;

• устранение конфликтов с модифицированными шаблонами сайта или сторонними модулями, если конфликт вызван изменениями, внесёнными Пользователем или третьими лицами;

• настройку зон композитного кеширования сайта под работу решения - рекомендации даны в документации по установке (раздел «Совместимость с композитным кешированием»), но применение этих настроек на конкретном сайте - зона ответственности администратора сайта.

2. Срок и порядок оказания поддержки

• Срок бесплатной технической поддержки: 12 месяцев с момента приобретения лицензии, либо в соответствии с условиями, указанными на странице решения в Маркетплейсе.

• Продление поддержки возможно на условиях, актуальных на момент обращения.

• Целевое время реакции на обращение: 24–48 часов в рабочие дни.

• Целевое время решения критических проблем (полная неработоспособность решения): 5 рабочих дней.

3. Как обратиться в поддержку

При обращении, пожалуйста, укажите:

1. Версию решения (см. в разделе Модули → Промо Баннер).

2. Версию платформы «1С-Битрикс» и редакцию (Управление сайтом / Битрикс24).

3. Версию PHP.

4. Включена ли на сайте технология «Композит».

5. Подробное описание проблемы и шаги для воспроизведения.

6. При наличии - скриншоты, адрес страницы, на которой воспроизводится проблема, и лог-файл модуля /local/logs/webjox_webjoxprommobanner_errors.log, если он есть.

4. Контактные данные

Канал	Контакт
Email технической поддержки	hello@webjox.ru
Телефон	+7 (991) 539-14-43
Форма обращений на сайте	https://webjox.ru
Личный кабинет в Маркетплейсе «1С-Битрикс»	[ссылка на страницу решения]
Часы работы поддержки	Пн–Пт, 10:00–19:00 МСК

5. Реквизиты разработчика

Наименование: ООО "Вебджокс" ИНН: 6164138922 ОГРН: 1226100022114 Юридический адрес: 344011, Ростовская область, г. Ростов-на-Дон