https://github.com/webvpf/wn-christmas-plugin
Decorations for the site for the Christmas holidays.
https://github.com/webvpf/wn-christmas-plugin
christmas garland snowflake wintercms wintercms-plugin
Last synced: 16 days ago
JSON representation
Decorations for the site for the Christmas holidays.
- Host: GitHub
- URL: https://github.com/webvpf/wn-christmas-plugin
- Owner: WebVPF
- License: mit
- Created: 2021-12-11T23:02:46.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2025-01-07T05:10:19.000Z (9 months ago)
- Last Synced: 2025-06-30T16:51:19.373Z (3 months ago)
- Topics: christmas, garland, snowflake, wintercms, wintercms-plugin
- Language: PHP
- Homepage: https://packagist.org/packages/webvpf/wn-christmas-plugin
- Size: 440 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README-RU.md
- License: LICENSE
Awesome Lists containing this project
README
# Новогодние праздники
Украшения на новогодние праздники для сайтов Winter CMS.
## Установка через Composer
```bash
composer require webvpf/wn-christmas-plugin
```
## Особенности
- без взаимодействия с базой данных
- без jQuery
### Компоненты плагина
- Новогодняя гирлянда
- Снег
## Новогодняя гирлянда
```ini
[ChristmasGarland]
dateOn = "01-01"
dateOff = "12-31"
==
{% component 'ChristmasGarland' %}
```
Дата включения и выключения гирлянды указывается в формате `мм-чч`.
## Снег
```ini
[ChristmasSnow]
amount = 50
size = 5
speed = 1.5
wind = 0
color = "#fff"
opacity = 0.8
swing = 1
==
{% component 'ChristmasSnow' %}
```
- `amount` - Количество снежинок, отображаемых одновременно. По умолчанию: `50`
- `size` - размер снежинки. По умолчанию: 5
- `speed` - Скорость падения снежинок по вертикали. Чем больше значение, тем снежинки падают быстрее. По умолчанию: `1.5`
- `wind` - Горизонтальная энергия ветра. Ветер будет дуть вправо, если это положительное число, а отрицательное число заставляет ветер дуть влево. По умолчанию: 0
- `color` - Цвет снежинок. Данный параметр принимает цветовой код HEX или RGB, например `#fff`, `#ffffff` или `rgb (255,255,255)`. По умолчанию: `#fff`
- `opacity` - Максимальная прозрачность снежинок. Плагин будет генерировать снежинки с различной прозрачностью от 0 до этого числа. По умолчанию: `0.8`
- `swing` - Качание снежинок. Если вы не хотите чтобы снежинки качались, установите для этого параметра значение `0`. По умолчанию: `1`
---
## Пример вывода гирлянды в Демо-теме Winter CMS
Ниже пример того как вставить гирлянду в демо-шаблоне на главную страницу сайта сразу под меню. По такому принципу можно вставить гирлянду не на странице, а в шаблон (для вывода на всез страницах).
Перейдите в CMS и откройте страницу **Demonstration**. В самое начало разметки вставьте перетаскиванием компонент **Новогодняя гирлянда**. Чтобы сделать отображение гирлянды правильным, добавьте перед твигом выводящим компонет `ChristmasGarland` стили как в данном примере:
```twig
.jumbotron{padding-top:100px}.b-page_newyear{position:absolute;width:100%;height:100px;top:71px}
{% component 'ChristmasGarland' %}
контент демо страницы...
```
