=== Smooth Custom Cursor ===
Contributors: himanshu
Tags: cursor, custom cursor, mouse, animation, smooth cursor
Requires at least: 5.8
Tested up to: 6.5
Requires PHP: 7.4
Stable tag: 2.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Adds a smooth, animated custom cursor with magnetic hover effects, customizable color and size — no coding needed.

== Description ==

**Smooth Custom Cursor** replaces the default browser cursor with a beautiful animated dot + ring cursor effect. Fully customizable from the WordPress admin panel.

**Features:**

* Smooth lagging ring animation using requestAnimationFrame
* Magnetic scale effect on hover over links and buttons
* Customizable cursor color (color picker)
* Customizable cursor size
* Option to disable on mobile/touch devices
* Hides cursor when mouse leaves the browser window
* Zero dependencies — pure vanilla JavaScript
* Lightweight and performance-optimized

== Installation ==

1. Upload the `smooth-custom-cursor` folder to the `/wp-content/plugins/` directory, or install directly via **Plugins → Add New** in WordPress admin.
2. Activate the plugin through the **Plugins** menu.
3. Go to **Settings → Cursor Ultimate** to configure the cursor color, size, and mobile behavior.

== Frequently Asked Questions ==

= Does it work with all themes? =
Yes. The plugin injects the cursor elements via `wp_footer` and loads styles/scripts on all frontend pages.

= Can I disable it on mobile? =
Yes. In **Settings → Cursor Ultimate**, check the "Disable on Mobile" option.

= Why does my default cursor still show? =
Make sure no other plugin or theme CSS is overriding `cursor: none`. The plugin sets `cursor: none !important` on all elements.

= What WordPress version is required? =
WordPress 5.8 or higher.

== Screenshots ==

1. Admin settings panel — color picker, size, and mobile toggle.
2. Cursor in action on the frontend — dot and ring effect.

== Changelog ==

= 2.1 =
* Fixed: Correct asset paths for CSS and JS files
* Fixed: Admin settings include path corrected
* Fixed: JS variable name aligned with wp_localize_script output
* Fixed: Cursor HTML elements now injected via wp_footer hook
* Fixed: CSS variables now output via wp_head hook
* Fixed: disableMobile option now correctly passed to JavaScript
* Security: Added nonce verification to settings form (CSRF protection)
* Security: Added capability check in settings page function
* Improved: Cursor hides when mouse leaves the browser window
* Improved: Input validation with min/max for size field

= 2.0 =
* Initial release.

== Upgrade Notice ==

= 2.1 =
Critical bug fixes — please update immediately. The cursor will not display correctly on version 2.0.
