=== Cursor Image Lite ===
Contributors: dessbesell
Tags: cursor, custom cursor, pointer, png cursor, customization
Requires at least: 5.0
Tested up to: 6.8
Stable tag: 1.0.3
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Donate link: https://buymeacoffee.com/fdessbesell

Easily replace the default mouse cursor with your own custom PNG images. A lightweight and simple custom cursor plugin for WordPress.

== Description ==

Cursor Image Lite is a lightweight and beginner-friendly plugin that allows you to replace the default mouse cursor on your WordPress site with a custom PNG cursor image. It works with any theme and requires no coding knowledge.

This plugin is ideal for websites that want a unique visual experience, such as portfolios, creative blogs, design studios, landing pages, gaming sites, and personal projects.

**You can customize:**
- A primary PNG cursor image  
- An optional hover-state PNG image (shown on links, buttons, etc.)  
- Custom cursor sizes using pixel-based controls for each image 

Cursor Image Lite provides a simple way to personalize the look and feel of your website by using custom mouse pointers.

=== Features ===

- Set a custom mouse cursor image (PNG)
- Optional hover-state cursor image
- Compatible with all major browsers
- Works with any WordPress theme
- Lightweight — minimal performance impact
- No coding required
- Automatic fallback to the native cursor
- Clean and simple settings page

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/cursor-image-lite` or install directly through the WordPress Plugins page.
2. Activate the plugin through the “Plugins” menu in WordPress.
3. Go to **Settings → Cursor Image Lite**.
4. Upload your PNG cursor image and optional hover image.
5. Save your settings.
6. Your custom cursor will be applied immediately.

== Frequently Asked Questions ==

= What image formats are supported? =
The plugin currently supports only PNG images. Transparent PNGs are recommended for best results.

= Does the plugin work on mobile devices? =
Most mobile browsers do not display custom cursors. In these cases, the system’s default cursor or touch behavior will be used.

= What happens if I remove all images? =
The browser will automatically revert to the default cursor.  
This issue was improved in version 1.0.1.

= Does it work with page builders? =
Yes. The plugin works with all major page builders because it applies cursor styles globally.

== Screenshots ==

1. Settings screen with upload fields for the primary and hover PNG cursor images.
2. Settings screen after selecting both cursor images, showing how the custom PNG files appear when configured.
3. Front-end preview demonstrating the custom cursor in action on a live website.

== Changelog ==

= 1.0.1 =
* Fixed: native cursor not appearing when no images were selected.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.1 =
This update fixes a fallback cursor issue. It is recommended for all users.