Init FX Engine – Interactive, Event-Driven, Lightweight

Init FX Engine brings modern, interactive visual effects to your WordPress site — from fireworks to snowfall, emoji rain, and more. All effects are fully customizable, and can be triggered via keywords, shortcodes, Block Editor blocks, or special events.

🎉 Celebrate milestones with fireworks or cannon blasts
💬 Let users experience emoji reactions and heart rain in comments
❄️ Schedule snowfall automatically or set your own custom dates
🎃 Seasonal holiday scenes: Halloween, Christmas, New Year, Lunar New Year (Tết), Valentine, Mid-Autumn
🎆 Real fireworks show for New Year’s Eve and celebrations
⚙️ Lightweight, fully customizable engine with intuitive UI
🖤 Grayscale mode for solemn occasions or national mourning
⏳ Animated preloaders to enrich user experience

Not just an effect plugin — this is an FX Engine for WordPress.

This plugin is part of the Init Plugin Suite — a collection of minimalist, fast, and developer-focused tools for WordPress.

GitHub repository: https://github.com/brokensmile2103/init-fx-engine

What’s New in v2.0.1:
– Seasonal Effects: holiday scenes floating over your site — 🎃 Halloween bats & ghosts, 🎄 Christmas gifts, 🎉 New Year sparkles, 🌸 Tết (Lunar New Year) blossoms & lucky money, 💖 Valentine hearts, 🏮 Mid-Autumn lanterns rising into the sky
– Built-in holiday calendar: switches theme automatically, including Tết and the Mid-Autumn Festival computed from the Vietnamese lunar calendar (UTC+7)
– Themed greeting once per visit: a real fireworks show on New Year, lucky money rain on Tết, and more
– 5 new effects: Halloween Burst, Lucky Money (Tết), Fireworks Show, Snow Burst, Lantern Rise — usable with keywords, shortcodes and the FX Trigger block
– Faster frontend: lighter DOM scanning, cached effect shapes, lazy-loaded fireworks library

What’s New in v2.0.0:
– Block Editor (Gutenberg) support: a native FX Trigger block, grouped under its own Init FX Engine category in the block inserter. The block shares the exact same rendering code as its [initfxen-fx] shortcode counterpart, with a live preview right in the editor
– Requires at least raised from 5.5 to 6.9

Highlights:
– Native Block Editor block: FX Trigger — with live preview in the editor
– Interactive visual effects: Firework, Emoji Rain, Heart Rain, Cannon Blast, Starlight, Celebration Burst, Halloween Burst, Lucky Money, Fireworks Show, Snow Burst, Lantern Rise
– Seasonal Effects with a built-in holiday calendar (Halloween, Christmas, New Year, Tết, Valentine, Mid-Autumn), custom schedule or always-on mode
– Preloader (loading screen) with 6 styles: Dot Dot Dot, Bar, Logo, Flower, Spinner, Emoji
– Supports gradient or solid background for preloader
– Auto-fetch favicon for logo-based animation
– Snowfall effect with date scheduler (auto/custom)
– Grayscale mode (manual or scheduled)
– Shortcode [initfxen-fx-ambient] for ambient background animation
– Keywords to trigger effects inside comments or post content
– Real-time preview of effects in settings page
– Lightweight, extensible, and multilingual-ready

Block Editor (Gutenberg)

A native block is available under its own Init FX Engine category in the block inserter — no shortcode needed if you prefer working entirely in the editor:

• FX Trigger — equivalent to [initfxen-fx]. A link or button that fires a visual effect (fireworks, emoji rain, etc.) on click or hover

The block shares the exact same rendering code as its shortcode, so switching between the Block Editor and shortcode never changes the output. Block settings map directly to shortcode attributes, and a live preview is shown right in the editor as you configure it.

Note: the [initfxen-fx-ambient] shortcode does not have a block equivalent in this release — its rendering behavior wasn’t stable enough to bring into the Block Editor yet. The shortcode itself is unaffected and continues to work exactly as before.

Note: this plugin does not include Abilities API support. It has no data to read or write — everything it does is a purely visual, client-side effect — so there is nothing meaningful for an AI agent or automation tool to query here.

Seasonal Effects

Go to Settings → Init FX Engine → Seasonal Effects and tick Enable seasonal effects on site.

• Theme: pick a holiday, or leave it on Auto to follow the holiday calendar
• Built-in holiday calendar: Halloween (Oct 24–31), Christmas (Dec 20–26), New Year (Dec 30 – Jan 2), Tết (one week before Lunar New Year’s Day – the 7th day of the new year), Valentine (Feb 10–14), Mid-Autumn (one week before the 15th day of the 8th lunar month)
• Custom schedule or Always on (handy for testing on localhost)
• Custom emojis: replace the theme’s emojis with your own (up to 12)
• Greeting effect: plays once per browser session (e.g. a fireworks show on New Year)
• The Preview button plays the scene right in the settings page

Performance: the scene is drawn on a single canvas with pre-rendered emoji sprites, starts only after the page has finished loading, pauses when the tab is hidden, uses fewer particles on small screens and respects the visitor’s “reduce motion” setting.

Developers can customize themes and dates with the init_plugin_suite_fx_engine_seasonal_themes, init_plugin_suite_fx_engine_seasonal_window, init_plugin_suite_fx_engine_lunar_dates and init_plugin_suite_fx_engine_seasonal_config filters.

License

This plugin is licensed under the GPLv2 or later.
You are free to use, modify, and distribute it under the same license.

Credits

This plugin includes these open-source libraries:

• canvas-confetti — https://www.kirilv.com/canvas-confetti/
• particles.js — https://vincentgarreau.com/particles.js/
• fireworks-js 2.10.8 — https://github.com/crashmax-dev/fireworks-js (Copyright © 2021-2023 Vitalij Ryndin)

All are MIT licensed and bundled with the plugin.