=== WooSwipe WooCommerce Gallery ===
Contributors: deanoakley, jinksi
Author: Thrive Website Design
Author URI: https://thriveweb.com.au/
Plugin URI: https://thriveweb.com.au/the-lab/wooswipe/
Donate link: https://thriveweb.com.au/
Tags: woocommerce, gallery, product gallery, photoswipe, slick
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
WC requires at least: 7.0
WC tested up to: 11.0
Stable tag: 3.0.12
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
A WooCommerce product gallery built with PhotoSwipe and Slick carousel — responsive, touch-friendly, and easy to customise.
== Description ==
WooSwipe replaces the default WooCommerce product gallery with a clean PhotoSwipe lightbox and Slick thumbnail carousel.
It works with your WooCommerce product image settings. Adjust sizes under **Appearance → Customize → WooCommerce → Product Images**. Regenerate thumbnails after changing sizes (for example with [AJAX Thumbnail Rebuild](https://wordpress.org/plugins/ajax-thumbnail-rebuild/)). If your theme registers its own image sizes, those may take priority.
= Features =
* Responsive and mobile-friendly
* Keyboard control and full-size lightbox images
* Optional main-image slider with navigation arrows
* White or dark icon theme, customisable icon colours
* Optional Pinterest pin button
* Option to hide thumbnails when there is only one image
* Works with variable products and variation images
* Supports the `[product_page]` shortcode
= Developer hooks =
**Actions**
* `wooswipe_before_main` — before the gallery markup
* `wooswipe_after_thumbs` — after the thumbnail strip
* `wooswipe_after_main` — after the full gallery
**Filters**
* `wooswipe_zoomed_image_size` — lightbox / zoom image size (default roughly 1920×1080)
* `wooswipe_include_attachment` — return `false` to exclude an attachment from the gallery
* `wooswipe_is_block_gallery` — return `true`/`false` to force block-theme (full-width-in-column) vs classic two-column layout
* `woocommerce_single_product_image_thumbnail_html` — returning an empty string for an attachment also excludes it from the main image and thumbs (see FAQ)
= Zoomed image size example =
`
add_filter( 'wooswipe_zoomed_image_size', 'wooswipe_max_image_size', 10, 1 );
function wooswipe_max_image_size( $size ) {
return 'large';
}
`
More info: [WooSwipe on Thrive](https://thriveweb.com.au/the-lab/wooswipe/) · [GitHub](https://github.com/thriveweb/wooswipe)
== Installation ==
1. Upload `/wooswipe/` to the `/wp-content/plugins/` directory, or install from Plugins → Add New.
2. Activate WooSwipe (WooCommerce must be active).
3. Optional: configure options under **WooCommerce → WooSwipe**.
4. View a product page to see the gallery.
== Frequently Asked Questions ==
= 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.
== Screenshots ==
1. Default gallery layout
2. Popup / lightbox layout
== Changelog ==
= 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
== Upgrade Notice ==
= 3.0.12 =
Fixes the product gallery stretching full width on classic themes (summary should sit beside the images). Recommended update.
= 3.0.11 =
Fixes the product gallery stretching full width on classic themes (summary should sit beside the images). Recommended update.
= 3.0.10 =
Fixes duplicate galleries on block themes (e.g. Twenty Twenty-Four). Recommended update.
= 3.0.9 =
Recommended update: featured-image exclusion, variation switching, PHP 8 safety, and admin/settings hardening. Tested with WordPress 7.0 and WooCommerce 10.9.