=== Advanced Image Gallery for Elementor - Grid, Carousel & Slideshow ===
Contributors: zluck, divyeshk71, dipika25
Donate link: https://www.buymeacoffee.com/zluck
Tags: gallery, carousel, slideshow, elementor, responsive
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.3
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Create stunning, responsive image galleries and media carousels for Elementor with advanced customization and video support.

== Description ==

**Transform your Elementor website with the most powerful and flexible image gallery plugin available!** 

Advanced Image Gallery for Elementor is a premium-quality, free plugin that lets you create breathtaking media displays with zero coding required. Whether you need a simple image grid, an interactive carousel, or a professional slideshow, this plugin delivers exceptional results that will make your content stand out.

**🎨 Why Choose Advanced Image Gallery?**

* **6 Powerful Layouts** - Grid, Carousel, Slideshow, Masonry, Justified & Metro modes for every use case
* **Video Support** - Seamlessly integrate YouTube and Vimeo videos with custom play buttons
* **Mobile-First Design** - Perfectly responsive across all devices and screen sizes
* **Lightning Fast** - Optimized code with conditional loading for maximum performance
* **Elementor Native** - Built specifically for Elementor with full integration
* **Zero Learning Curve** - Drag, drop, and customize with intuitive controls

**🚀 Key Features:**

**Layout Options:**

* **Grid Gallery** - Clean, organized image grids with customizable columns (1-6)
* **Carousel Slider** - Smooth, touch-enabled carousels with navigation controls
* **Slideshow Mode** - Professional slideshows with thumbnail navigation
* **Masonry** – Dynamic, Pinterest-style layouts where images adjust seamlessly to fit the space
* **Justified** – Perfectly aligned rows of images for a balanced, professional gallery look
* **Metro** – Eye-catching, magazine-style layouts with varying image sizes for a modern appearance

**Customization & Control:**

* **Responsive Breakpoints** - Different settings for desktop, tablet, and mobile
* **Custom Navigation** - Arrows, dots, fraction, and progress bar pagination
* **Autoplay Controls** - Configurable speed, pause on hover, and interaction settings
* **Overlay Effects** - Text and icon overlays with 6 animation types
* **Lightbox Integration** - Full-screen viewing with Elementor's native lightbox

**Performance & SEO:**

* **Conditional Loading** - Only loads assets when needed (50% faster page loads)
* **Lazy Loading Ready** - Optimized for performance and SEO
* **Clean Code** - Follows WordPress and Elementor best practices
* **Accessibility** - ARIA labels and keyboard navigation support

**Video & Media:**

* **YouTube & Vimeo** - Direct integration with custom play buttons
* **Custom URLs** - Link images to any destination
* **File Links** - Direct links to media files
* **Lightbox Videos** - Full-screen video playback

**🎯 Perfect For:**

* Photography portfolios
* Product showcases
* Team member galleries
* Event photo galleries
* Video collections
* Blog post galleries
* Landing page hero sections
* E-commerce product galleries

**💡 Pro Tips:**

* Use the Grid layout for portfolios and product galleries
* Carousel mode works great for testimonials and featured content
* Slideshow is perfect for hero sections and presentations
* Enable lightbox for better user engagement
* Use video integration for dynamic content

== Requirements ==

* WordPress 6.0 or higher (tested up to 6.8)
* Elementor (Free or Pro)
* PHP 7.4 or higher (compatible with PHP 8.4)

== Installation ==

1. **Download & Upload** - Download the plugin and upload the `advanced-image-gallery` folder to `/wp-content/plugins/`
2. **Activate** - Go to Plugins → Installed Plugins and activate "Advanced Image Gallery for Elementor"
3. **Add to Page** - In Elementor, drag the "Advanced Image Gallery" widget to your page
4. **Customize** - Choose your layout, add images/videos, and customize settings
5. **Publish** - Save and view your stunning gallery!

**Quick Start:**
1. Add the widget to your page
2. Select Grid, Carousel, or Slideshow layout
3. Upload your images or add video URLs
4. Customize spacing, navigation, and effects
5. Publish and enjoy!

== Frequently Asked Questions ==

= How do I create a gallery? =
Simply drag the "Advanced Image Gallery" widget from Elementor's widget panel onto your page. Choose your preferred layout (Grid, Carousel, or Slideshow), add your images or videos, and customize the settings to match your design.

= Can I use videos in my gallery? =
Yes! The plugin supports both YouTube and Vimeo videos. Just paste the video URL in the video field, and the plugin will automatically detect and embed it with a custom play button overlay.

= Is the plugin mobile-friendly? =
Absolutely! All galleries are fully responsive and look perfect on desktop, tablet, and mobile devices. You can even set different column counts for different screen sizes.

= Do I need Elementor Pro? =
No! The plugin works with both Elementor Free and Elementor Pro. However, some advanced features like custom CSS may require Elementor Pro.

= Can I customize the appearance? =
Yes! The plugin offers extensive customization options including colors, spacing, navigation styles, overlay effects, and more. Everything can be styled to match your brand.

= Will it slow down my website? =
No! The plugin is optimized for performance with conditional loading. Swiper.js and other assets only load when needed, keeping your site fast and lightweight.

= Can I use it for e-commerce? =
Yes! The plugin is perfect for product galleries, portfolio showcases, and any visual content display. It works great with WooCommerce and other e-commerce solutions.

= Is there a limit on the number of images? =
No! You can add as many images as you want. The plugin is designed to handle large galleries efficiently.

= Can I add links to images? =
Yes! You can link images to custom URLs, media files, or use the lightbox feature for full-screen viewing.

= Does it work with page builders other than Elementor? =
Currently, the plugin is designed specifically for Elementor. However, it may work with other page builders that support Elementor widgets.

== Screenshots ==

1. **Grid Layout** - Clean, organized image grid with customizable columns and spacing
2. **Carousel Mode** - Smooth, touch-enabled carousel with navigation controls and autoplay
3. **Slideshow View** - Professional slideshow with thumbnail navigation and full-screen mode
4. **Masonry** – Dynamic, Pinterest-style layouts where images adjust seamlessly to fit the space
5. **Justified** – Perfectly aligned rows of images for a balanced, professional gallery look
6. **Metro** – Eye-catching, magazine-style layouts with varying image sizes for a modern appearance
7. **Video Integration** - YouTube and Vimeo videos with custom play buttons and overlays
8. **Customization Panel** - Extensive settings for layout, navigation, and styling options
9. **Responsive Design** - Perfect display across desktop, tablet, and mobile devices
10. **Lightbox Feature** - Full-screen image viewing with smooth transitions
11. **Overlay Effects** - Text and icon overlays with multiple animation options
12. **Navigation Options** - Arrows, dots, fraction, and progress bar pagination styles
13. **Mobile Preview** - Optimized mobile experience with touch gestures and responsive layouts

== Changelog ==

= 1.3 =
* **New Gallery Types** - Masonry, Justified & Metro
* Code improvements for security

= 1.2 =
* **Major Performance Update** - Significantly faster loading times and improved user experience
* **Enhanced Accessibility** - Better support for screen readers and keyboard navigation
* **Code Improvements** - More stable and maintainable codebase

= 1.1 =
* **Added deactivation popup**
* **Other minor bug fixes**

= 1.0 =
* **Initial Release** - Complete gallery functionality with all core features

== Upgrade Notice ==

= 1.2 =
* **Performance Boost** - Added conditional asset loading (50% faster page loads)
* **Accessibility** - Added ARIA labels and improved keyboard navigation

= 1.1 =
* **Code Quality** - Eliminated code duplication and improved maintainability
* **Unique IDs** - Fixed lightbox conflicts with multiple gallery instances
* **Video Parsing** - Centralized video URL parsing for better reliability
* **Bug Fixes** - Fixed text domain inconsistencies and improved error handling
* **Compatibility** - Updated for WordPress 6.8 and PHP 8.4 compatibility

= 1.0 =
* **Initial Release** - Complete gallery system with Grid, Carousel, and Slideshow layouts
* **Video Support** - YouTube and Vimeo integration
* **Elementor Integration** - Native Elementor widget with full customization
* **Responsive Design** - Mobile-first approach with breakpoint controls
* **Lightbox Support** - Full-screen viewing with Elementor's lightbox system

== Donate ==

**Love this plugin?** Help us continue development and add more amazing features!

Your support helps us:

* 🚀 Add new features and layouts
* 🐛 Fix bugs and improve stability
* 📱 Enhance mobile experience
* 🎨 Create more customization options
* 📚 Write better documentation

Buy Me A Coffee - ☕ [https://www.buymeacoffee.com/zluck](https://www.buymeacoffee.com/zluck).

== License ==

This plugin is licensed under the GPLv3 or later. For more information, see [https://www.gnu.org/licenses/gpl-3.0.html](https://www.gnu.org/licenses/gpl-3.0.html).
