=== BTW Carousel for WooCommerce ===
Contributors: blacktiewms
Tags: woocommerce, carousel, product carousel, slider, gallery
Requires at least: 5.8
Tested up to: 7.0
Stable tag: 1.0.1
== Changelog ==

= 1.0.1 =
* Fixed the mobile carousel stage not displaying its background image.
* Fixed a CSS syntax issue in the desktop stylesheet.

= 1.0.0 =
* Initial release.
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A lightweight WooCommerce product carousel with a big photo stage and thumbnail strip. No jQuery. Works inside any page builder.

== Description ==

BTW Carousel for WooCommerce is a lightweight, purpose-built product carousel for any WooCommerce store. Point it at a **product category** or **tag** and it builds a large hero **stage image** with a scrollable **thumbnail strip** underneath — no manual curation required, and no jQuery or heavy slider library weighing down your site.

Most carousel plugins force one layout to awkwardly stretch across desktop and mobile. BTW Carousel builds them separately from the ground up, so each device gets a layout actually tuned for it — swipe gestures and touch-pause on mobile, hover-pause and arrow navigation on desktop.

**What makes v1.0.0 different**

Earlier carousel plugins on the market either require jQuery, force a single one-size-fits-all layout, or lock basic features behind a paid tier. BTW Carousel for WooCommerce ships with none of those trade-offs: plain JavaScript only, genuinely separate desktop/mobile rendering, and every feature below fully usable for free.

**Key features**

* Query mode: pulls products automatically from a chosen category or tag, sorted by date, price, or popularity — no manual picking of products required
* Separate, purpose-built desktop and mobile layouts, each tuned for its device rather than one layout squeezed to fit both
* No jQuery and no heavy slider library dependency — small footprint, built with plain JavaScript
* Autoplay with hover-pause (desktop) and touch-pause (mobile), plus a dwell period after a manual selection before autoplay resumes
* Swipe gesture support on the mobile stage image, in addition to the scrollable thumbnail strip
* Optional group navigation dropdown when products carry group labels
* Configurable display: show or hide the product name, price, and thumbnail labels; an optional short message shown beside the price; an optional caption shown above the thumbnail strip
* Multiple independent carousels per site, each with its own shortcode: `[btw_carousel group="Your Carousel Name"]`
* Responsive breakpoints for laptop, tablet, and mobile widths

**Requirements**

BTW Carousel for WooCommerce requires WooCommerce to be installed and active.

== Installation ==

1. Upload the `btw-carousel-core` folder to `/wp-content/plugins/`, or install directly through the WordPress Plugins screen.
2. Activate the plugin through the "Plugins" menu in WordPress.
3. Go to the "BTW Carousel" menu item in your WordPress admin sidebar.
4. Click "+ Add New Carousel", give it a name, choose a product category and behavior settings, and save.
5. Copy the shortcode shown for that carousel (e.g. `[btw_carousel group="Your Carousel Name"]`) and place it on any page or post.

== Frequently Asked Questions ==

= Does this require WooCommerce? =

Yes. BTW Carousel for WooCommerce will not activate unless WooCommerce is installed and active.

= Can I have more than one carousel on my site? =

Yes. Each carousel has its own name and its own shortcode, so you can create as many independent carousels as you like, each with different products and settings.

= Does it work inside Elementor, Divi, or other page builders? =

Yes. The shortcode can be placed inside a page builder's HTML or Shortcode widget.

= My caching plugin is showing an old version of my carousel after I changed a setting. =

If you use LiteSpeed Cache, saving a carousel's settings automatically purges the site cache so your change appears immediately. If you use a different caching plugin, you may need to manually clear its cache after changing carousel settings.

= Can I get a custom version built for my store? =

Yes. If you need something beyond what this plugin's settings support — a different layout, extra data sources, or deeper integration with your store — visit https://blacktiewms.com to order a custom build.

== Screenshots ==

1. A carousel displayed on the front end.
2. The carousel's admin settings page.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
