Get Started

Easy Photo Gallery 2.0 is a modern Joomla content plugin for beautiful photo grids with a vanilla JavaScript lightbox — no jQuery required.

Install the package once to get the content plugin and the editor button. Place galleries in articles with a shortcode, or insert them from the article toolbar.

It supports folder or individual images, themes (Modern / Minimal / Dark), grid or masonry, category filters, hover captions, Load more, WebP thumbnails, and true fullscreen viewing.

Download

After purchase, download pkg_easy_photo_gallery_2.0.0.zip from your email or the store Downloads area.

Install

1. Go to System → Install → Extensions.
2. Upload pkg_easy_photo_gallery_2.0.0.zip (do not unzip first).
3. Wait for the success message.

Enable the plugins

1. Go to System → Plugins.
2. Enable Content - Easy Photo Gallery.
3. Enable Editor Button - Easy Photo Gallery.

Compatible with Joomla 4, 5, and 6.

Open System → Plugins → Content - Easy Photo Gallery.

Gallery Defaults

• Columns — 1 to 6 (overridable in the shortcode).
• Layout — Grid or Masonry.
• Theme — Modern, Minimal, or Dark.
• Gap / Radius — Spacing and corner roundness.
• Aspect Ratio — Auto, 1:1, 4:3, 3:2, 16:9, or 3:4.
• Image Fit — Cover (fill the tile) or Contain (show full image).
• Captions — Hover, always, or hidden.
• Category Filters / Hover Zoom / Accent — Filter pills, zoom on hover, brand colour.
• Initial Limit / Load More — Paginate large folders.

Images & Performance

• Sequential or random order, A–Z or Z–A sorting.
• WebP conversion and quality.
• Auto titles from filenames.
• Minified assets and lazy loading.

Shortcode tab

The plugin parameters include a Shortcode tab with ready-to-use examples and attribute reference.

Folder gallery

{photogallery folder="images/easy-photo-demo" columns="3" theme="modern" layout="grid" caption="hover" filter="1" limit="9" fit="cover" aspect="4/3"}{/photogallery}

Individual images with titles

{photogallery image="images/a.jpg,images/b.jpg" title="Title A,Title B" columns="2" caption="always" fit="cover"}{/photogallery}

Useful attributes

• folder / image / title
• columns (1–6), layout (grid|masonry), theme (modern|minimal|dark)
• caption (hover|always|0), filter (0|1)
• limit, loadmore, gap, radius
• aspect (auto|4/3|1/1|…), fit (cover|contain)
• hoverzoom, accent, thumbwidth, thumbheight

Category filters

Name files like Nature__alpine-lake.jpg to build filter pills automatically.

Editor button

In the article editor, click Easy Photo Gallery to insert a shortcode from a form (folder, columns, theme, layout, captions, filters).

• Vanilla JS lightbox — keyboard, swipe, counter, true fullscreen
• CSS grid and masonry layouts with themes
• Category filters from filename prefixes
• Hover or always-on captions
• Load more for large galleries
• WebP thumbnails, lazy loading, image prefetch
• Cover / contain fit without stretching images
• Package: content plugin + editors-xtd button
• Joomla 4 / 5 / 6 ready

• Do I need jQuery? No. Version 2.0 uses vanilla JavaScript.
• Shortcode shows as plain text? Enable Content - Easy Photo Gallery under System → Plugins, then clear cache.
• How do category filters work? Use Category__filename.jpg (two underscores). Set filter="1".
• Images look stretched? Use fit="cover" (fills the tile) or fit="contain" (shows the full image). Thumbs keep natural aspect ratio.
• Where is the editor button? Enable Editor Button - Easy Photo Gallery.

• No images found — Check the folder path under images/ and that files are JPG/PNG/WebP.
• Shortcode not rendering — Enable the content plugin; use curly braces {photogallery …}; clear Joomla cache.
• Lightbox not opening — Confirm assets load (disable conflicting scripts); hard-refresh the browser.
• Filters missing — Need at least two categories from Name__file.jpg prefixes, and filter="1".
• Editor button missing — Enable the editors-xtd plugin and reopen the article editor.