=== Rs Christmas Santa ===
Contributors: therssoftware
Tags: christmas, christmas santa, snowfall, christmas music, christmas countdown, christmas lights, holiday banner
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.2.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Celebrate the holiday season with Santa Pop-Ups, Christmas Lights, Cursor Trails, Flying Sleigh, Confetti Bursts, festive holiday music, realistic snowfall, countdown timers, and holiday announcement banners!

== Description ==

Bring the joy and magic of Christmas to your WordPress website! **Rs Christmas Santa** is the most complete, lightweight, and easy-to-use holiday plugin that engages your visitors with delightful festive effects.

All effects can be individually toggled and scheduled so you have complete control over your holiday website theme.

### 🌟 Key Features:

* 🎅 **Festive Santa Pop-Up & Flying Santa:** Choose from 21 delightful Santa avatars. Display in corner or let Santa fly across the screen with smooth animations.
* 🎄 **Christmas Lights / Fairy Lights:** Animated string lights hanging along the top of your website with 5 bulb styles (Classic, C9, Round, Star, Icicle) and 5 color schemes (Multicolor, Warm White, Red & Green, Blue & Silver, Gold).
* ✨ **Festive Cursor Trail:** Beautiful particle trail following the mouse cursor with 3 styles — Snowflakes, Stars, and Sparkles. Automatically hidden on touch/mobile devices.
* 🛷 **Santa Sleigh Fly-Across:** Santa's reindeer-pulled sleigh periodically flies across the screen with configurable speed, direction, and frequency.
* 🎊 **Confetti Celebration Burst:** A festive confetti explosion greets your visitors when they first arrive during the holiday season. Fires once per session.
* ❄️ **Realistic Snowfall Effect:** Smooth 60fps canvas snow animation across your entire website with custom intensity (Light, Medium, Blizzard) and snowflake color.
* 🎵 **Holiday Background Music Player:** Floating festive mini audio player with bundled holiday favorites (Jingle Bells, We Wish You a Merry Christmas, Silent Night, Deck the Halls).
* 🎁 **Holiday Announcement Bar:** Sticky top banner for special holiday greetings or promotion codes (e.g., "🎅 Merry Christmas! Enjoy 20% off with coupon XMAS2026").
* ⏱️ **Christmas Countdown Timer:** Use the `[rs_christmas_santa_count_down]` shortcode or the **Christmas Countdown Gutenberg block** anywhere on your pages, posts, or widgets with 5 festive countdown badge styles.
* 📅 **Automated Holiday Schedule:** Configure effects to automatically activate X days/hours before Christmas and stop afterwards.
* 📱 **Mobile Optimization:** Option to disable or adapt animations on mobile devices for seamless user experience.
* 👁️ **Interactive Live Preview:** Admin dashboard includes real-time live preview of all visual styles.
* 🧩 **Gutenberg Block:** Native WordPress block editor support for the Christmas Countdown timer.

== Installation ==

1. In your WordPress Admin, go to **Plugins > Add New**.
2. Search for `Rs Christmas Santa`.
3. Click **Install Now**, then click **Activate**.
4. Navigate to **Rs Christmas Santa** in the WordPress admin menu to configure your festive options!

== Frequently Asked Questions ==

= How do I display the countdown timer on a page or post? =
You can either paste the shortcode `[rs_christmas_santa_count_down]` or use the **Christmas Countdown** Gutenberg block directly in the block editor.

= Can I choose which pages show the Santa pop-up or music? =
Yes! In the plugin settings, you can check specific published pages or leave all unchecked to display site-wide.

= Does the plugin slow down my website? =
Not at all. All scripts are lightweight, audio tracks are bundled locally with no external API lag, the snowfall animation uses optimized hardware-accelerated Canvas rendering, and Christmas Lights are pure CSS — zero JavaScript overhead.

= What are the Christmas Lights styles? =
Choose from 5 bulb styles: Classic, C9 (Large), Round (Globe), Star-Shaped, and Icicle Drops. Each comes with 5 color themes.

= Will the cursor trail work on mobile? =
The cursor trail is automatically hidden on touch devices since there's no mouse cursor. All other effects respect the "Disable on Mobile" setting.

== Screenshots ==

1. **Santa Pop-Up Settings:** Select from 21 Santa styles with corner or flying animations.
2. **Christmas Lights:** Animated string lights with multiple bulb styles and colors.
3. **Cursor Trail:** Snowflake, star, and sparkle trails following the mouse.
4. **Sleigh Fly-Across:** Santa's sleigh soaring across the viewport.
5. **Music Player:** Sleek glassmorphism floating player with holiday tracks.
6. **Snowfall Effect:** Customizable snowflake intensity and colors.
7. **Confetti Burst:** Celebration confetti explosion on first visit.
8. **Announcement Bar:** Holiday greeting ribbon with custom action link.
9. **Countdown Badges:** 5 festive countdown badge designs (shortcode + Gutenberg block).
10. **Live Admin Preview:** Real-time preview inside WordPress settings.

== Changelog ==

= 1.2.0 =
* **Feature:** Added Christmas Lights / Fairy Lights with 5 bulb styles (Classic, C9, Round, Star, Icicle) and 5 color schemes.
* **Feature:** Added Festive Cursor Trail with Snowflakes, Stars, and Sparkles particle styles.
* **Feature:** Added Santa Sleigh Fly-Across animation with configurable speed, direction, and frequency.
* **Feature:** Added Confetti Celebration Burst that fires once per visitor session.
* **Feature:** Added native Gutenberg block for the Christmas Countdown timer.
* **Performance:** Removed all jQuery dependencies — now 100% lightweight Vanilla JavaScript with zero external library overhead.
* **Performance:** Optimized CSS assets, trimming unused animate.css keyframes for an 81% file size reduction.
* **Architecture:** Modularized admin settings architecture into dedicated settings and fields classes.
* **Enhancement:** 4 new admin settings tabs for granular control of each new effect.
* **Enhancement:** Centralized holiday date calculations and automated legacy option key migration.
* **Enhancement:** Updated plugin description and metadata for better discoverability.

= 1.1.0 =
* **Feature:** Added realistic 60fps HTML5 Canvas Snowfall effect with intensity and color settings.
* **Feature:** Added sticky Holiday Announcement / Promo Greeting Bar.
* **Feature:** Added Mobile device display controls.
* **Feature:** Added Interactive Live Preview to the WordPress Admin settings.
* **Modernization:** Bundled royalty-free festive holiday chime audio tracks locally to eliminate external server dependencies.
* **Fix:** Resolved fatal error risk with undefined logging function.
* **Fix:** Fixed frontend audio player DOM selectors, progress bar scrubbing, and removed debug alert.
* **Fix:** Fixed countdown calculation after December 25th and added timezone-aware date handling.
* **Fix:** Added complete database cleanup routine on plugin uninstallation.
* **Compatibility:** Tested and validated with WordPress 6.7 and PHP 8.1, 8.2, 8.3.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.2.0 =
Major update featuring Christmas Lights, Cursor Trail, Santa Sleigh Fly-Across, Confetti Burst, and Gutenberg Countdown block.