=== W Auto Page Pre Loader ===
Contributors: adnanhyder
Tags: preloader, page loader, loading screen, animation, loading, wordpress preloader
Requires at least: 6.0
Tested up to: 6.8.1
Requires PHP: 8.0
Stable tag: 3.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

W Auto Page Pre Loader adds a smooth loading screen before your website content appears. It improves perceived speed, enhances user experience, and lets you display custom visuals while the page loads.

== Description ==

W Auto Page Pre Loader shows a clean loading animation or your custom image before the page becomes visible. This prevents the blank-screen moment users often experience during load time. The plugin is lightweight, responsive, and works with all modern WordPress themes.

You can customize the loader image, size, duration, background color or background image, and preview everything directly from the admin panel. The loader fades out smoothly once the page is ready, ensuring a polished experience on both desktop and mobile.

== Features ==

1. Simple enable or disable control.
2. Upload a custom logo or loader image.
3. Adjustable loader width and height.
4. Duration control for fade-out timing.
5. Background color and background image support.
6. Background size and position settings.
7. Smooth fade-out animation.
8. Responsive design for all devices.
9. Live preview in settings.
10. Option to hide the preloader for logged-in users.
11. Show the preloader only once per browser session.
12. Option to hide the preloader on mobile devices.
13. Display delay setting to prevent flashing on fast-loading pages.
14. Exclude selected URL paths from the preloader.
15. Respect reduced-motion visitor preferences.
16. Customize spinner color, overlay opacity, fade duration, and z-index.
17. Lock scrolling while active, expose ARIA status, and allow Escape-key dismissal.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install using the Plugins menu in WordPress.
2. Activate the plugin.
3. Open “W Auto Page Pre Loader” in your dashboard to configure settings.

== Frequently Asked Questions ==

= Can I hide the preloader on specific pages? =
The current version works site-wide. Page-level control may be added in future versions.

= Can I disable the preloader for admins or members while keeping it for visitors? =
Yes. Enable the "Hide For Logged-in Users" option in the plugin settings to skip the preloader for any signed-in user.

= Can I show the preloader only once per visit? =
Yes. Enable "Show Once Per Session" to show it once during the visitor's browser session.

= Can I skip the preloader on mobile? =
Yes. Enable "Hide On Mobile" to keep mobile browsing faster.

= What happens if both background color and background image are enabled? =
The background image becomes the primary background. The color is ignored when an image is selected.

= Does this slow down the site? =
No. The plugin uses optimized CSS and JavaScript and removes itself as soon as the page is ready.

== Screenshots ==

1. Settings panel with live preview.
2. Loader with custom logo.
3. Loader with background image.
4. Fade-out effect after loading.

== Changelog ==

= 3.1.0 =
* Added active body class for better scroll control while preloader is visible.
* Added Escape key support so visitors can dismiss the preloader quickly.
* Added ARIA status attributes for better assistive technology behavior.
* Improved frontend cleanup after the fade-out completes.

= 3.0.0 =
* Added URL path exclusions.
* Added reduced-motion bypass support.
* Added spinner color control.
* Added overlay opacity control.
* Added fade duration control.
* Added z-index control.

= 2.2.0 =
* Added show once per session control.
* Added hide on mobile control.
* Added display delay control to prevent quick loader flashes.
* Updated WordPress.org banner artwork for the release.

= 2.1.0 =
* Added a setting to hide the preloader for logged-in users.
* Fixed automatic fade-out when duration is set to 0.
* Updated internal plugin versioning.

= 2.0.0 =
* New settings layout.
* Improved fade-out timing.
* Cleaner animation performance.
* Updated branding.

= 2.0.2 =
* Refactor

= 1.0.3 =
* Minor bug fix.

= 1.0.2 =
* Auto duration feature added.

= 1.0.0 =
* Initial release.
