What Tiger Product Gallery Does
Tiger Product Gallery is a self-contained WooCommerce single-product gallery widget that replaces WooCommerce’s default flexslider/zoom gallery with a dependency-free Swiper-powered engine built into the Tiger Elements plugin. It’s designed to render reliably inside Tiger Theme Builder single-product templates and to preview correctly in the Elementor editor through Tiger’s preview-context module. Per the plugin’s own code comments, it’s built to consolidate what competing plugins split into several widgets (Modern/Grid/Slider/Anchor gallery types) into one widget with a single layout switch, plus features like Instagram-style “story” mode, product video slides, and a built-in lightbox — all powered by the shared `tiger-gallery` JS/CSS engine that the dynamic Tiger Gallery widget also uses.
Like the other Tiger dynamic product widgets, this one requires WooCommerce and product context, reading the product from $tiger_loop_post_id or get_the_ID(). Uniquely among the three, it has an editor-only fallback: if no product resolves while editing, it fetches the most recently published WooCommerce product so the canvas is never an empty box — on the live front end, though, if no product resolves it shows nothing (or, in edit mode with WooCommerce fully inactive, a plain notice).
Setting It Up in Elementor
The “Gallery” content section leads with “Layout”, a select with four options: “Slider + Thumbnails” (default), “Story (tap / auto-advance)”, “Grid”, and “Masonry”. For slider layout, “Thumbnails position” (Left/Bottom/Right) and “Show thumbnails” (switcher, default on) appear. For grid/masonry, a responsive “Columns” number control (1–6, default 3) appears instead. “Main image size” lets you pick Medium, Large (default), Full, or “WooCommerce Single”. “Image ratio” offers Natural (default), Square 1:1, Standard 4:3, Portrait 3:4, or Wide 16:9. “Lightbox on click” is a switcher (default on) enabling click-to-enlarge.
A “Product Video” heading groups video-specific controls: “Show product video slide” (switcher, default on) reads Tiger’s own video meta plus JetWooBuilder’s video meta for drop-in compatibility. “Video position” places it as “First slide” (default) or “Last slide”. A raw-HTML note explains that leaving fields blank auto-reads built-in meta, while “Video URL field key” and “Video poster field key” text fields let you point at a custom meta key (e.g. a CPT Builder Meta Box field, which is prefixed tcp_) instead.
The “Slider” section (shown for Slider/Story layouts) has “Transition effect” (Slide/Fade/Cards “tinder stack”/Creative “profile swipe”/Coverflow 3D — slider layout only), “Swipe direction” (Horizontal/Vertical/RTL), “Arrows” and “Pagination” (None/Bullets/Dynamic bullets/Fraction/Progress bar, slider only), “Loop” (default on), “Autoplay” (default off) with a conditional “Autoplay delay (ms)” (default 4000), a note that Story layout always auto-advances on that delay regardless of the Autoplay switch, “Transition speed (ms)” (default 500), and “Drag threshold (px)” (“sensitivity”, default 5 — higher makes a swipe harder to trigger).
Style tab sections cover “Image” (responsive border radius and gap CSS variables, plus border/box-shadow groups on .tiger-gallery-main/.tiger-gallery-cell), “Thumbnails” (shown only for slider layout with thumbnails on: “Active outline” color, responsive “Thumbnails per view”, “Thumbnail gap”, and a conditional “Side strip width” for left/right positions), and “Arrows” (shown only when navigation is enabled: responsive “Size” and “Icon color”/”Background” colors, all mapped to CSS custom properties).
Non-Obvious Behavior
Slide order is built from the featured image, then all gallery image IDs, deduplicated — then the video slide (if resolved) is spliced in first or last per “Video position”. Video resolution follows a strict fallback chain: (1) your mapped “Video URL field key” if set, with type auto-inferred from the URL; (2) Tiger-native meta keys tiger_product_video_type/_url; (3) JetWooBuilder’s _jet_woo_product_video_* meta for YouTube, Vimeo, or self-hosted. Poster images follow their own chain: your mapped poster key, then tiger_product_video_placeholder, then _jet_woo_product_video_placeholder, then finally the first image slide’s src. Video is rendered as a click-to-play facade — no eager third-party iframe loads on page load.
“Cards” and “Creative” transition effects, plus per-slide navigation/pagination, are only meaningful in the “slider” layout — the widget’s own config builder forces effect to “slide” and disables navigation/pagination whenever layout is “story”, regardless of what you selected.
When to Use vs. Related Widgets
Use Tiger Product Gallery specifically for a single product’s own image/video set on a product page — it always resolves imagery from the current product’s featured image and gallery attachments, not an arbitrary media selection. This distinguishes it from the plugin’s standalone “Tiger Gallery” widget (which shares the same rendering engine but is meant for arbitrary, manually-curated image sets anywhere on a page, not tied to a WooCommerce product).
Practical Tips
- If your product video isn’t showing up, check the field-key mapping first — a stray “Video URL field key” pointing at an empty custom field silently blocks the fallback to Tiger-native and JetWooBuilder meta, since the mapped key takes priority whenever it’s non-empty.
- Use “Story” layout for mobile-first product pages where large tap-to-advance visuals outperform arrow navigation; remember it ignores your “Transition effect” and “Pagination” choices entirely.
- Set “Image ratio” explicitly (e.g. Square 1:1) when mixing product photos of inconsistent dimensions, so the grid/masonry/slider crops consistently instead of using each image’s natural ratio.
- For migrating from JetWooBuilder, you don’t need to re-enter video URLs — the widget reads JetWooBuilder’s existing
_jet_woo_product_video_*postmeta automatically as a fallback, so old product videos keep working unchanged.