Title: SazKit – Product Gallery for WooCommerce Author: Sazkit Published: 14 Luglio 2026 Last modified: 22 Agosto 2026 --- Ricerca i plugin ![](https://ps.w.org/sazkit-product-gallery-for-woocommerce/assets/banner-772x250. png?rev=3607412) ![](https://ps.w.org/sazkit-product-gallery-for-woocommerce/assets/icon-256x256. png?rev=3607412) # SazKit – Product Gallery for WooCommerce Di [Sazkit](https://profiles.wordpress.org/sazzad23/) [Scarica](https://downloads.wordpress.org/plugin/sazkit-product-gallery-for-woocommerce.1.0.7.zip) * [Dettagli](https://it.wordpress.org/plugins/sazkit-product-gallery-for-woocommerce/#description) * [Recensioni](https://it.wordpress.org/plugins/sazkit-product-gallery-for-woocommerce/#reviews) * [Installazione](https://it.wordpress.org/plugins/sazkit-product-gallery-for-woocommerce/#installation) * [Sviluppo](https://it.wordpress.org/plugins/sazkit-product-gallery-for-woocommerce/#developers) [Supporto](https://wordpress.org/support/plugin/sazkit-product-gallery-for-woocommerce/) ## Descrizione SazKit – Product Gallery for WooCommerce swaps the default WooCommerce single-product image gallery (FlexSlider + zoom) for a clean [Swiper](https://swiperjs.com) slider. Features: * Main slider with arrow and dot navigation, fade transition, and adaptive height. * Optional synced thumbnail navigation slider below the main image. * Full-screen lightbox with keyboard navigation, focus trapping, and click-to-magnify. * Hover zoom (inner magnify) on the main image for desktop pointers. * Configurable gallery height — a fixed pixel height (default 550px) that scales images down and centers them, or auto height that fits each image. * Image fit for fixed-height mode — Contain (show the whole image) or Cover (fill and crop edge-to-edge). * Optional forced gallery width on desktop (a customizable percentage) to override theme/page-builder layout conflicts. * Configurable thumbnail count (1–10 visible at once). * Toggle arrows and dots independently on the main slider. * Optional arrows on the thumbnail slider. * Autoplay for the main slider with a configurable interval (pauses on hover/focus). * Tabbed settings screen: General and Style. * Style tab: pick the arrow color and dot color with the native color picker. * Variation support — the main image updates when a variation with its own image is selected. * RTL aware. * Uses your site’s existing Swiper assets if a theme or another plugin already registers them; otherwise it loads its own bundled copy. * HPOS (High-Performance Order Storage) compatible. * Developer friendly: filter hooks for the image IDs, image sizes, and Swiper arguments. #### Filter hooks * `sazkit_settings` — filter merged plugin settings at runtime. * `sazkit_gallery_image_ids` — filter the attachment IDs used in the gallery. * `sazkit_main_image_size` / `sazkit_thumb_image_size` — filter the registered image sizes. * `sazkit_swiper_main_args` / `sazkit_swiper_thumbs_args` — filter the Swiper configuration. * `sazkit_swiper_handles` — override the detected Swiper script/style handles. * `sazkit_zoom_level` — filter the hover-zoom magnification factor (default `2.0`). * `sazkit_slide_badges` — filter to add badge overlays (e.g. Sale/New ribbons) to a gallery slide. * `sazkit_before_main_slides` / `sazkit_after_main_slides` — actions for add-ons to inject extra `.sazkit-slide` elements (e.g. video) into the main slider. * `sazkit_before_thumb_slides` / `sazkit_after_thumb_slides` — matching actions for the thumbnail slider, to keep both sliders’ indexes in sync. * `sazkit_gallery_wrapper_classes` — filter to add extra classes to the gallery wrapper (e.g. add-on layout classes). * `sazkit_disable_main_slider` — filter to skip Swiper initialization entirely, for add-ons rendering their own layout (e.g. a grid). * `sazkit_main_image_attrs` / `sazkit_thumb_image_attrs` — filter the `` attributes per slide (e.g. lazy-loading control). * `sazkit_main_image_html` / `sazkit_thumb_image_html` — filter the final `` HTML per slide (e.g. to wrap it in a `` element for WebP/AVIF). * render_gallery_for_product( WC_Product $product ) and `enqueue_gallery_assets()` are public methods add-ons can call directly to render/enqueue the gallery for an arbitrary product outside the single product page (e.g. a shortcode or block). * `sazkit_settings_nav_tabs` — action to add extra tab links to the settings page’s nav (so an add-on doesn’t need its own separate admin menu item). * `sazkit_settings_panels` — action to render extra tab panel(s) inside the settings card, after the built-in General/Style tabs’ own `
` closes. Forms can’t nest, so add-on panels needing to save fields must wrap themselves in their own` ` with their own save button — the built-in Cancel/Save changes footer only submits the General/Style tab and hides itself automatically while a non- native tab is active. Panels should use the same `.sazkit-tab-panel` / `#sazkit- tab-{slug}` markup convention as the built-in tabs so the shared tab-switching JS shows/hides them correctly. The gallery wrapper also fires two jQuery events add-ons can listen for: `sazkit: zoom` (hover zoom activated on a slide) and `sazkit:lightbox-open` (the lightbox opened for a slide), both passed the attachment ID. ### Third-Party Libraries This plugin bundles the Swiper library (v11.2.10) by Vladimir Kharlampidi, licensed under the MIT license. See https://swiperjs.com. ## Screenshot [⌊Main product slider with arrow and dot navigation.⌉⌊Main product slider with arrow and dot navigation.⌉[ Main product slider with arrow and dot navigation. [⌊Plugin settings screen.⌉⌊Plugin settings screen.⌉[ Plugin settings screen. ## Installazione 1. Upload the `sazkit-product-gallery-for-woocommerce` folder to `/wp-content/plugins/`, or install it through the Plugins screen in WordPress. 2. Activate the plugin through the **Plugins** screen. 3. Make sure WooCommerce is active. 4. Visit **Settings SazKit Gallery** to configure the gallery under the **General** and **Style** tabs. ## FAQ ### Does this require WooCommerce? Yes. WooCommerce 8.0 or newer must be active. The plugin does nothing on its own. ### Is it compatible with variable products? Yes. When a variation with its own image is selected, the first slide updates to that image and returns to the original when the selection is reset. ### Is it multilingual / WPML ready? Yes. All plugin strings are internationalized, and a translation template (`languages/ sazkit-product-gallery-for-woocommerce.pot`) is included. Product images and titles themselves are WooCommerce data, so WPML/Polylang translate them automatically — no extra configuration is required. ### Can I keep my theme’s Swiper version? Yes. If your theme or another plugin already registers a Swiper script/style handle, this plugin uses it instead of loading a second copy. ## Recensioni Non ci sono recensioni per questo plugin. ## Contributi e sviluppo “SazKit – Product Gallery for WooCommerce” è un software open source. Le persone che hanno contribuito allo sviluppo di questo plugin sono indicate di seguito. Collaboratori * [ Sazkit ](https://profiles.wordpress.org/sazzad23/) [Traduci “SazKit – Product Gallery for WooCommerce” nella tua lingua.](https://translate.wordpress.org/projects/wp-plugins/sazkit-product-gallery-for-woocommerce) ### Ti interessa lo sviluppo? [Esplora il codice](https://plugins.trac.wordpress.org/browser/sazkit-product-gallery-for-woocommerce/) segui il [repository SVN](https://plugins.svn.wordpress.org/sazkit-product-gallery-for-woocommerce/), segui il [log delle modifiche](https://plugins.trac.wordpress.org/log/sazkit-product-gallery-for-woocommerce/) tramite [RSS](https://plugins.trac.wordpress.org/log/sazkit-product-gallery-for-woocommerce/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 1.0.7 * Fixed the variation-image swap (a product’s main slide updating when a shopper selects a variation with its own image) incorrectly targeting an add-on’s 360 ° spin or before/after comparison slide when one was configured as the gallery’s first slide. A comparison slide holds two images, so this could overwrite both with the same variation image. The swap now only ever targets an actual product- image slide. * Fixed that same fix causing the slider to auto-navigate away from a deliberately- placed first-slide video/360°/comparison slide the moment a variation resolved( which happens automatically on page load whenever a variation is pre-selected)— it no longer jumps the slider away from that slide, while still applying the variation’s own image to the correct slide underneath it. * The Style tab’s “Gallery height” setting now auto-selects a matching “Image fit” when changed (Cover for Fixed height, Contain for Auto), since Image fit only applies in fixed mode and the two commonly pair up. Still editable afterward if a different combination is wanted. * Registered a new 200×200 thumbnail size and switched the gallery’s thumbnail strip to use it instead of WooCommerce’s own 100×100 `woocommerce_gallery_thumbnail`, which looked blurry once scaled up by the CSS (e.g. showing 4 thumbnails at once). The `sazkit_thumb_image_size` filter still works for further customization. Note: this only affects images uploaded/cropped after updating — existing product images need a thumbnail regeneration (e.g. via WP-CLI `wp media regenerate` or a “Regenerate Thumbnails” plugin) to pick up the new size. * Added a “Force gallery width on desktop” option (Style tab Gallery sizing) — an escape hatch for themes/page builders whose own layout CSS conflicts with the gallery’s width, letting you pin it to an explicit percentage (default 48%, matching WooCommerce’s own classic-theme default) above the 600px mobile breakpoint. Off by default; doesn’t apply on block themes, which already control the gallery’s width via the product-image-gallery block’s own layout. #### 1.0.6 * Renamed the plugin folder and main file to match the slug assigned by WordPress. org during review (`sazkit-product-gallery-for-woocommerce`), resolving a Text- Domain/slug mismatch flagged by Plugin Check. The Text Domain and all translation strings now correctly match the assigned slug. Also removed a stray `.claude` directory (an AI-assistant config folder) that had been flagged as not belonging in a production plugin. #### 1.0.5 * Removed the Custom CSS field from the Style tab. Per the WordPress.org plugin review team’s policy against plugins accepting arbitrary user-supplied CSS/JS/ PHP for output, the free-form textarea (previously piped straight into `wp_add_inline_style`) has been removed entirely. The Style tab still offers the arrow/dot color pickers. * Renamed the main class from `SazKit_Gallery` to `Sazkit_Gallery` to resolve a plugin-review prefix-consistency flag (the capitalized “K” didn’t match the lowercase` sazkit_` prefix used everywhere else — hook names, filters, the option key). No functional change; only affects code that referenced the class name directly( e.g. the Pro add-on, updated to match). #### 1.0.4 * Changed the Text Domain to `sazkit-product-gallery-for-woocommerce` (was `sazkit- gallery`) and updated every translation string to match. The admin menu slug, enqueued script/style handles, and the `.sazkit-gallery` CSS class are unchanged— only the translation domain moved. #### 1.0.3 * Fixed the arrow icons still losing their `position` to a theme’s own `!important` rule even after 1.0.2’s hardening: when both sides declare a property `!important`, it comes down to plain specificity, and a theme selector like `button:not(.fa): not(.close-style)::before` out-specifies a doubled class. The affected rules ( main/thumbnail/lightbox arrow icons) now triple the class instead of doubling it, which reliably exceeds that kind of theme selector regardless of load order. #### 1.0.2 * Hardened the gallery’s structural CSS (layout, image sizing, arrows, dots, thumbnails, and the lightbox overlay) with `!important` on every property that would visibly break if a theme’s own generic styling overrode it — not just the arrow icons fixed in 1.0.1. Purely cosmetic details are left as-is; this only covers things that would otherwise stop working correctly. #### 1.0.1 * Fixed the main/thumbnail/lightbox arrow icons becoming invisible or mispositioned on some themes at narrower viewport widths (seen with a Divi-style button “shine” hover effect that repurposes every `