Holiday Decor — это модуль для 1C-Bitrix, который добавляет праздничный декор на сайт: снег, гирлянды, клики-«снежки», декоративные шапки/футеры из картинок и многое другое. Всё настраивается из административной части, без правки кода.

Подходит для Нового года, Рождества, 14 февраля, 23 февраля, 8 марта, Хэллоуина и любых ваших собственных праздников.

Основные возможности

• Готовые пресеты под популярные праздники — Новый год, Рождество, 14 февраля, 23 февраля, 8 марта, 9 мая, Хэллоуин, а также отдельный пресет «Пользовательский» для любых других акций и событий.
• Падающие элементы на фоне — снег, снежинки, сердечки, лепестки, конфеты, летучие мыши и др. Регулировка плотности «снега» в миллисекундах.
• Эффекты по клику — снежки, снежинки, сердечки, цветы, конфеты, фейерверки, тыквы, а также возможность указать любой класс Font Awesome. Настройка цвета и максимального количества эффектов на экране.
• Фиксированные элементы — гирлянды, иконные ряды, графические полосы для шапки и футера, спрайты на основе HTML/CSS/JS.
• Праздничный курсор — вместо стандартного курсора рядом с указателем «летит» иконка Font Awesome (снежинка, сердце и т.п.).
• Гибкая работа по датам — для каждого праздника задаётся период показа, встроенная проверка пересечения дат.
• Удобный предпросмотр для администратора — специальный параметр holidecor_preview=Y, переключатели эффектов, подсказка внизу страницы.
• Работа по маскам URL — можно включить декор только на нужных разделах сайта.

Установка

1. Установите модуль стандартным способом через Marketplace или загрузите архив в раздел «Установленные решения».
2. Активируйте модуль.
3. Подключите компонент декора на нужную страницу (обычно это главная или шаблон сайта). Компонент не требует детальной настройки — всё берётся из настроек модуля.
4. После установки перейдите в Настройки → Настройки продукта → Модули → Праздничный декор сайта.

Быстрый старт: как запустить Новый год за 5 минут

1. Зайдите в настройки модуля во вкладку **«Общие»**.
2. Отметьте чекбокс **«Включить модуль»**.
3. В блоке **«Сайты»** включите декор для нужных сайтов, выберите активный праздник (например, «Новый год») и укажите страницу для предпросмотра.
4. Во вкладке **«Общие» → «Праздники»** убедитесь, что включены нужные праздники.
5. Перейдите на вкладку **«Новый год»**, включите чекбокс **«Включить этот праздник»**, при необходимости задайте даты начала/окончания.
6. Откройте вашу страницу предпросмотра с добавкой в URL: ?holidecor_preview=Y&holidecor_holiday=new_year

Настройка по вкладкам

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

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

2. Вкладка «Страницы»

• Маски URL — на каких страницах отображать декор (например, /, /catalog/*).

3. Вкладки праздников («Новый год», «Рождество» и т.д.)

• Включить этот праздник — участие пресета в работе.
• Период показа — дата начала и окончания.
• Падающие элементы — включение/выключение, интервал между элементами.
• Эффект по клику — выбор набора, цвет, максимальное количество эффектов.
• Фиксированные элементы — выбор верхних/нижних элементов из справочника.
• Курсор — класс и цвет иконки Font Awesome.
• Предпросмотр — ссылки и подсказки для администратора.

4. Вкладка «Элементы»

Справочник фиксированных элементов: ряды иконок, графические полосы, спрайты. Для каждого элемента задаётся код, название, позиция, тип и настройки.

Предпросмотр и панель администратора

При открытии страницы с параметром holidecor_preview=Y администратор видит панель управления и подсказку для тестирования эффектов.

Советы по использованию

• Не используйте слишком высокую плотность снега на слабых сайтах.
• Для маркетинговых акций создавайте отдельный «Пользовательский» пресет.
• Следите за предупреждениями о пересечении дат праздников.
• Для адаптивного дизайна используйте картинки-полосы с прозрачным фоном.

Подключение компонента

Модуль использует один компонент декора:

<?php
$APPLICATION->IncludeComponent(
    "sendev:holiday.decor",
    "",
    [],
    false
);
?>

Рекомендуемые варианты размещения:

• в шаблоне сайта, например header.php или footer.php;
• на главной странице (index.php) или на общем шаблоне, чтобы декор был на всех страницах.

Компонент не требует сложных параметров — он берёт все настройки из административного интерфейса модуля.

Поддержка нескольких сайтов

Модуль полностью поддерживает многосайтовость Bitrix:

• для каждого сайта можно:
  • включить/выключить декор;
  • выбрать активный праздник;
  • задать страницу для предпросмотра;
  • задать собственные маски URL.

Определение сайта происходит стандартно по SITE_ID, поэтому один и тот же компонент в шаблоне корректно отрабатывает для всех сайтов.

Настройки без правки кода

• Все параметры (эффекты, даты, наборы иконок, графические полосы, курсор) настраиваются через панель администратора.
• Вкладка «Элементы» позволяет:
  • добавить новые «ряды иконок» (Font Awesome),
  • подключить собственные изображения для шапки/футера,
  • использовать кастомные HTML/CSS/JS-спрайты.
• Разработчику не нужно модифицировать шаблон компонента — достаточно один раз подключить его и передать управление контент-администраторам.

Режим предпросмотра

Для проверки без влияния на посетителей можно использовать:

?holidecor_preview=Y&holidecor_holiday=new_year

и, при необходимости:

&holidecor_cursor=fa-regular%20fa-snowflake

Панель предпросмотра и подсказка видны только авторизованным администраторам.