# Advanced Preloader - WordPress Plugin

![Plugin Banner](assets/banner.png)

A highly customizable preloader plugin for WordPress that helps improve user experience by displaying beautiful loading animations while your site content loads.

**Contributors:** Sanju Shankar  
**Tags:** preloader, loading, animation, UX, performance  
**Requires at least:** WordPress 5.0  
**Tested up to:** WordPress 6.8.2  
**Stable tag:** 1.3.2  
**License:** GPLv2 or later  
**License URI:** https://www.gnu.org/licenses/gpl-2.0.html

## Description

The Advanced Preloader plugin is a powerful yet simple solution for adding professional loading animations to your WordPress website. Designed with both simplicity and flexibility in mind, this plugin offers a wide range of customization options to match your site's design and branding.

### Key Features

🎨 **Multiple Display Options:**
- Choose between Image, Text, or Both
- Four layout options: Image Over Text, Image Left to Text, Image Right to Text, Image Below Text

🌈 **Customizable Design:**
- Background and text color customization
- Upload your own preloader image
- Add custom HTML text with multiple lines
- Random text line display option

⚡ **Performance Optimization:**
- Lightweight and fast loading
- CSS animations for smooth performance
- Customizable animation speed
- Delay time configuration

💻 **Responsive Preview:**
- Live preview in admin panel
- Laptop-style responsive preview window
- Real-time updates as you customize

🎛️ **Advanced Controls:**
- Enable/disable preloader with one click
- Media uploader integration
- Color picker for easy color selection

## Installation

1. Upload the plugin files to the `/wp-content/plugins/advanced-preloader` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Go to Settings → Advanced Preloader to configure the plugin
4. Customize your preloader settings and enjoy!

## Frequently Asked Questions

### Can I use my own image for the preloader?
Yes! The plugin includes a media uploader where you can upload and use your custom preloader image.

### Is this plugin mobile-friendly?
Absolutely! The preloader is fully responsive and works perfectly on all devices.

### Can I add HTML content in the text area?
Yes, the text field supports basic HTML tags for formatting your preloader text.

### How do I change the animation speed?
You can adjust the animation speed in the Animation Settings tab of the plugin.

### Can I use different text each time the preloader appears?
Yes! Enable the "Random Line" display mode to show a different line from your text content each time.

## Screenshots

1. General Settings Screen
2. Design Customization Options
3. Animation Settings
4. Live Preview in Admin Panel

## Changelog

### 1.3.2
- Added WordPress 6.8.1 support

### 1.3.1
- Fixed Security bugs

### 1.3
- Improved UX

### 1.2
- Added random text line display mode
- Improved responsive preview system
- Enhanced admin interface
- Fixed tab navigation issues
- Added more layout options

### 1.1
- Added custom CSS field
- Improved media uploader integration
- Fixed color picker implementation
- Enhanced mobile responsiveness

### 1.0
- Initial release of Advanced Preloader

## Contributing

We welcome contributions from the WordPress community! If you'd like to contribute to this plugin, please:

1. Fork the repository
2. Create a feature branch
3. Make your improvements
4. Submit a pull request

Please follow WordPress coding standards and include documentation for any new features.

## Support

For support, feature requests, or bug reports, please:
- Open an issue on our GitHub repository
- Visit our support forum
- Contact us through our website

Let's make WordPress better together! 💪

## License

This plugin is licensed under the GPLv2 or later. This means you're free to use, modify, and distribute this software as long as you preserve the GPL license terms.

---

**Thank you for using Advanced Preloader!** If you enjoy this plugin, please consider leaving a review or contributing to its development. Your support helps us continue improving this plugin for the WordPress community.