=== BeforeSunrise Realistic Fireworks ===
Contributors: shoto1105
Tags: fireworks, new year, animation, canvas, effects
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Realistic, performance-aware fireworks for New Year, events and celebrations without blocking your website.

== Description ==

BeforeSunrise Realistic Fireworks places a click-through canvas above your existing website and creates a different, naturally paced fireworks show on every visit. It is not a fixed video or repeating animation.

The free plugin includes:

* four carefully selected fireworks effects: Chrysanthemum, Ring, Palm and Crackling
* a curated random composition without immediate repetitions
* a balanced, realistic show with slightly extended afterglow
* automatic effect colors
* automatic performance adjustment and fixed particle pools
* an annual date range that can cross New Year's Day
* daily time windows, including overnight windows
* display on the entire website or only the homepage
* optional website dimming that remains click-through
* reduced-motion support
* an interactive preview in the WordPress backend
* translation-ready English source text for WordPress.org language packs

The show is disabled after installation. Enable it only after checking the preview and schedule.

No external JavaScript, fonts, audio, tracking or third-party service is loaded. The canvas uses `pointer-events: none`, so links, forms and menus underneath remain usable.

= BeforeSunrise Realistic Fireworks Pro =

The separately installed Pro add-on expands the show to all ten effects. It also adds custom timing and intensity, individual effect weights, colorful and custom palettes, selected pages, one-time date ranges, weekday rules, manual performance and mobile controls, and optional visitor-controlled sound.

The free plugin remains fully usable without Pro. Premium code is not included in this WordPress.org package.

Learn more at https://www.beforesunrise.de/realistic-fireworks/

== Installation ==

1. Install BeforeSunrise Realistic Fireworks from Plugins > Add New.
2. Activate the plugin.
3. Open Fireworks in the main WordPress admin menu.
4. Configure and preview the show.
5. Enable the fireworks and save the settings.

== Frequently Asked Questions ==

= Can the yearly schedule cross New Year's Day? =

Yes. A period such as 12-20 through 01-02 is handled as one continuous annual window.

= Can a daily window cross midnight? =

Yes. A daily window from 22:00 through 02:00 is supported.

= Does the plugin work with page caches? =

Yes. The small frontend controller evaluates the schedule in the browser using the WordPress timezone. The larger fireworks engine is loaded only while the schedule is active.

= Does the canvas block the website? =

No. The canvas and optional dimming layer are click-through.

= Does the free plugin contact external services? =

No. It does not load external resources, collect personal data, create cookies or contact third-party services.

= What does Pro add? =

Pro adds six more effects for a total of ten, detailed creative controls, selected-page targeting, advanced scheduling and optional sound. It is distributed as a separate add-on and is not required for the free show.

== Screenshots ==

1. A realistic fireworks show above an existing website.
2. Display and annual schedule settings.
3. The curated show and its four included effects.
4. Interactive preview in the WordPress backend.

== Privacy ==

The free plugin does not collect personal data, create cookies or contact external services.

== Changelog ==

= 1.0.1 =

* Fixed the free backend show preview so it always uses the four included effects.
* Prevented the Pro-only effect-selection warning from appearing in the free preview.
* Refreshed the admin asset version to avoid stale preview scripts after updating.

= 1.0.0 =

* First public release.
* Added four carefully selected fireworks effects and a curated random show.
* Added annual and daily scheduling, homepage targeting and optional dimming.
* Added automatic performance adjustment, reduced-motion support and backend preview.
* Added translation-ready interface text for WordPress.org language packs.
* Corrected the WordPress.org contributor attribution and removed bundled translation files in favor of WordPress.org language packs.

== Upgrade Notice ==

= 1.0.1 =

Fixes the backend show preview in the free plugin.

= 1.0.0 =

First public release.
