Установка и подключение

Интеграция снегопада на ваш сайт занимает не более двух минут и требует минимальных знаний HTML.

Шаг 1: Скачивание архива

Скачайте архив со скриптом

Сгенерируйте и скачайте архив со скриптом на странице Параметры. Распакованный архив содержит три файла:

  • snowfall.min.js — оптимизированный, обфусцированный скрипт снегопада.
  • LICENSE — текст лицензии GNU AGPLv3.
  • README.txt — краткая инструкция на русском и английском языках для выбранного режима отображения.

Шаг 2: Загрузка на ваш сервер

Загрузите файл на сервер

Загрузите файл snowfall.min.js в директорию вашего сайта на хостинге или сервере (например, в папку /js/ или в корень сайта).

Шаг 3: Подключение в HTML-коде

Способ подключения зависит от выбранного при генерации режима отображения. Замените /path/to/ на реальный путь, куда вы загрузили файл snowfall.min.js на втором шаге.

Режим «На весь экран»

Снегопад выводится поверх всего содержимого страницы и занимает всю площадь окна браузера. Добавьте строку подключения скрипта перед закрывающим тегом </body>:

<!-- Подключение скрипта снегопада -->
<script data-skip-moving="true" data-cfasync="false" data-noptimize="1" src="/path/to/snowfall.min.js" defer></script>
Режим «В контейнере»

В этом режиме снегопад выводится не на весь экран, а внутри родительского элемента, в который подключён скрипт.

  1. Убедитесь, что родительский элемент имеет CSS-свойство position: relative (или absolute / fixed), иначе снегопад будет позиционироваться относительно ближайшего позиционированного предка или body.
  2. Подключите скрипт внутри того элемента, в котором должен идти снег, — контейнер строится в месте расположения тега <script>:
<div style="position: relative;">
  <!-- здесь появится снегопад -->
  <script data-skip-moving="true" data-cfasync="false" data-noptimize="1" src="/path/to/snowfall.min.js" defer></script>
</div>

::

⚠️ Важно: некоторые CMS и оптимизаторы переносят подключённые скрипты в <head> или в конец <body> либо переписывают их на лету. Для полноэкранного режима это некритично, но в контейнерном режиме снегопад создаётся в месте расположения тега <script> — из-за переноса снег появится не там, где вы ожидали.

Атрибуты в примерах выше — страховка от таких систем. Все три — обычные data-*, они полностью безвредны там, где не распознаны (браузер их просто игнорирует):

АтрибутДействует вЧто делает
data-skip-moving="true"1С-Битриксзапрещает ядру переносить тег в конец страницы
data-cfasync="false"Cloudflare Rocket Loaderисключает скрипт из перехвата лоадером (любой сайт за Cloudflare)
data-noptimize="1"Autoptimize (WordPress)исключает тег из агрегации, минификации и defer

Если ваш оптимизатор не поддерживает теговых атрибутов — добавьте snowfall.min.js в списки исключений в настройках плагина.

Шаг 4: Проверка работоспособности

Проверьте работу скрипта
  1. Очистите кэш вашего браузера.
  2. Обновите страницу сайта.
  3. Наслаждайтесь потрясающим эффектом падающего снега!