Key Features

Dual Component System
- Module Component: Display galleries in any module position with full backend configuration options
- Content Plugin: Embed galleries in articles using {vertexgallery} shortcodes
- Both components share the same powerful gallery engine for consistent functionality
- Use one or both components together for maximum flexibility

Flexible Layout Options
- Grid Layout: Clean, organized grid with customizable columns and uniform display
- Masonry Layout: Pinterest-style layout that automatically arranges images without gaps
- Responsive column controls: Auto, fixed number, or responsive format (e.g., "1,2,3" for mobile, tablet, desktop)
- Configurable gaps, max width, and aspect ratios for perfect display

Advanced Modal Lightbox
- Professional full-screen lightbox with dark/light themes
- Smooth transitions: Fade, Crossfade, or Slide effects
- Comprehensive controls: Play/pause, speed slider, image count, thumbnail strip, fullscreen, rotate, flip, zoom
- Theme toggle, autoplay progress bar, download, and share buttons
- Full touch support with swipe gestures on mobile
- Keyboard navigation (arrow keys, ESC) for desktop users

Dual Image Sources
- Folder-Based: Automatically load all images from a specified folder
- Manual Slides: Use repeatable subform to add images with custom titles, descriptions, and categories
- Auto-generate titles from filenames (folder-based)
- Support for JPG, JPEG, PNG, GIF, and WebP formats

Smart Image Processing
- Automatic image resizing for thumbnails and modal display
- Configurable thumbnail and modal image dimensions
- Smart image caching system for faster repeated loads
- Optional WebP format conversion (25-30% smaller file sizes)
- Configurable WebP quality settings (1-100)

Category Filtering System
- Organize images into categories for easy filtering
- Categories automatically generated from folder names (folder-based)
- Manual category assignment for curated galleries (slides)
- Beautiful filter buttons with smooth animations
- "All" button to show all images

Extensive Customization
- Visual Themes: Corner styles (rounded/flat), card shadows, accent colors
- Image Filters: Grayscale, sepia, blur, brightness, contrast, saturate with configurable intensity
- Filter on Hover: Remove filter, add filter, or no hover effect
- Caption Display: Always visible, on hover, or hidden
- Gallery Behavior: Randomize order, single image preview
- Module Suffix: Add custom CSS classes for targeted styling
- Extra CSS: Per-instance custom CSS with placeholder support

Fully Responsive Design
- Mobile-optimized with touch-friendly controls
- Responsive grid layouts that adapt to all screen sizes
- Intelligent responsive breakpoints
- Works perfectly on desktop, tablet, and mobile devices

Modern Architecture
- Full Joomla 4, 5 & 6 compatibility
- Uses WebAssetManager for optimal asset loading
- Modern PHP 7.4+ code with strict type declarations
- Proper namespace implementation
- Clean, standards-compliant code

Quick Start

Module Usage:
1. Navigate to Content > Site Modules
2. Create new "Vertex Gallery" module
3. Choose Image Source: Folder or Slides
4. Configure layout, visual, and modal settings
5. Assign to module position and publish

Plugin Usage:
1. Install and enable "Content - Vertex Gallery" plugin
2. Configure default settings in plugin configuration
3. Add shortcode to articles: {vertexgallery folder="images/gallery"}
4. Or use individual images: {vertexgallery images="img1.jpg,img2.jpg"}

Shortcode Examples:
- {vertexgallery folder="images/portfolio"}
- {vertexgallery images="photo1.jpg,photo2.jpg"}
- {vertexgallery folder="images/gallery" layout="masonry" columns="3" gap="20"}
- {vertexgallery folder="images/products" show_filter="1" enable_modal="1" modal_theme="light"}

Perfect For

• Photography Portfolios - Showcase photography work in stunning galleries
• Product Showcases - Display products in organized, filterable galleries
• Event Galleries - Create galleries for weddings, events, and celebrations
• Art Portfolios - Present artwork in beautiful grid or masonry layouts
• Real Estate - Show property photos with category filtering
• Blog Content - Add visual galleries to articles and blog posts
• E-commerce - Display product images in engaging gallery format
• Corporate Websites - Professional image galleries for company portfolios
• Travel Blogs - Showcase travel photos with category organization
• Creative Agencies - Display client work and portfolios

Configuration Options

Image Source Settings
- Choose between folder-based or manual slides
- Folder path configuration (relative to Joomla root)
- Auto-generate titles from filenames (folder-based)
- Manual slide management with subform interface
- Image, title, description, and category per slide

Layout & Visual Settings
- Layout type: Grid or Masonry
- Columns: Auto, fixed number, or responsive format
- Gap between items (pixels)
- Gallery max width
- Item aspect ratio (Grid only)
- Corner style: Rounded or Flat
- Show card shadow
- Accent color picker
- Show gallery filter
- Gallery caption display mode
- Image filter type and amount
- Filter on hover behavior

Modal/Lightbox Settings
- Enable/disable modal
- Modal theme: Dark or Light
- Backdrop opacity (0.0 to 1.0)
- Modal transition: Fade, Crossfade, or Slide
- Swipe threshold for mobile
- Disable right click protection
- Control visibility: Play/pause, speed, count, thumbnails, fullscreen, rotate, flip, zoom, theme toggle, progress, download, share
- Thumbnail height and style
- Autoplay interval
- Enable captions in modal

Image Resize Settings
- Thumbnail width and height
- Modal image width and height
- Enable WebP format conversion
- WebP quality (1-100)

Gallery Behavior
- Randomize gallery order
- Show single image preview

Advanced Settings
- Module class suffix
- Extra CSS with placeholder support ({moduleid}, {galleryid})

Plugin Default Settings
- Configure default layout, columns, modal settings
- Defaults apply to all shortcode instances
- Shortcode attributes can override defaults

Technical Features

Performance Optimized
- Automatic image caching for resized images
- WebP conversion for smaller file sizes
- Efficient asset loading with WebAssetManager
- Lazy loading support
- Optimized JavaScript and CSS

Security Features
- Path validation and sanitization
- Directory traversal protection
- Safe file type validation
- Secure image handling
- Joomla security best practices

Responsive Design
- Mobile-responsive layouts
- Touch-friendly controls and gestures
- Adaptive column settings
- Cross-device compatibility
- Mobile-optimized modal

Cross-Browser Support
- Chrome, Firefox, Safari, Edge, Opera
- Modern browser compatibility
- Mobile browser support (iOS Safari, Chrome Mobile)
- Cross-platform (Windows, Mac, Linux, mobile)

Accessibility
- ARIA support for screen readers
- Keyboard navigation support
- Semantic HTML structure
- Focus management
- WCAG compliant

Installation

Package Installation:
1. Log in to Joomla backend
2. Navigate to System > Install > Extensions
3. Upload pkg_vertexgallery.zip
4. Click Install
5. Both module and plugin are automatically installed
6. Plugin is enabled by default

System Requirements:
- Joomla 4.0.0 or higher (4.x, 5.x, 6.x)
- PHP 7.4.0 or higher
- PHP GD extension (for image resizing and WebP conversion)
- Modern web browser with JavaScript enabled

After Installation:
- Module: Go to Content > Site Modules to create gallery instances
- Plugin: Go to Extensions > Plugins to configure default settings
- Both components are ready to use immediately

Support

• Support Portal: https://support.joomlax.com
• Email Support: info@joomlax.com
• Website: https://www.joomlax.com
• Documentation: Comprehensive documentation included with package
• Update Server: Automatic updates via Joomla update system

Why Choose Vertex Gallery?

Complete Solution - Both module and plugin in one package, use one or both for maximum flexibility

Professional Features - Advanced lightbox, category filtering, image processing, and extensive customization options

Easy to Use - Intuitive backend interface, simple shortcodes, no coding required

Flexible Deployment - Display in module positions or embed in articles, multiple instances supported

Performance Optimized - Image caching, WebP conversion, efficient code, minimal impact on page load

Mobile Friendly - Fully responsive with touch support, works perfectly on all devices

Modern & Future-Proof - Built for Joomla 4, 5 & 6 with modern coding standards, regular updates and support

Secure & Reliable - Path validation, secure file handling, follows Joomla security guidelines

Well Documented - Comprehensive documentation with clear examples, FAQs, and configuration guides

Beautiful Design - Professional layouts, smooth animations, customizable themes, and polished user experience

Create stunning, professional galleries that enhance user experience and showcase your images beautifully while maintaining optimal performance and compatibility across all devices and Joomla versions.