Fullscreen Image Gallery

What's new?

Version 2.5: 18 October 2026

• Runs on Joomla 5 and 6 with Behaviour Backward Compatibility disabled
• Editor button uses a service provider
• Editor button styles and script load through the Web Asset Manager

Version 2.4: 15 July 2026

Added:

• True OS fullscreen lightbox (Fullscreen API) with edge-to-edge viewing
• Vanilla JavaScript lightbox (no jQuery) with keyboard, swipe, play/pause, download, and share
• Social share menu: copy link, WhatsApp, X, and Facebook
• Editor button plugin to insert {fullscreen} shortcodes from the article toolbar
• Video slides: MP4, YouTube, and Vimeo (module slides + shortcode)
• Video demo variant with mixed YouTube / Vimeo / MP4 / still photos
• Folder-mode categories from filename prefix (Nature__lake.jpg) or subfolders
• Auto captions from filenames in folder mode
• Category filter pills on the grid
• Load more / initial count for large galleries
• Responsive srcset thumbnails and next/prev image prefetch
• Pinch-zoom on touch devices (plus scroll zoom and pan)
• Slideshow progress bar
• Lightbox fit modes: contain or cover
• Deep-link hash to open/share a specific slide
• Optional filmstrip inside the lightbox
• Focus trap and screen-reader announcements
• Schema.org ImageGallery JSON-LD option
• Optional right-click / drag protect
• Themes: Modern 2026, Minimal, Dark with accent colour
• Aspect-ratio lock, loading skeletons, hover zoom
• Package installs module + content plugin + editors-xtd together

Changed:

• Rebuilt module and content plugin for Joomla 4 / 5 / 6 services architecture
• Modern CSS grid and masonry layout controls (columns, gap, width)
• Improved share UX with toast confirmation and deep-link aware copy
• Shortcodes skip examples inside <pre> / <code> blocks
• Install package layout uses packages/ folder for nested extension zips
• Documentation, FAQs, and feature cards updated for 2.4

Fixed:

• Native fullscreen vs viewport-only overlay behaviour
• Grey stretch bars in the thumbnail grid
• Filmstrip scrolling the page; filmstrip now optional and off by default
• Slide sorting when values are nested arrays
• Lightbox alt text, Space key stealing focus, and hash clearing on exit
• Content plugin PSR-4 namespace registration
• Missing root index.html in content plugin package (install copy error)

Version 2.3: 18 January 2026

Fixed:

• Improved error handling for missing image directories
• Fixed potential issues with empty image arrays in gallery processing
• Enhanced validation for folder paths to prevent directory traversal issues

Changed:

• Improved code structure and organization for better maintainability
• Enhanced image processing with better error checking and validation
• Optimized asset loading to prevent unnecessary resource loading
• Updated plugin metadata and version information

Version 2.2: 11 December 2025

Fixed:

• Fixed critical type error where sortImages() method was receiving stdClass object instead of array when using slides mode
• Fixed issue where images were not displaying when using slides mode due to incorrect extraction of nested subform data structure
• Enhanced type validation and error handling throughout the module to prevent similar issues

Changed:

• Updated slides extraction logic to properly handle Joomla's nested subform structure (slides0, slides1, etc.)
• Added better type validation, filtering, and array reindexing in the sortImages() helper method
• Added defensive checks to ensure items array is always properly initialized
• Separated sorting logic for folder-based images vs slides - slides now maintain user-defined order

Version 2.1: 03 December 2025

• Full Joomla 4, 5 and 6 compatibility with modern coding standards
• Shortcode examples tab with one-click copy in plugin configuration
• Enhanced plugin parameters, type safety, and content processing
• Optimized asset loading and image processing
• Improved security with HTML escaping and input sanitization

Version 2.0: 19 November 2023

• Supports Joomla 5 without Backward Compatibility Plugin
• Added masonry layout
• Uses new image resizing
• Images can now be converted to WebP format
• Does not support Joomla 3

Version 1.9: 20 February 2023

• Fixed PHP bug when no directory specified

Version 1.8: 06 February 2023

• Updated JS files to support latest jQuery
• Fixed PHP issues to support PHP 8
• Plugin syntax modified and made simpler

Version 1.7: 27 October 2021

• Supports Joomla 4
• Supports PHP version 8

Version 1.6: 05 June 2020

• Code optimization
• Option to choose folder in the backend (module)
• Thumbnail zoom on hover option added

Version 1.5

Module note: keep a backup of slides when upgrading from 1.4 to 1.5.

• Joomla updater integrated
• Option to add padding and margin around the thumbnail
• PHP and jQuery issues fixed
• Additional CSS field in the backend
• Option to add border and border colour to the image
• Overlay option added