=== Comet LevelUp for WooCommerce ===
Contributors: wpcomet
Donate link: https://wpcomet.com
Tags: woocommerce, product gallery, checkout, performance, buy now
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
WC requires at least: 6.0
WC tested up to: 11.1
Stable tag: 1.1.7
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

The modern Swiss Army Knife for WooCommerce — high-converting product galleries, frictionless checkout, and store performance enhancements.

== Description ==

**Comet LevelUp for WooCommerce** is a high-performance conversion and polish suite for WooCommerce stores. It upgrades your single product pages, checkout flows, and catalog browsing without heavy page builders or slow third-party scripts.

Built with modern **PSR-4 Object-Oriented PHP** and **Vanilla JavaScript**, Comet LevelUp adds zero frontend bloat. Features are modular and lazy-loaded only when enabled.

---

### 🛍️ High-Converting Product Galleries

* **Modern Gallery Layouts**: Choose from Bottom Carousel, Left Thumbnails (Nike Style with sticky rail + floating index pill), Dual Grid (Nike Classic), Apple Showcase (frosted glass pill dots), Editorial Mosaic (Farfetch/SSENSE asymmetric magazine spread), Filmstrip Scroll (Lululemon horizontal snap + live progress bar), Right Thumbnails, Vertical Stack (Zara style), and Hero + Mosaic (Gymshark style).
* **Aspect Ratio Control**: Maintain uniform image aspect ratios (1:1, 4:5, 3:4, 16:9, or natural) across your entire catalog.
* **Built-in Lightbox & Deep Zoom**: High-resolution image zoom and smooth fullscreen lightbox without extra jQuery libraries.
* **Product Video Embeds**: Seamlessly display self-hosted and streaming product videos alongside photos.
* **Sticky Product Summary**: Keeps product title, pricing, and Add to Cart visible as users scroll long image galleries.

---

### 💳 Frictionless Cart & Checkout

* **Auto-Update Cart on Quantity Change**: Eliminates the outdated "Update Cart" button by updating totals dynamically via AJAX.
* **Remove Zero Quantity Items**: Automatically cleans up zeroed-out line items on cart adjustments.
* **Hide Shipping When Free**: Automatically conceals paid shipping options when Free Shipping criteria are satisfied.
* **Instant Buy Now Button**: Direct 1-click checkout bypassing the cart step.
* **Uncheck "Ship to a Different Address" by Default**: Reduces checkout friction and form clutter.

---

### ⚡ Catalog Polish & Store Speed

* **Equalize Card Heights**: Aligns shop grid cards neatly across fluctuating title lengths and imagery.
* **Catalog Mode**: Switch your store to a view-only catalog with a single toggle when needed.

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/comet-levelup/`
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Navigate to **WooCommerce → LevelUp ⚡** to configure your store features

== Frequently Asked Questions ==

= Does Comet LevelUp add frontend bloat or slow down my store? =
No. Comet LevelUp is strictly engineered with modern PSR-4 PHP and pure Vanilla JavaScript. It uses zero jQuery on the front-end, no bulky third-party slider libraries (no Slick, no Swiper), and all modules are lazy-loaded only when explicitly enabled in settings.

= Will this conflict with Elementor or other page builders? =
No. Comet LevelUp includes an intelligent Builder Protection Boundary (`is_builder_or_admin()`). When an Elementor editor or preview session is detected (`elementor-preview`), or within the WordPress Customizer, the plugin automatically yields and preserves native builder templates.

= Is Comet LevelUp compatible with WooCommerce HPOS (High-Performance Order Storage)? =
Yes! Comet LevelUp explicitly declares compatibility with WooCommerce HPOS (Custom Order Tables) and Cart/Checkout Blocks via `Automattic\WooCommerce\Utilities\FeaturesUtil`.

= How does the Aspect Ratio Lock eliminate Cumulative Layout Shift (CLS)? =
Core Web Vitals often suffer when high-resolution images load and push down surrounding content. Comet LevelUp pre-allocates CSS container aspect ratios (such as 1:1 square, 4:5 portrait, or 16:9 landscape) with `object-fit: cover`, ensuring zero visual jumping as images stream in.

= Can I bypass Comet LevelUp for debugging? =
Yes! You can append `?disable-comet-levelup` or `?comet-levelup=off` to any front-end URL to temporarily bypass LevelUp's modules and inspect native WooCommerce behavior.

== Screenshots ==

1. **Modern Product Gallery Suite**: Visual layout preset picker with interactive wireframes for curated layouts including Left Thumbnails (Nike Style), Dual Grid (Nike Classic), Apple Showcase, Editorial Mosaic, Filmstrip Scroll, and carousels.
2. **Dimension & Split Ratio Controls**: Aspect ratio locking for CLS prevention and interactive 2-column width split slider between gallery and product buy box.
3. **Cart & Checkout Superchargers**: Instant AJAX auto-update cart, zero-quantity removal, smart free shipping rate hiding, and 1-click Buy Now button.
4. **Live Diagnostic Suite**: Real-time automated tests verifying WordPress Admin context, Elementor builder isolation, and dual-boundary invariants.

== Changelog ==

= 1.1.7 =
* Approved: Official WordPress.org repository initial release.
* Fix: Migrated all inline scripts and styles to standard WordPress core enqueue APIs (wp_add_inline_script and wp_add_inline_style).
* Polish: Scoped zero-dependency admin theme initialization and responsive layout enhancements.

= 1.1.3 =
* Feature: Support for WooCommerce Cart/Checkout Blocks in Presentation Mode (intercepting block checkout order placement).
* Polish: Scoped notification suppression on LevelUp admin screens.
* Compatibility: Auto-sync and validation for WordPress 7.1+ and WooCommerce 11.x+.

= 1.1.1 =
* Enhancement: Multi-mode presentation controls (Showroom disabled state, complete hiding, or checkout blocking).
* UI: Visual preset tile cards for catalog button action modes.

= 1.1.0 =
* Feature: Responsive gallery-to-summary column split controls.
* Diagnostics: Dual-boundary invariant tests for builder/admin isolation.

= 1.0.1 =
* Certified: Full WordPress Plugin Check (PCP) zero-defect compatibility.
* Feature: Automated activation redirect directly to WooCommerce LevelUp settings.
* Enhancements: Hardened escaping, translation annotations, and scoped Bulma styling.
* Diagnostics: Complete 8-point automated live diagnostic test suite with Dual-Boundary Invariant verification.
* Performance: Lazy-loaded gallery and checkout enhancement modules.

= 1.0.0 =
* Initial public release.
