📖 About the Extension
BR Simple Image Gallery PRO is a complete solution for creating stunning image galleries in Joomla. Developed with a focus on performance, SEO, and ease of use, this extension allows you to transform any image folder into a professional gallery with just a shortcode or a click in the editor.
✨ Key Features
• 🚀 Extreme Performance: Automatic WebP/AVIF image generation and native Lazy Loading built-in.
• 🎨 Multiple Layouts: Choose from 14 amazing layouts, including Masonry (Pinterest style), Justified (Google/Flickr style), Polaroids, Sliders, and more.
• 🖼️ Popup Engines (Lightbox): 7 integrated lightbox library options (G-Lightbox, FancyBox, Magnific, Colorbox, PhotoSwipe, Spotlight, LightGallery).
• 💧 Advanced Watermarking: Protect your images with customizable watermarks (position, opacity, padding, and minimum size).
• 📱 Responsive and Mobile-Friendly: Galleries that adapt perfectly to any screen size.
• ⚙️ Complete Management via Dashboard: Create folders, upload via drag & drop, add titles and descriptions, and delete images directly from the Joomla dashboard.
• 🔄 EXIF Auto-rotation: Automatic correction of photo orientation taken with smartphones.
• 🔗 Social Sharing and Download: Integrated buttons for WhatsApp, Facebook, X (Twitter), Pinterest, and direct download.
🚀 Getting Started (Quick Guide)
Installing and using BR Simple Image Gallery PRO is extremely simple. Follow the 3 steps below to create your first gallery:
Step 1: Initial Configuration
After installing the package (pkg_br_sigpro_v1.0.0_PRO.zip), go to Components > BR Simple Image Gallery PRO. Click the Options button (in the top right corner) to define your global preferences, such as:
• Default gallery layout.
• Popup engine (Lightbox).
• Thumbnail dimensions.
• Optimization settings (WebP, Quality).
Step 2: Create a Folder and Upload Photos
In the component's main dashboard:
Type a name for the new gallery in the "New folder name..." field and click Create Folder.
Click the Manage button on the newly created folder's card.
Drag and drop your images (JPG, PNG, WEBP, AVIF) into the upload area. The system will automatically resize and optimize them.
(Optional) Add Titles and Descriptions for each image.
Step 3: Insert into Article
Go to the article or module where you want to display the gallery:
• Easy Method: Click the "BR Sig Pro" button (camera icon) in your Joomla editor, select the desired options, and choose the folder.
• Manual Method: Type the shortcode directly into the text:
Plain Text
{gallery}your-folder-name{/gallery}
🎨 Available Layouts
The extension offers a wide variety of layouts to meet any design need. You can set a global layout in the options or override it per gallery.
Layout Name Description Classic Traditional grid with uniform thumbnails. Artistic Modern style with differentiated spacing. Elegant Clean and sophisticated design. Galleria Focus on images with subtle borders. Masonry Pinterest style. Ideal for images with different proportions. Previewer Thumbnail grid with a featured viewer. SliderPreview Main slider with navigable thumbnails below. SingleThumb Displays only one thumbnail (cover). Clicking it opens the full gallery in the popup. SingleSlider An automatic slider displaying one image at a time. Polaroids Fun effect of old instant photos. Seamless Grid without margins between images. Sleek Minimalist and ultra-modern design. Square Perfectly square thumbnails (Instagram style). Justified Fills the entire screen width while maintaining aspect ratio (Google Images/Flickr style).
⚙️ Configuration Overrides (PRO Tip)
You are not stuck with global settings! You can customize each gallery individually by adding attributes directly to the shortcode.
Basic Syntax:
Plain Text
{gallery attribute="value"}folder-name{/gallery}
Practical Examples:
Change Layout and Popup Engine:
Plain Text
{gallery layout="Masonry" engine="spotlight"}my-vacation{/gallery}
Change Thumbnail Size:
Plain Text
{gallery width="300" height="200"}products{/gallery}
Disable Watermark for a Specific Gallery:
Plain Text
{gallery watermark="0"}clean-portfolio{/gallery}
💧 Configuring Watermark
Protect your copyrights by automatically applying watermarks.
Go to the component's Options and navigate to the Watermark tab.
Enable the Enable Watermark option.
Select your image (must be a PNG file with a transparent background).
Configure the Position (Center, Top Left, Bottom Right, etc.).
Adjust the Opacity (e.g., 50%) and Max Ratio (to ensure the logo doesn't become too large on small photos).
🛠️ System Requirements
To ensure the perfect functioning of all features (especially image optimization and watermarks), your server must meet the following requirements:
• Joomla: Version 4.x, 5.x, or 6.x
• PHP: Version 7.4 or higher (PHP 8.1+ Recommended)
• GD Library: Must be installed and enabled in PHP.
• Memory Limit: Minimum 256MB (Recommended 512MB or 1GB for very large galleries with watermarks).
• Max Input Vars: Recommended 3000 or higher (to save titles/descriptions of many photos simultaneously).
❓ Common Troubleshooting
- The gallery does not appear, only the text {gallery}folder{/gallery} is displayed.
• Check if the "Content - BR Simple Image Gallery PRO" plugin is enabled in System > Plugins.
- Error uploading images or creating folders.
• Check the write permissions for your Joomla's /images/ and /cache/ folders. They should have 755 permissions.
- The editor button does not appear.
• Check if the "Button - BR Simple Image Gallery PRO" plugin is enabled.
- Data loss when saving titles and descriptions for many images.
• This occurs due to a server security limitation called max_input_vars. The component will display an alert if you exceed this limit. Ask your hosting provider to increase the max_input_vars value in php.ini.
Developed with ❤️ by Janderson Moreira
Copyright © 2026