Установка модуля SenDev: Holiday Decor. Праздничный декор для сайта

Модуль устанавливается стандартным способом через административную часть 1С-Битрикс. После установки становятся доступны настройки праздничных пресетов и компонент «Праздничный декор (Holiday Decor)», который выводит оформление в публичной части сайта.

Инструкция соответствует версии 0.9.02.

[Скриншот 1: установка модуля Holiday Decor в административной части]

Что происходит при установке

Во время установки модуль:

• регистрируется в системе;
• устанавливает компонент праздничного декора;
• копирует стандартные графические материалы в каталог /upload/holidecor/;
• создаёт стартовые настройки для всех активных сайтов;
• создаёт готовые пресеты праздников;
• создаёт справочник фиксированных элементов.

Отдельные таблицы базы данных модуль не создаёт: параметры хранятся как настройки модуля.

Начальные настройки после установки

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

При этом в административной форме по умолчанию показаны только вкладки:

• «Новый год»;
• «Пользовательский».

Остальные готовые праздники уже имеют пресеты, но их вкладки нужно включить в разделе «Какие праздники использовать и показывать во вкладках».

Графические файлы

При установке в /upload/holidecor/ копируются изображения, которые используются стандартными праздничными вариантами, в том числе новогодними и хэллоуинскими полосами.

Если каталог /upload/ защищён особыми правилами или недоступен для записи, после установки обязательно проверьте, что графика действительно появилась и видна в публичной части.

Компонент обязателен

Установка и включение модуля сами по себе не добавляют декор на страницы. Для вывода должен быть подключён компонент «Праздничный декор (Holiday Decor)».

Есть два обычных варианта:

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

После подключения компонента фактический показ всё равно контролируется настройками модуля, сайта, активного праздника, дат и масок URL.

[Скриншот 2: компонент «Праздничный декор (Holiday Decor)» в списке компонентов]

Первый безопасный запуск

1. Создайте тестовую страницу или выберите страницу, на которой уже можно разместить компонент.
2. Добавьте компонент праздничного декора.
3. Откройте настройки модуля.
4. Убедитесь, что включены общий флаг модуля и нужный сайт.
5. Для сайта укажите тестовую страницу в поле «Страница для предпросмотра».
6. Откройте вкладку «Новый год».
7. Используйте ссылку предпросмотра и проверьте эффекты.
8. После проверки задайте маски страниц и рабочий активный праздник.

Как понять, что установка выполнена правильно

Проверьте четыре признака:

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

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

При стандартном удалении компонент удаляется из персонального каталога компонентов, а все настройки модуля очищаются.

Графические материалы из /upload/holidecor/ текущая версия при удалении автоматически не удаляет. Поэтому, если модуль больше не нужен, эти файлы можно удалить вручную после проверки, что они не используются шаблоном или другими доработками сайта.

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

Если скоро планируется обновление

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