=== Host5 Fluid Splash Cursor ===
Tags: cursor, animation, webgl, rainbow, splash
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 2.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Adds a premium, fully-tunable rainbow WebGL "fluid splash" cursor trail to your site with vanilla JS only, zero framework dependencies.

== Description ==

Host5 Fluid Splash Cursor adds a full-screen, click-through canvas that renders a WebGL fluid simulation following the visitor's mouse (or finger, on touch devices), producing a colorful "splash/paint" trail. It's a vanilla-JS engine (no React, Vue, or jQuery — pure ES6 + Canvas/WebGL) wrapped in a proper WordPress plugin with a modern, mobile-friendly admin experience.

**Features:**

* Toggle switches and sliders for every setting — modern, touch-friendly admin UI
* Rainbow mode, or a single custom solid color via native color picker
* Full tuning controls: curl, splat radius/force, dissipation rates, pressure iterations, color update speed
* Performance controls: simulation/dye resolution, disable on mobile, disable in wp-admin
* Live Preview panel — test unsaved settings directly inside wp-admin before applying them
* Environment & Performance Matrix: live Plugin/WP/PHP versions plus an on-demand render benchmark
* One-click JSON backup and validated JSON import/restore
* Reset to Defaults with confirmation
* Zero external frameworks; strict `scwp_` / `SCWP_` prefixing for zero plugin/theme conflicts

== Installation ==

1. Upload the `host5-fluid-splash-cursor` folder to `/wp-content/plugins/`, or upload the zip directly via Plugins → Add New → Upload Plugin.
2. Activate the plugin through the "Plugins" menu in WordPress.
3. Go to **Settings → Splash Cursor** to enable, tune, and preview the effect.

Upgrading from v1 ("Splash Cursor for WP")? Deactivate and delete the old plugin first (this is a renamed main file/slug), then install v2 fresh. From v2.0.0 onward, future updates can be uploaded directly over this folder without losing your settings.

== Frequently Asked Questions ==

= The effect feels heavy on my site =

Lower "Simulation Resolution" and "Dye Resolution" under the Performance tab, and enable "Disable on Mobile". Use the built-in benchmark on the dashboard to gauge render performance first.

= Will updating the plugin reset my settings? =

No. Activation preserves any existing `scwp_settings` and only merges in newly introduced default keys. Settings are only ever fully removed if you explicitly click "Delete" on the Plugins page.

= Can I back up my configuration before making changes? =

Yes — use "Download Backup" on the Backup & Restore tab any time. To restore, paste the JSON into the Import box; it's validated (types, ranges, hex colors) before being applied to the form.

== Changelog ==

= 2.2.0 =
* Fixed: In v2.1.0, The plugin name includes a restricted term. The "Short Description" section is too long and was truncated. A maximum of 150 characters is supported.

= 2.1.0 =
* Fixed: Save Settings and Reset to Defaults now work correctly (v2.0.0 had an invalid nested-form bug that redirected to the raw wp-admin/options.php warning page instead of saving).
* Layout overhaul: Environment & Performance Matrix now on the left, Live Preview on the right; settings tabs are now a vertical sidebar on the left.
* Sliders are now ~2x wider with a fixed-position value display.
* Rainbow Mode now automatically disables the Solid Color picker when on, and re-enables it when off.
* Full premium visual redesign for 2026: refined dark palette, glassmorphism, gradient buttons, improved readability.
* See CHANGELOG.md for full details.

= 2.0.0 =
* Full admin UI rebuild: tabs, toggle switches, sliders, bubble toast notifications, mobile/touch-friendly layout.
* Live Preview panel to test settings inside wp-admin before saving.
* Environment & Performance Matrix dashboard card with on-demand render benchmark.
* JSON backup/export and validated JSON import/restore.
* Reset to Defaults with confirmation.
* Renamed all internals to the `scwp_` / `SCWP_` prefix for zero-conflict guarantees.
* Removed the jQuery-based color picker in favor of the native HTML5 color input (no external frameworks anywhere in the plugin).
* See CHANGELOG.md for full details.

= 1.0.0 =
* Initial release.

== Support ==

For support, contact hardik@host5.in.
