=== AddonLogic Emoji Rain on Event ===
Contributors: snehalpancholi
Tags: emoji, animation, confetti, celebration, party effect
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPL-2.0+
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Trigger a delightful falling-emoji animation on page load, a button click, or any existing element click — fully configurable emoji, density, and duration.

== Description ==

AddonLogic Emoji Rain on Event adds a lightweight, CSS-animated emoji particle shower to any page. Perfect for celebration pages, special announcements, thank-you pages, and events.

**Features:**
* Three trigger modes: page load, shortcode-rendered button click, or any CSS selector click
* Fully configurable emoji set (comma-separated)
* Control particle count, fall duration, and emoji size range
* Shortcode `[emoji_rain]` with per-instance attribute overrides
* Trigger an existing element by CSS selector without rendering a new button
* Zero jQuery, zero canvas — pure DOM + CSS `@keyframes` animation
* Self-cleaning: all particles removed from DOM after animation completes
* Configurable button colour, text colour, and label

== Installation ==

1. Upload the `emoji-rain-on-event` folder to `/wp-content/plugins/`.
2. Activate via **Plugins > Installed Plugins**.
3. Go to **Settings > Emoji Rain** to configure defaults.
4. Place `[emoji_rain]` in any post or page.

== Frequently Asked Questions ==

= Can I use a different set of emoji per page? =
Yes. Use the `emoji` attribute per shortcode: `[emoji_rain emoji="❤️,🌸,🦋"]`.

= Can I trigger the rain on an existing button already in my theme? =
Yes. Use `[emoji_rain trigger="selector" selector="#my-existing-button"]`. This shortcode outputs no visible element — it just wires up the click listener on the target.

= Will multiple rains stack on top of each other? =
Yes. Each invocation creates its own overlay container. Stacking is intentional for layered effects; the containers clean themselves up independently.

= Does it affect page performance? =
Particles are lightweight `<span>` elements with CSS animations. They are appended to the DOM only while the animation runs, then removed. No canvas or WebGL is used.

== Screenshots ==

1. Emoji rain falling over a celebration page.
2. Settings page — emoji set, count, duration, trigger, and button styling.
3. Shortcode-rendered trigger button in the editor.

== Changelog ==

= 1.0.0 =
* Initial release.
