WooSwipe WooCommerce Gallery

add_filter( 'wooswipe_zoomed_image_size', 'wooswipe_max_image_size', 10, 1 );
function wooswipe_max_image_size( $size ) {
    return 'large';
}

1. 

   Gallery with a large main image, thumbnail strip and circular navigation arrows

2. 

   Popup / lightbox layout

How do I hide the featured image from the product gallery?

Use this in your theme’s functions.php or a code-snippets plugin. WooSwipe respects it for both the main image and thumbnails (from 3.0.9):

function remove_featured_image( $html, $attachment_id ) {
    global $post;
    if ( ! $post ) {
        return $html;
    }
    $featured_image = get_post_thumbnail_id( $post->ID );
    if ( (int) $attachment_id === (int) $featured_image ) {
        $html = '';
    }
    return $html;
}
add_filter( 'woocommerce_single_product_image_thumbnail_html', 'remove_featured_image', 10, 2 );

Or use the WooSwipe-specific filter:

add_filter( 'wooswipe_include_attachment', function( $include, $attachment_id ) {
    global $post;
    if ( $post && (int) $attachment_id === (int) get_post_thumbnail_id( $post->ID ) ) {
        return false;
    }
    return $include;
}, 10, 2 );

When the featured image is excluded, WooSwipe uses the first gallery image as the main image.

The gallery does not work

This is usually a JavaScript conflict. Try:

1. Disable other plugins one by one to find a conflict.
2. Switch temporarily to a default theme (e.g. Twenty Twenty-Four).
3. Check the browser console for script errors.

Can I load a product gallery via shortcode?

Yes. Use [product_page id="123"] with the correct product ID.

The gallery is full width and product details sit underneath

That was a 3.0.10 regression on classic (PHP) themes: WooSwipe forced #wooswipe to width: 100%. Update to 3.0.12. Block themes (Twenty Twenty-Four / Twenty Twenty-Five) still use a full-width gallery inside their column.

Hide FAQ

3.0.13

• Update the WordPress.org banners to show the inline gallery with thumbnails and circular navigation arrows.
• Replace the default gallery screenshot with the current gallery reference and include screenshots in the WordPress.org assets folder.

3.0.12

• Fix: gallery no longer forced to full width on classic (non-block) themes. 3.0.10 set #wooswipe { width:100% !important } for block-theme columns, which overrode WooCommerce’s 48% .images / .summary two-column layout (gallery stacked above product details). Full-width is now scoped to block themes only (body.wooswipe-block-gallery / product-image-gallery block).

3.0.11

• Fix: gallery no longer forced to full width on classic (non-block) themes. 3.0.10 set #wooswipe { width:100% !important } for block-theme columns, which overrode WooCommerce’s 48% .images / .summary two-column layout (gallery stacked above product details). Full-width is now scoped to block themes only (body.wooswipe-block-gallery / product-image-gallery block).

3.0.10

• Fix: double gallery on block themes (Twenty Twenty-Four etc.) — replace woocommerce/product-image-gallery block instead of also dumping via classic hooks
• Fix: gallery width on block themes (classic WC .images { width:48% } was shrinking WooSwipe inside the column)
• Fix: constrain thumbnail image sizing so thumbs don’t render full-width
• Fix: vertically center thumbnail nav arrows (top: 35% → top: 50% + translateY)

3.0.9

• Fix: featured-image exclusion via woocommerce_single_product_image_thumbnail_html now applies to the main image as well as thumbnails
• New: wooswipe_include_attachment filter to include/exclude gallery attachments
• Fix: PHP 8 fatals when main-slider attachments are missing image sizes
• Fix: variation image switching now matches by attachment ID (with URL fallback)
• Fix: hide_thumbnails option correctly respected for simple products
• Fix: PhotoSwipe item building bugs and duplicate lightbox entries
• Fix: JS no longer double-wraps main image markup
• Fix: admin settings save — nonce verification, manage_options capability, sanitised colour fields
• Fix: default options seeded on activation; options removed on uninstall
• Fix: frontend assets only load on product pages and [product_page] shortcode contexts
• Fix: use current WooCommerce image size names (woocommerce_single, woocommerce_gallery_thumbnail)
• Security: escape URLs and attributes in gallery markup
• Compatibility: tested with WordPress 7.0 and WooCommerce 10.9

3.0.8

• Readme update
• Tested with WP 6.7.1 + WC 7.0.0

3.0.3

• Major update to address minor security issues
• Recoded with new plugin framework
• Fixed the array_merge() fatal error for the empty featured image
• Updated the plugin’s structure with the boilerplate
• Fixed the Auth Broken Access Control Vulnerability
• Handled the multiple cases regarding empty images for (Featured image, Gallery images & Variation images)
• Updated the script for the variation change & swatches change

2.0.1

• Elementor plugin fix
• Added option for the slide navigation arrows

2.0

• Major update
• New touch slider carousel option for the main image
• New icon colour selector options
• Option to hide thumbnails

1.1.13

• Added option for hiding thumbnails when no product gallery or product variation image is available
• Remove lazy loading from main image (#40)
• Accessibility fixes
• Tested with WP 5.8.2 + WC 5.9.0

1.1.12

• Fixed wrong lightbox image when variation selected with Pinterest links
• Add product_page shortcode support (#20)
• Tested with WP 5.7.2 + WC 5.4.0

1.1.11

• Fix Pinterest select image

1.1.10

• PHP notice fix

1.1.9

• Layout fix and image size fix

1.1.8.11

• Version bump slick.js 1.5.7 → 1.8.1

1.1.8.10

• Readme updated with latest way to adjust image sizes

1.1.8.9

• Revert PR38

1.1.8.8

• Compatibility for WooCommerce Variation Swatches and Photo up to v3.1.1
• Merged PR #38 — add variation id for thumbnails

1.1.8.7

• Readme and latest compatibility check

1.1.8.6

• Rollback bug fix

1.1.8.5

• SVG Pinterest image
• Meta text update

1.1.7.0

• Add Pinterest option
• Merged pull request pinit branch

1.1.6.9

• Variation image bug fix #27
• Skip repeated images from gallery and variation
• Minor restructure and tidy up

1.1.6.8

• Meta update and testing with WP v5
• Merged pull request from @matthijs166 #28

1.1.6.7

• Added alt tag to main image

1.1.6.6

• Readme
• z-index increase

1.1.6.5

• Fixed image change bug with variation selector
• Removed file

1.1.6.3

• Fixed depreciation notice of get_gallery_attachment_ids

1.1.6.2

• Readme docs update

1.1.6

• Fix Undefined variable: zoomed_image_size

1.1.4

• BJ Fixed Hooks Bug

1.1.3

• BJ Added hooks and filter

1.1.1

• Rewrite JS
• Fix image change bugs

1.0.5

• Style clear

1.0.4

• Style fix

1.0.3

• White Skin update

1.0.2

• Fix for missing srcset

1.0.1

• First version