=== 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: 10.9
Stable tag: 3.0.10
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
* `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.

== Screenshots ==

1. Default gallery layout
2. Popup / lightbox layout

== Changelog ==

= 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.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.