⚡ Y Loader - A Stunning Preloader for WordPress

Add elegant loading animations to WordPress sites with full customization. Lightweight & easy to use!

Features • Demo • Installation • Usage • FAQ • Contributing

---

✨ Features

Feature	Description
🎨 3 Loader Types	CSS animations (Spinner/Dots/Pulse), custom GIFs, or text-based
🎛️ Live Customizer	Real-time preview in WordPress admin
🏎️ 0.2s Load Time	Optimized vanilla JS (No jQuery bloat)
🖌️ Color Picker	HEX/RGB controls for background & loader
📱 Mobile Optimized	Perfectly scales on all devices

---

🎥 Demo

---

📥 Installation

Method 1: WordPress Admin

1. Navigate to Plugins → Add New
2. Search "Y Loader"
3. Install & Activate

Method 2: Manual Upload

1. Download latest .zip from GitHub Releases
2. Go to Plugins → Add New → Upload Plugin
3. Select file and activate

---

🛠️ Usage

Basic Configuration

1. Go to Settings → Y Loader
2. Choose loader type:
   • 🌀 CSS Animation (select style/color)
   • 🖼️ Custom Image (upload GIF/SVG)
   • 🔤 Text Only (enter message)
3. Set background color
4. Save changes

Advanced Customization

/* Add to theme's additional CSS */
.y-loader {
  --animation-speed: 1.5s; /* Change speed */
  --bg-opacity: 0.9; /* Overlay transparency */
}

---

❓ FAQ

Will this work with caching plugins?

✅ Yes! Compatible with WP Rocket, W3 Total Cache, etc.

Can I exclude specific pages?

// Add to functions.php
add_filter('y_loader_display', function($show) {
  return !is_page('contact'); // Hide on contact page
});

How to uninstall?

1. Deactivate plugin
2. Delete via WordPress plugins list
3. (Optional) Remove y-loader entry from wp_options table

---

🤝 Contributing

# Development setup
git clone https://github.com/yaratul/y-loader.git
cd y-loader
npm install
npm run build

Workflow:

1. Fork the repository
2. Create a feature branch (git checkout -b feat/amazing-feature)
3. Commit changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feat/amazing-feature)
5. Open a PR

---

📜 License

GPL-2.0 © YA Ratul

```