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

Все эффекты Holiday Decor выводит компонент «Праздничный декор (Holiday Decor)». Это обязательная часть работы модуля: если компонент не выполняется на странице, никакие настройки праздничного пресета не появятся в публичной части.

[Скриншот 1: компонент Holiday Decor в редакторе страницы или шаблона]

У компонента нет отдельных параметров

Компонент не требует выбора праздника, плотности снега или изображений при размещении. Все рабочие параметры берутся из настроек модуля для текущего сайта.

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

Где размещать компонент

На отдельной странице

Подходит для промо-страницы или тестирования. Декор будет работать только там, где физически присутствует компонент.

В шаблоне сайта

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

Это удобнее, чем добавлять компонент вручную в десятки файлов.

Как модуль принимает решение о показе

В обычном режиме компонент последовательно проверяет:

1. включён ли модуль целиком;
2. включён ли декор для текущего сайта;
3. какой праздник выбран активным для сайта;
4. включён ли этот праздник;
5. попадает ли текущая дата в период праздника;
6. разрешена ли текущая страница масками URL.

Если хотя бы одно из условий не выполнено, компонент завершается без вывода декора.

Что означает «компонент есть, но ничего не видно»

Это не обязательно ошибка. Чаще всего причина в одном из условий показа. Например:

• закончился период выбранного праздника;
• праздник выключен на собственной вкладке;
• сайт выключен в общих настройках;
• текущий URL не совпадает ни с одной маской;
• для активного праздника отключены все видимые эффекты.

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

Размещение на многосайтовой установке

Компонент определяет текущий сайт по его идентификатору и берёт настройки именно этого сайта. Поэтому один общий шаблон может содержать один экземпляр компонента, а сайт A и сайт B будут использовать разные активные праздники и разные маски.

[Скриншот 2: блок сайтов на вкладке «Общие»]

Взаимодействие с дизайном сайта

Декоративные слои выводятся поверх страницы. Перед публикацией проверьте:

• фиксированную шапку и мобильное меню;
• виджеты обратного звонка и чата;
• cookie-баннеры;
• кнопки в верхней и нижней части экрана;
• формы, где пользователю нужно активно кликать мышью.

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

Font Awesome

Стандартный шаблон компонента подключает Font Awesome для пользовательских и фиксированных иконок. Если на проекте запрещены внешние ресурсы или они блокируются политиками безопасности, элементы, основанные на классах Font Awesome, могут отображаться некорректно. В таком окружении проверьте подключение иконок на самом сайте или используйте графические и встроенные символьные эффекты.

Проверка после изменения шаблона

Если разработчик переносит компонент в другой шаблон сайта или меняет структуру страницы, повторно проверьте декор на компьютере и мобильном устройстве. Особенно важны фиксированные полосы сверху и снизу.

[Скриншот 3: публичная страница с декором и основными элементами интерфейса сайта]