=== Code Live Snow ===
Contributors: usman184
Tags: snow, christmas, halloween, holiday, animation
Requires at least: 5.0
Tested up to: 7.1
Requires PHP: 7.0
Stable tag: 2.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Lightweight snow and holiday effects: Christmas, Halloween, New Year, Valentine's, Easter, Autumn, Ramadan & Eid. Colours, presets, auto calendar.

== Description ==

Code Live Snow adds a lightweight, canvas-based falling snow animation to your site. Everything is configured from one simple settings screen, and the snow can switch itself on and off automatically by date.

**Features**

* 37 built-in shapes: snowflakes, snowman, Christmas trees, ornament balls, gifts, candy canes, stars, bells, holly, Santa hats, pumpkins, bats, ghosts, candy, spiders, witch hats, confetti, fireworks, balloons, hearts, love letters, Easter eggs, flowers, chicks, leaves, acorns, crescent moons, lanterns and more
* One-click event presets: Winter, Christmas, New Year, Valentine's Day, Easter & Spring, Halloween, Autumn, Ramadan & Eid
* Automatic holiday calendar: the right effect switches on by date every year (dates are editable)
* Colour options: original colours, one colour for everything, or a multi-colour palette (up to 8 colours) with quick palettes
* Opacity control, and optional recolouring of your own images
* Add up to 20 custom images from your Media Library
* Five directions, including rising (great for balloons)
* Separate counts for mobile and desktop (set mobile to 0 to hide on phones)
* Min/max size, rotation and sway toggles
* Show only on chosen pages, or hide on chosen pages
* Modern tabbed settings page with a live preview
* Respects "reduce motion" and Data Saver settings
* Settings are kept when you update or reinstall (optional delete on uninstall)
* No tracking, no external requests, no ads

**Built for speed**

* Nothing loads on pages where the effect is off
* One small deferred script (about 6 KB gzipped), no jQuery on the front end
* Starts only after the page has fully loaded, so it does not affect page speed scores
* Each shape is drawn once and reused; phones run at 30fps to save battery

== Installation ==

1. Upload the `code-live-snow` folder to `/wp-content/plugins/`, or install it from the Plugins screen.
2. Activate the plugin through the Plugins screen.
3. Go to Settings → Code Live Snow to configure it.

== Frequently Asked Questions ==

= How do I show snow only on certain pages? =

Enter the page or post IDs separated by commas in "Show only on IDs". Leave the field empty to show snow everywhere.

= Will the snow block clicks on my site? =

No. The snow canvas uses `pointer-events: none`, so visitors can click through it.

= Can I use my own snowflake images? =

Yes. Click "Add Images" and select one or more images from your Media Library. You can combine them with the built-in styles.

= Will I lose my settings when I update? =

No. Updating never removes settings. Settings are also kept if you delete and reinstall the plugin, unless you turn on "Delete all settings when the plugin is deleted" under Settings → Code Live Snow → Advanced.

= Which snowflake styles are used by default? =

Soft dot, Classic flake and Crystal flake. You can change this under Settings → Code Live Snow.

== Changelog ==

= 2.0.2 =
* Settings now save instantly without reloading the page (Ctrl/Cmd + S also saves)
* The status badge updates right after saving
* Fixed the "Settings saved." message showing twice
* Notices now appear below the page header

= 2.0.1 =
* Settings are now kept when the plugin is deleted and reinstalled
* New option: "Delete all settings when the plugin is deleted" (Advanced tab, off by default)
* Lighter defaults for new installs: 25 shapes on desktop, 15 on mobile

= 2.0.0 =
* New: 32 holiday shapes for Christmas, Halloween, New Year, Valentine's Day, Easter, Autumn, Ramadan & Eid
* New: colour modes (original, single colour, multi-colour palette) and opacity
* New: one-click event presets and an automatic holiday calendar
* New: rising direction, rotation and sway toggles, exclude page IDs
* New: redesigned settings page with tabs and a live preview
* Faster: single minified deferred script that starts after page load, 30fps on phones
* Settings from 1.x are kept when upgrading

= 1.4.0 =
* Added 5 built-in snowflake styles bundled with the plugin
* Select multiple snowflake styles at once
* Add multiple custom snow images from the Media Library
* Added minimum and maximum flake size settings
* Flakes now gently rotate and sway
* Existing single custom image is kept when upgrading

= 1.3.2 =
* Moved all JavaScript and CSS into properly enqueued files
* Added stricter sanitization and validation of all settings
* Made all strings translatable
* Snow now respects the "prefers reduced motion" setting
* Page ID targeting now works for posts as well as pages
* Added Settings link on the Plugins screen
* Settings are removed when the plugin is deleted

= 1.3.1 =
* Fixed media uploader button not opening

== Upgrade Notice ==

= 2.0.2 =
Settings now save instantly without a page reload.

= 2.0.1 =
Your settings are now kept when the plugin is deleted and reinstalled.

= 2.0.0 =
Holiday effects, colour options, automatic holiday calendar and a new settings page.

= 1.4.0 =
Adds built-in snowflake styles and multiple custom images.

= 1.3.2 =
Code quality and security improvements for the WordPress.org directory.
