com_foldergallery 1.4.1 (Joomla 4 / 5 / 6)
Gallery with tag filters. Tags = subfolders `images/gallery//`, images = jpg/jpeg/png/webp inside.
Filter buttons, animation, Lightbox (only visible images), responsive grid.
Installation and Update
Extensions → Installation → Download zip. The update is applied on top, and the data (tags, names, and order) is preserved.
Place images in `images/gallery//…` or upload them through the admin panel.
Admin Panel (Components → Folder Gallery)
# Tags
- Create — manual tag: folder name (letters, numbers, hyphens, underscores), button title, language names.
The folder is created in `images/gallery`, and the tag is added to the end of the list. It will appear on the site when it has images.
-Button title: main (empty = folder name with capital letter) + separate for each site language
(tag form → “Names by language”; fields are taken from the site’s content languages). Empty — the main title or folder name.
-Publish and button order — by dragging.
- The folder of an existing tag is not changed.
# Images
- Signature/alt, publication, order within a tag (by dragging), filter by tag.
- Upload — JPG/PNG/WEBP files in multiple files to an existing tag or to a new folder (a new tag is created).
- Delete — deletes selected images from the server and from the database (with confirmation; requires the "Delete" permission).
- Synchronize — new folders/files are added, those deleted from the disk are removed; The names, order, and status of existing ones remain unchanged.
Empty folders remain tags (to prevent manually created tags from disappearing).
Auto-sync is enabled in the settings (in the admin panel and/or on the website).
Settings
- Path to the gallery folder (by default, `images/gallery`).
- Auto-sync in the admin panel and on the website.
- Columns on desktop: 2–8 or 10 (3 by default). On tablets, no more than 4.
- Columns on a phone: 1–3 (default 1; 2–3 for small thumbnails).
- Access rights.
Website
Menu → New item → "Gallery from folders" → Gallery. Menu item parameters:
- Columns on desktop and phone ("Use global setting" takes values from the component settings);
- Thumbnail aspect ratio, Lightbox, "Show all" button text;
- Button classes (by default, `btn btn-dark` / `btn btn-primary` — template styles, for example, Helix Ultimate).
The gallery page has its own side padding and a maximum width of 1400 px (independent of the template).
For other pages, padding is set in the template CSS (Helix Ultimate → Custom Code → Custom CSS).
Languages
Admin and site: en-GB, ru-RU, uk-UA, sv-SE, es-ES.
Security
Upload and deletion: token and permissions check, extension + real image type check, name sanitization,
protection against exceeding gallery folder boundaries.
