Woomark Image Gallery

Configuration

Version: 2.6

Configuration

Open a Woomark Image Gallery module: Content → Site Modules → edit your module. Settings are grouped into tabs.

Content tab
  • Image Source
    • From folder — loads every image in that folder automatically.
    • Individual slides — you pick each image, caption, category, and optional video.
  • Image Folder — the folder under images/ (example: woomark-demo).
  • Folder Categories (folder mode)
    • None — no filter pills.
    • Filename prefix — name files like Nature__lake.jpg.
    • Subfolders — put photos in Nature/, City/, etc.
  • Auto Captions from Filename — turns 01-mountain-lake.jpg into “Mountain Lake”.
  • Slides (individual mode) — image / poster, video URL, alt text, caption, category, optional external link.
  • Sort Order — A→Z, Z→A, or Random.
  • Load More (initial count) — show only the first N images, then a “Load more” button. Use 0 to show all.
Look & Feel tab
  • Theme — Modern 2026, Minimal, or Dark.
  • Accent Color — colour for filters and active controls (default #1819ed).
  • Gallery Width — e.g. 100% or 960px.
  • Columns — 1 to 6 on desktop (auto-clamps to 2 on tablet, 1 on phone).
  • Gap — space between thumbnails (pixels).
  • Masonry Layout — Pinterest-style uneven heights (on by default).
  • Thumb Aspect Ratio — Auto (natural) or fixed (1:1, 4:3, 16:9…).
  • Hover Caption — show on hover/focus, always visible, or hidden on thumbs.
  • Show Category Filters — filter pills when categories exist.
  • Zoom on Hover — slight zoom when the mouse is over a thumb.
  • Resize Thumbnails By — Width, Height, or Both + sizes.
  • WebP Thumbnails — smaller, faster thumbnail files.
  • Schema.org ImageGallery — SEO structured data (JSON-LD).
  • Protect Images — reduces right-click / drag on gallery media (not bulletproof).
Lightbox tab
  • OS Fullscreen Mode — off by default. Leave off for the classic framed lightbox; turn on for native fullscreen.
  • Slideshow Autoplay + Delay — auto-advance photos.
  • Slideshow Progress Bar — thin bar while autoplay runs.
  • Image Fit Mode — Contain (whole image visible) or Cover.
  • Thumbnail Filmstrip — small strip of thumbs inside the lightbox (off by default).
  • Download Button / Share Button — download and share (copy link + WhatsApp / X / Facebook).
  • Pinch / Scroll Zoom — mouse wheel zoom + two-finger pinch on phones.
  • Deep Link Hash — URL becomes #jx-wig-123-4 so you can share a specific slide.
  • Backdrop / control / caption colours and thumb borders.
Advanced tab
  • Load Minified CSS/JS — smaller assets for production.
  • Module Class Suffix — extra CSS class for your template.
  • Additional CSS — your own CSS rules.
Plugin defaults

Go to System → Plugins → Content - Woomark Image Gallery. These defaults apply when a shortcode does not set that option (theme, columns, WebP, captions, schema, and more).

Simple setup checklist
  1. Upload photos to Media.
  2. Create module → From folder → pick folder.
  3. Keep masonry on; pick theme + accent.
  4. Publish on the right pages.
  5. Click a photo on the front-end to test the lightbox.