=== DWL Preloader ===
Contributors:      yeasin62
Tags:              preloader, loading screen, page loader, animated preloader, svg preloader
Requires at least: 5.0
Tested up to:      6.9
Stable tag:        3.0
Requires PHP:      7.2
License:           GPLv2 or later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

A beautiful animated preloader plugin for WordPress. Choose from 10 stunning SVG preloader styles with a live preview admin panel.

== Description ==

**DWL Preloader** displays an animated loading screen while your WordPress site loads. It comes with **10 unique SVG-based preloader animations** that you can preview and select directly from the WordPress admin panel.

Whether you want a sleek spinner, bouncing dots, a heartbeat line, or a morphing blob — DWL Preloader has something for every website style.

= ✨ Key Features =

* **10 Unique Preloader Styles** — All built with pure SVG animations, no external libraries needed.
* **Live Preview in Admin** — Click any preloader style in the admin panel and see it animate in real time before saving.
* **Background Color Picker** — Choose any background color for the preloader overlay to match your brand.
* **Enable / Disable Toggle** — Instantly enable or disable the preloader from the settings panel without deactivating the plugin.
* **Lightweight & Fast** — Pure SVG animations with no dependencies. No GIF files, no heavy JavaScript.
* **Auto-dismiss** — The preloader fades out smoothly after the page finishes loading.
* **Theme Compatible** — Works with any WordPress theme. Supports `wp_body_open` hook with a `wp_footer` fallback for maximum compatibility.
* **No Shortcodes Needed** — Just install, activate, configure, and it works automatically on every page.
* **Settings Saved Instantly** — All settings are stored in the WordPress options table and applied site-wide.

= 🎨 Preloader Styles =

1. **Triple Ring** — Three concentric rings spinning in opposite directions with different speeds and colors.
2. **Bouncing Dots** — Four colorful dots bouncing in a rhythmic wave pattern.
3. **Ripple Pulse** — A pulsing dot with three expanding ripple rings that fade out.
4. **Wave Bars** — Five vertical bars animating like an audio equalizer wave.
5. **Orbit Dots** — Colored dots orbiting a central point like planets in a solar system.
6. **Rotating Square** — Nested squares rotating in opposite directions with a glowing center.
7. **Morphing Blob** — A fluid shape that continuously morphs and changes color.
8. **Heartbeat** — An animated ECG-style heartbeat line that draws itself repeatedly.
9. **Hexagon Spin** — Two hexagons rotating in opposite directions with a pulsing center.
10. **Spiral Galaxy** — Multiple dots orbiting at different radii and speeds, like a galaxy.

= 🛠 How It Works =

1. Install and activate the plugin.
2. Go to **DWL Preloader** in your WordPress admin menu.
3. Click on any preloader style card to preview it live.
4. Optionally pick a background color and toggle the preloader on or off.
5. Click **Save Settings** — your visitors will now see the selected preloader when they visit your site.

== Installation ==

1. Upload the `dwl-preloader` folder to the `/wp-content/plugins/` directory, or install via **Plugins → Add New** in WordPress.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Navigate to **DWL Preloader** in the admin sidebar.
4. Select your preferred preloader style and save.
5. Visit your website to see the preloader in action.

== Frequently Asked Questions ==

= Will this plugin slow down my website? =

No. DWL Preloader uses pure inline SVG animations — there are no external image requests or heavy libraries. The total plugin footprint is minimal.

= Can I use a custom background color? =

Yes. The settings panel includes a color picker that lets you choose any background color for the preloader overlay.

= Does it work with my theme? =

DWL Preloader is compatible with any properly coded WordPress theme. It uses the `wp_body_open` hook with a `wp_footer` fallback to ensure compatibility across all themes.

= Can I disable the preloader temporarily? =

Yes. Use the **Enable Preloader** toggle in the settings panel to turn it on or off without deactivating the plugin.

= Does it work with page builders like Elementor or Gutenberg? =

Yes. The preloader runs at the page level and is independent of any page builder.

== Screenshots ==

1. Admin settings panel showing all 10 preloader styles with live preview.
2. Background color picker and enable/disable toggle in the sidebar.
3. Example of the Triple Ring preloader on a live website.
4. Example of the Wave Bars preloader on a live website.

== Changelog ==

= 3.0 =
* Complete plugin rewrite with a modern admin interface.
* Added 10 unique SVG-based animated preloader styles.
* Added live preview: clicking a style instantly previews it in the sidebar.
* Added background color picker for the preloader overlay.
* Added enable/disable toggle — no need to deactivate the plugin.
* Replaced deprecated `jQuery(window).load()` with `jQuery(window).on('load')`.
* Added `wp_body_open` hook support with `wp_footer` fallback.
* Added activation hook to set default plugin options.
* Improved code structure following WordPress coding standards.
* All output is properly escaped.

= 2.0 =
* Initial public release with single spinning ring preloader.

== Upgrade Notice ==

= 3.0 =
Major update — adds 10 preloader styles, live preview admin panel, background color picker, and enable/disable toggle.