=== Rs Christmas Trees ===
Contributors: therssoftware
Donate link: https://therssoftware.com/
Tags: christmas, christmas trees, falling snow, holiday decorations, winter
Requires at least: 6.0
Tested up to: 7.1
Stable tag: 1.1.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Add festive holiday Christmas tree banners, beautiful garlands, and smooth animated falling snow to your WordPress site.

== Description ==

Bring the holiday spirit and festive winter cheer to your WordPress website with **Rs Christmas Trees**!

Decorate your site with customizable header and footer Christmas tree garlands, holiday banners, and a silky-smooth falling snow effect powered by pure Vanilla JavaScript Canvas with zero jQuery dependencies.

### 🎄 Key Features

* **25 Top Tree & Garland Designs:** Choose from 25 handcrafted holiday header banners featuring Christmas trees, pine cones, golden bells, winter ribbons, and sparkling ornaments.
* **23 Bottom & Footer Borders:** Add winter wonderland borders and tree grounds across the bottom of your pages.
* **Pure Vanilla JS Canvas Snow Engine:** Lightweight, high-performance HTML5 Canvas snow that runs at 60fps with zero jQuery overhead.
* **Non-Intrusive Banner Architecture:** Banners use modern CSS pointer-events so your website navigation menus, search bars, and buttons remain 100% clickable.
* **Dismissible Close Button:** Optional festive close button allowing visitors to dismiss decorations.
* **Sticky & Absolute Positioning:** Choose whether decorations stay fixed as users scroll or scroll naturally with the page.
* **Customizable Snowflakes:** Define snowflake shapes (classic flakes, stars, soft dots), colors, falling speed, and size ranges.
* **Target Specific Pages:** Enable holiday decorations site-wide or restrict them to specific festive landing pages or posts.
* **Native Gutenberg Block:** Insert Christmas tree garlands directly into any page, post, or block theme template part.
* **Performance & Accessibility Friendly:** Snow automatically pauses when the browser tab is hidden to save battery, and respects user motion preferences.
* **Multi-Language Ready:** Fully internationalized with translations for Spanish, German, French, Italian, and Portuguese.

== Installation ==

1. In your WordPress admin, navigate to **Plugins > Add New**.
2. Search for `Rs Christmas Trees`.
3. Click **Install Now** and then **Activate**.
4. Navigate to **Christmas Trees** in your admin menu to customize your holiday banners and snow settings.

== Frequently Asked Questions ==

= Will the banners block clicks on my navigation menu? =
No. Rs Christmas Trees uses `pointer-events: none` on the decoration overlays, ensuring visitors can click all header menus, carts, and buttons without obstruction.

= Does the snowfall effect require jQuery? =
No. The default snow engine is written in pure Vanilla JavaScript utilizing HTML5 Canvas, providing maximum speed and compatibility with any theme or plugin.

= Can I display decorations on only specific pages? =
Yes. In the plugin settings, you can check specific published pages where you want the holiday decorations and snow to appear.

= Can visitors close or hide the banners? =
Yes. You can enable the "Close / Hide Button" setting, which adds an accessible dismissal button to the banner.

== Screenshots ==

1. Christmas Tree Banners catalog with 25 header and 23 footer designs.
2. Animated Falling Snow settings with live color picker and snowflake shape options.
3. Live festive website preview with top garland and gentle snowfall.
4. Native Gutenberg Block in the WordPress block editor.
5. Responsive mobile view with seamless scaling.
6. Target specific pages and customizable sticky positioning.

== Changelog ==

= 1.1.0 =
* Overhauled snow engine with high-performance pure Vanilla JavaScript Canvas (removed jQuery dependencies and 404 script bugs).
* Fixed critical HTML validation issue by moving decoration rendering from `wp_head` to `wp_body_open` / `wp_footer`.
* Fixed banner click-blocking by applying modern `pointer-events: none` and accessible close buttons.
* Fixed non-sticky positioning bug (`position: absolute`).
* Improved responsive background sizing and smooth repeating on high-resolution widescreen monitors.
* Modernized admin settings interface with responsive card selector grids.
* Added native Gutenberg block (`blocks/christmas-tree`).
* Added translations for Spanish (es_ES), German (de_DE), French (fr_FR), Italian (it_IT), and Portuguese (pt_BR).
* Updated compatibility for WordPress 7.1 and PHP 7.4 - 8.4+.

= 1.0.1 =
* Fixed banner position and repeat issues.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.1.0 =
Major modernization release with Vanilla JS Canvas snow, Gutenberg block support, non-blocking click architecture, and full WordPress 7.1 compatibility.