=== CursorFlex – Stylish Cursor Effects for WordPress ===
Contributors: wpjutsu
Tags: cursor, custom cursor, mouse cursor, pointer, cursor effects
Requires at least: 6.0
Tested up to: 7.0
Stable tag: 1.0.0
Requires PHP: 8.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
 
Swap the boring default pointer for a stylish custom cursor — dot, ring or both. Full color control, live preview, zero code.
 
== Description ==
 
**Every visitor moves their cursor on every page — so why leave it boring?**
 
CursorFlex swaps the default browser pointer for a sleek, modern custom cursor that makes your WordPress site feel *designed* rather than default. Pick a style, fine-tune the colors and size, and watch it update live before you save — all from a clean settings page, with no coding required.
 
[Try the live demo →](https://www.wp-jutsu.com/plugins/cursorflex/)
 
A custom cursor is one of those small details that quietly signals quality. CursorFlex makes it effortless, lightweight, and safe for every theme.
 
= Free features =
 
* **Three cursor styles** — Dot, Ring, or both combined
* **Individual color control** for the dot and the ring
* **Size slider** for the dot and the ring
* **Ring border width** control
* **Hide the native browser cursor** for a seamless, immersive look
* **Live preview** right in the settings page — no page reload needed
* Smooth eased ring-follow animation (requestAnimationFrame)
* Lightweight — no jQuery, no bloat
 
= Pro features =
 
Ready for more? **CursorFlex Pro** unlocks the effects that turn a custom cursor into a signature:
 
* **Cursor animations** — trailing effects and more
* **Upload your own** SVG or image as the cursor
* **Per-page & per-category** cursor configuration
* **Click effects** — ripple, burst, particles
 
[Upgrade to CursorFlex Pro →](https://www.wp-jutsu.com/plugins/cursorflex/)
 
== Installation ==
 
1. Upload the `jutsu-cursor-effects` folder to `/wp-content/plugins/`.
2. Activate the plugin through **Plugins → Installed Plugins**.
3. Go to **CursorFlex** in your admin menu and configure your cursor.
 
== Frequently Asked Questions ==
 
= Does it work with all themes? =
Yes. The plugin inserts the cursor elements into the page footer and applies global CSS, so it works regardless of the active theme.
 
= Does it affect mobile visitors? =
CSS cursors have no effect on touch-screen devices. The plugin outputs no JavaScript on mobile (touch events are ignored), so there is zero impact on mobile performance.
 
= Will it slow down my site? =
The plugin adds one CSS file and one JavaScript file. The impact on page load time is negligible.
 
= Can I use my own image or SVG as the cursor? =
Uploading a custom image or SVG cursor is a CursorFlex Pro feature, along with cursor animations, click effects, and per-page configuration. The free version includes the Dot, Ring, and combined styles with full color and size control.
 
= How do I remove the plugin data after uninstalling? =
The plugin removes all stored options automatically when you uninstall it through the WordPress admin.
 
== Screenshots ==
 
1. Choose your Cursor 
2. Customize colors and width
3. Change hover settings
4. Save your cursor, show or hide default cursor and enjoy !
 
== Changelog ==
 
= 1.0.0 – jun 03, 2026 =
* First release of CursorFlex!