FAQ

Basics

What is Woomark Image Gallery used for?

It shows a masonry (or grid) of photos. Click one to open a classic lightbox with next/previous controls — great for portfolios, restaurants, travel, and agency sites.

Do I need both the module and the plugin?

No. Install the package once. Use the module for sidebars/positions, the plugin for galleries inside articles. Many sites use both.

Which Joomla versions work?

Joomla 4, 5, and 6.

Is it mobile friendly?

Yes. Columns drop to 2 on tablet and 1 on phone. The lightbox supports swipe, pinch-zoom, and scales to the browser height.

What image types are supported?

JPG, JPEG, PNG, GIF, and WebP. Optional WebP conversion for generated thumbnails.

Setup

Where do I put my photos?

Usually under images/ using Content → Media. Example folder: images/woomark-demo.

Module or shortcode — which should a beginner use?

Start with the module. It has forms and switches. Use shortcodes when you want a gallery in the middle of article text.

How do I create a module gallery?

1. Content → Site Modules → New → Woomark Image Gallery
2. Choose From folder or Individual slides
3. Pick position + pages → Publish → Save

How do I add a gallery inside an article?

Enable the content plugin, then use the editor button or paste: {wookmark folder="images/woomark-demo" columns="3" masonry="1"}

The editor button is missing. Why?

Enable Editor Button - Woomark Image Gallery under System → Plugins. Also make sure your editor shows the button bar.

Layout, captions, lightbox

Can I use a masonry layout?

Yes — masonry is on by default in 2.6. Turn it off for a uniform grid.

What does Hover Caption do?

Hover shows captions on hover/focus. Always keeps them visible. None hides them on thumbs (lightbox still gets the caption).

Does the lightbox go fullscreen by default?

No. The default is a classic framed lightbox. Turn on OS Fullscreen Mode only if you want native fullscreen.

How do category filters work?

Give slides a category name, or in folder mode use Nature__lake.jpg / subfolders. Filters appear as pills above the grid when enabled.

Can I add video slides?

Yes — MP4, YouTube, or Vimeo with an image poster on individual slides (or via the video shortcode attribute).

Will my old settings still work after upgrading?

Yes. Legacy fields such as checker, offset, caption_option, and imgcaption are mapped automatically.

Where are resized images stored?

Under images/wookmark/thumbnail/ and images/wookmark/large/ (plus webp/ when enabled). Delete that folder to rebuild thumbs.