# Luxe Gallery - WordPress Gallery Plugin

[![WordPress](https://img.shields.io/badge/WordPress-5.0%2B-blue.svg)](https://wordpress.org/)
[![PHP](https://img.shields.io/badge/PHP-7.4%2B-purple.svg)](https://php.net/)
[![License](https://img.shields.io/badge/License-GPL%20v2%2B-green.svg)](LICENSE)

A modern, performant WordPress gallery plugin with automatic WebP conversion, page builder integration, and an elegant Airbnb-style user interface.

## 🌟 Features

### Core Features
- **Hero Grid Layout**: 5 featured images in an appealing grid layout
- **Mobile-First Design**: Responsive design with Swiper slider for mobile devices
- **Category-Based Organization**: Organize images in custom categories
- **PhotoSwipe Lightbox**: Modern, touch-friendly lightbox experience
- **WebP Optimization**: Automatic WebP conversion for better performance
- **Drag & Drop Interface**: Intuitive admin interface for managing images

### Page Builder Integration
Native support for all major page builders:
- ✅ **Gutenberg Block** - Native block for the WordPress Block Editor
- ✅ **Elementor Widget** - Fully integrated widget with live preview
- ✅ **Divi Module** - Custom module for the Divi Builder
- ✅ **Beaver Builder Module** - Seamless integration with Beaver Builder
- ✅ **Bricks Builder Element** - Native Bricks element with all options

## 📦 Installation

### WordPress Admin
1. Navigate to `Plugins > Add New`
2. Search for "Luxe Gallery"
3. Click "Install" and then "Activate"

### Manual
1. Download the plugin
2. Extract the ZIP file
3. Upload the `luxe-gallery` folder to `/wp-content/plugins/`
4. Activate the plugin in WordPress Admin

## 🚀 Usage

### Shortcode
```
[luxe_gallery id="123"]
```

### Gutenberg Block
Search for the "Luxe Gallery" block in the Block Editor

### Page Builder
- **Elementor**: "Luxe Gallery" widget in the Elementor sidebar
- **Divi**: "Luxe Gallery" module in the Divi Builder
- **Beaver Builder**: "Luxe Gallery" in the Content Modules
- **Bricks Builder**: "Luxe Gallery" element in the Bricks Editor

## 🛠️ Development

### Prerequisites
- WordPress 5.0+
- PHP 7.4+
- Node.js 14+ (for build process)

### Setup
```bash
# Clone repository
git clone https://github.com/jannihares/luxe-gallery.git

# Change to plugin directory
cd luxe-gallery

# Install dependencies (if applicable)
npm install

# Build (if applicable)
npm run build
```

## 📋 System Requirements

### Minimum
- WordPress 5.0
- PHP 7.4
- MySQL 5.6
- 64MB PHP Memory Limit

### Recommended
- WordPress 6.0+
- PHP 8.0+
- MySQL 8.0+
- 128MB PHP Memory Limit
- GD Library or ImageMagick for WebP conversion

## 🗺️ Roadmap & Planned Features

### Version 1.1.0 - Advanced Configuration
- [ ] **Admin Settings Panel**: Comprehensive configuration options
- [ ] **WebP Settings**: Compression level and quality options
- [ ] **Image Sizes**: Configurable thumbnail and fullscreen sizes
- [ ] **Performance Tuning**: Cache settings and optimization options

### Version 1.2.0 - Advanced Gallery Features
- [ ] **Infinite Scroll**: Endless scrolling for large galleries
- [ ] **Favorites System**: Users can mark images as favorites
- [ ] **Social Sharing**: Direct sharing buttons for individual images
- [ ] **EXIF Data Display**: Display camera information
- [ ] **Fullscreen Mode**: Fullscreen presentation mode

### Version 1.3.0 - E-Commerce Integration
- [ ] **WooCommerce Integration**: Sell prints and downloads
- [ ] **Watermarks**: Automatic watermarks for protection
- [ ] **Download Protection**: Right-click protection and download control
- [ ] **Licensing System**: Different usage licenses

### Version 1.4.0 - Advanced Customization
- [ ] **Theme Builder**: Visual editor for gallery layouts
- [ ] **Animation Effects**: Advanced hover and transition effects
- [ ] **Custom CSS**: Integrated CSS editor
- [ ] **Template System**: Customizable template files

### Version 1.5.0 - Professional Features
- [ ] **Client Galleries**: Password-protected galleries for clients
- [ ] **Batch Upload**: Mass upload with metadata import
- [ ] **API Integration**: REST API for external applications
- [ ] **Multi-Site Support**: Optimization for WordPress Multisite

### Version 2.0.0 - AI & Automation
- [ ] **Auto-Tagging**: AI-based automatic tagging
- [ ] **Smart Categorization**: Automatic categorization of images
- [ ] **Face Recognition**: Face detection for people galleries
- [ ] **Content Moderation**: Automatic content filtering

## 📄 License

This plugin is licensed under the GPL v2 or later. See [LICENSE](LICENSE) for details.

### Third-Party Libraries
- **PhotoSwipe 5.4.4** - MIT License
- **Swiper.js 12.0.2** - MIT License

All libraries used are GPL-compatible.

## 👤 Author

**Janni Hares**
- Website: [https://jajasolutions.de](https://jajasolutions.de)
- WordPress.org: [@jannihares](https://profiles.wordpress.org/jannihares/)

## 🤝 Contributing

Contributions are welcome! Please read the [Contributing Guidelines](CONTRIBUTING.md) for details.

1. Fork the repository
2. Create a feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

## 📞 Support

For support and questions:
- Website: [https://jajasolutions.de](https://jajasolutions.de)
- WordPress Support Forum: [Support](https://wordpress.org/support/plugin/luxe-gallery) (after publication)
- Issues: [GitHub Issues](https://github.com/jannihares/luxe-gallery/issues)

## 📈 Changelog

### Version 1.0.0
- Initial release
- Hero grid layout with 5 configurable images
- Page builder integration (Gutenberg, Elementor, Divi, Beaver Builder, Bricks)
- Mobile-optimized Swiper slider
- PhotoSwipe lightbox integration
- Automatic WebP conversion
- Drag & drop admin interface

## ⭐ Credits

Developed with ❤️ by [Janni Hares](https://jajasolutions.de)

---

**[Download from WordPress.org](https://wordpress.org/plugins/luxe-gallery)** (after publication)