=== Rs Christmas Santa – Snowfall, Christmas Lights, Holiday Music, Flying Sleigh & Countdown === Contributors: therssoftware Tags: christmas, snowfall, christmas lights, holiday music, christmas countdown 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 holidays with falling snow, Christmas lights, holiday music, flying Santa sleigh, countdown timers, confetti bursts, and 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. --- ### 👑 Premium Features (Rs Christmas Santa Pro) Need advanced holiday e-commerce conversion power and custom branding? **Rs Christmas Santa Pro** unlocks: * 🎁 **Floating Holiday Gift Box Pop-Up:** An animated bouncing gift box that visitors can click to reveal an exclusive WooCommerce discount code with confetti and 1-click clipboard copy. * 🎅 **Custom Brand Mascot Uploader:** Upload your company mascot, branded character, or custom avatar (.png, .webp, .svg) to fly across the screen instead of the stock Santa. * 🎵 **Custom Holiday Soundtrack MP3 Uploader:** Upload your own branded audio jingles directly through the WordPress Media Library. * 🛷 **Parachute Gift Drops:** Santa's flying sleigh drops mystery holiday gift packages as he flies across the sky! * 🛑 **Exit-Intent Holiday Retention Modal:** Detects abandoning shoppers and presents a festive last-chance discount to recover lost sales. * 🛒 **WooCommerce Checkout Protection:** Automatically suppresses all floating animations and pop-ups on Cart and Checkout pages to maximize sales conversions. [Learn more about Rs Christmas Santa Pro & Pricing](https://wp.therssoftware.com/plugins/rs-christmas-santa/) --- == 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 & 21 Avatar Styles:** Select from 21 Santa styles with corner placement or continuous flying animations. 2. **Christmas Fairy Lights:** Animated glowing string lights along the top of your site with 5 bulb styles and 5 color schemes. 3. **Santa Sleigh Fly-Across & Cursor Trail:** Santa's reindeer sleigh soars across the viewport with particle mouse trails. 4. **Holiday Background Music & Snowfall:** Sleek floating glassmorphism player with 4 bundled holiday chimes and 60fps canvas snow. 5. **Christmas Countdown Gutenberg Block & Badges:** 5 festive countdown badge designs with native block editor support. 6. **Intuitive Admin Settings & Live Preview:** Granular tabbed settings with real-time interactive preview. == 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.