=== Storzen – Elementor Builder with Widgets & Conversion Modules for WooCommerce ===

Contributors: devhasib
Tags: woocommerce, elementor, wishlist, variation swatches, woocommerce conversion
Requires at least: 6.5
Tested up to: 7.0
Requires PHP: 8.1
Stable tag: 1.1.3
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

All-in-one WooCommerce growth toolkit — 46+ Elementor widgets, variation swatches, wishlist, back in stock alerts & more.

== Description ==

**Storzen** is a performance-first WooCommerce growth toolkit that gives Elementor store builders everything they need in a single, lightweight plugin.

Replace multiple WooCommerce plugins with Storzen — an all-in-one conversion toolkit featuring variation swatches, wishlist, sticky add-to-cart, quick view, product comparison, free shipping bar, flash countdown, stock scarcity, sale notifications, sale badges, and **46+ Elementor widgets** for every WooCommerce page — including standalone Product Reviews, Product Stock, and Upsell Products widgets.

Every feature is individually toggleable. Disabled features load **zero** CSS, JS, or PHP — no dead weight on your store.

 **[Documentation](https://webtend.net/docs/storzen-docs.html)** |  **[Storzen Pro](https://storzen.webtend.net/)** | **[Live Demo](https://storzen.webtend.net/shop-page/)**

---

= ⚡ Why Store Owners Choose Storzen =

**One plugin. Everything you need.**
Install Storzen and remove the fragmented plugin stack you've been maintaining. Swatches, wishlist, sticky cart, quick view, social proof popups — all built in, all free.

**Zero overhead for what you don't use.**
Toggle a module off and it vanishes completely — no enqueued styles, no registered hooks, no database reads. Most WooCommerce plugin bundles can't say that.

**Built for conversions, not just features.**
Every module and widget is designed around a proven UX pattern that reduces friction, builds urgency, or lifts average order value.

**Elementor-native from the ground up.**
Six dedicated Elementor categories. Full control over layout, typography, colors, and spacing from the live editor — no shortcodes, no custom CSS required.

---

= 🧩 30+ Elementor Widgets for Every WooCommerce Page =

Storzen registers six dedicated Elementor widget categories so you can build any WooCommerce page visually with full design freedom.

**Shop Widgets**
* Product Card — 3 selectable card styles (Standard, Minimal, Bold)
* Archive Products Grid — auto-detects shop, category, and tag archives
* Product Grid — manual grid with category, tag, and ordering filters
* Product Carousel — touch-friendly Swiper slider
* Tab Products — category-tabbed product showcase
* List Products — compact comparison-style layout
* Shop with Sidebar — grid plus live-filter sidebar in one widget

**Single Product Widgets**
* Product Title, Price, Rating, Meta, Description, Gallery
* Add to Cart button with AJAX support
* Sticky Add to Cart Bar (inline Elementor control)
* Buy Now button
* Related Products slider
* Realtime Visitor Counter
* Product Service Info & Utility Links block

**Cart Widgets**
* Cart Table
* Cart Totals
* Cart Coupon
* Mini Cart

**Checkout Widgets**
* Full Checkout Form widget
* Checkout layout customization controls

**Thank You Page Widgets**
* Order summary, customer details, and upsell placements

**My Account Widgets**
* Account Login form
* Dashboard navigation & content areas

---

= 🚀 11 Free Conversion Modules =

Each module is independent, individually toggleable, and ships with its own settings panel (General, Display, and Behavior tabs). Enable only what your store needs.

**Variation Swatches**
Replace WooCommerce's plain dropdowns with color swatches, image swatches, or button swatches on variable products. Supports tooltip preview, out-of-stock cross-out, and custom swatch sizes.

**Sale Notification (Social Proof Popups)**
Display real recent-purchase popups to build buyer confidence. Configurable with real WooCommerce order data or virtual demo data. Control position, timing, delay, and animation.

**Quick View**
Let shoppers preview products — gallery, variations, add-to-cart — in a lightbox modal without leaving the shop page. Reduces the back-button friction that kills conversions.

**Sale Badge**
Automatically display Hot, New, and Sale percentage badges on product cards. Configure label text, colors, and badge shape from the settings panel.

**Wishlist**
Let customers save products to a wishlist without creating an account. Supports both guests (cookie-based) and logged-in members. Shareable wishlist URL included.

**Compare Products**
Add a side-by-side product comparison table. Customers pick products to compare; the table shows price, rating, attributes, and add-to-cart — all AJAX-powered.

**Sticky Add to Cart**
A floating product bar (image, title, price, variations, ATC + Buy Now) that appears when the native add-to-cart button scrolls out of view. Proven to recover scroll-away customers.

**Flash Sale Countdown**
Show a live countdown timer on product pages and shop cards, powered by WooCommerce's built-in sale end date field. No extra meta setup required.

**Free Shipping Progress Bar**
Show customers exactly how much more they need to spend to unlock free shipping. Proven to increase average order value. Updates live as customers add items to cart.

**Stock Scarcity Messages**
Automatically show "Only X left in stock!" urgency messages based on real WooCommerce stock data. Configure thresholds, message wording, and styling.

**Back in Stock Notifier**
Let shoppers subscribe to email alerts when an out-of-stock product (simple or variable) becomes available again. Features double opt-in confirmation, GDPR consent checkbox, shareable unsubscribe link, batched WP Cron notification sends, an admin subscriber list with CSV export, and full GDPR Personal Data export/erasure support. Zero third-party dependencies — powered entirely by WordPress and WooCommerce.

---

= 📄 Ready-to-Import Elementor Templates =

Storzen ships with professionally designed Elementor page templates for every WooCommerce page — import with one click from the admin panel:

* **Shop Page** (standard layout)
* **Shop Page with Search** (search-first layout)
* **Single Product** — 3 distinct layout styles
* **Cart Page**
* **Checkout Page**
* **Thank You Page**
* **My Account Page**

---

= 🔒 Performance & Security =

**Toggle-based loading — OFF means truly OFF.**
Disabled widgets are never registered with Elementor. Disabled modules never load their PHP class, never enqueue CSS or JS, and never touch the database. This is enforced at the bootstrap level, not just a conditional check.

**Secure AJAX handling.**
All AJAX endpoints are protected with WordPress nonces and `current_user_can()` capability checks. Every database query uses `$wpdb->prepare()`.

**No external requests.**
The free plugin makes zero outbound network calls — no telemetry, no license pings, no analytics.

**HPOS compatible.**
Storzen uses WooCommerce CRUD methods throughout and declares High-Performance Order Storage (HPOS) compatibility.

---

= 🛠 Developer Friendly =

* **Translation-ready** — all strings use the `storzen` text domain; `.pot` file included
* **Template overrides** — copy any file from `plugins/storzen/templates/` or `plugins/storzen/woocommerce/` to your theme for full customization
* **Action & filter hooks** — extend widget definitions, module lists, and output without touching plugin files
* **WPCS-compliant codebase** — follows WordPress and WooCommerce coding standards throughout
* **PSR-4 autoloader** — bundled admin framework uses a clean autoloaded structure

---

= 🔓 Storzen Pro =

[Storzen Pro](https://storzen.webtend.net/) adds advanced features for stores that need more:

* **AJAX Sidebar Filters** — live filter by search, categories, attributes, stock status, and ratings — no page reload
* **Full Single Product Widget Set** — rating stars, tabs, share buttons, and more
* **Cart & Checkout Drawer Widgets** — slide-in cart drawer and checkout layout widgets
* **Full My Account Widget Set** — complete account page visual builder
* **Cart Module** — AJAX add-to-cart, mini-cart drawer, cross-sell popup
* **Pre-Order Module** — accept orders for out-of-stock products before they arrive
* **Quick Checkout Module** — one-click checkout modal to reduce cart abandonment
* **Floating Cart Module** — persistent floating cart icon with live item count
* **Currency Switcher Module** — multi-currency support for international stores
* **PDF Invoice Module** — auto-generate branded invoices attached to order emails
* Priority support

All free settings carry over to Pro automatically — no re-configuration needed.

---

== Frequently Asked Questions ==

= Do I need both WooCommerce and Elementor? =

Yes. Storzen requires both WooCommerce (for store data) and Elementor (for widget rendering). If either is missing or outdated, Storzen shows an admin notice and gracefully self-disables widget registration without breaking your site.

= Will Storzen slow down my site? =

No. Storzen uses a strict toggle-based loading system enforced at the bootstrap level. Every widget and module you leave disabled loads absolutely nothing — no PHP, no CSS, no JS, no database queries. Only enabled features have any runtime cost.

= Does it work with variable products? =

Yes. All shop and product widgets fully support variable products. The Variation Swatches module specifically enhances variable products by replacing native dropdowns with visual swatches, with full support for out-of-stock states and swatch tooltips.

= What is the difference between widgets and modules? =

**Widgets** are visual building blocks you place in Elementor (Product Grid, Product Carousel, Checkout Form, etc.). **Modules** are sitewide background features (Sale Notification, Sticky ATC, Free Shipping Bar, etc.) that work automatically once enabled — they don't require an Elementor page at all. Most stores use both: widgets for layout, modules for conversion.

= Can I customize templates and styles? =

Yes. Copy any file from `plugins/storzen/templates/` or `plugins/storzen/woocommerce/` into your theme folder (`{theme}/storzen/` or `{theme}/woocommerce/`). Your customizations survive every plugin update. For Elementor widgets, all styling is done from the widget's Style tab.

= Is Storzen compatible with HPOS? =

Yes. Storzen uses WooCommerce CRUD methods throughout and explicitly declares HPOS compatibility via the `woocommerce_feature_high_performance_order_storage_ready` filter. It works with both legacy post-based orders and the new HPOS order tables.

= Is the plugin translation ready? =

Yes. All user-facing strings use the `storzen` text domain. A complete `.pot` file is included in the `/languages/` folder. Compatible with Loco Translate, WPML, and Polylang.

= Does Storzen send data externally? =

The free plugin makes zero outbound requests — no usage tracking, no analytics, no phone-home of any kind.

= What happens to my settings when I upgrade to Storzen Pro? =

All settings carry over automatically. Storzen Pro reads the same option keys as the free version, so all widget toggles and module settings work immediately after activation. The free plugin self-disables cleanly when Pro is detected.

= Which themes does Storzen work with? =

Storzen works with any properly coded WordPress theme — classic themes, FSE/block themes, and Elementor-built themes (Hello Elementor, Astra, GeneratePress, OceanWP, etc.). Template overrides let you match any design system.

= Where can I get support? =

Free users: [WordPress.org support forum](https://wordpress.org/support/plugin/storzen/). Pro license holders: priority email support via [webtend.net](https://webtend.net/). Always include your WordPress, WooCommerce, Elementor, and PHP versions when opening a support request.

== Screenshots ==

1. **Modules Dashboard** — toggle all 11 conversion modules on or off from a single clean grid view.
2. **Elementor Widget Panel** — 30+ Storzen widgets organized into six dedicated WooCommerce categories.
3. **Variation Swatches** — color, image, and button swatches replacing native dropdowns on a variable product.
4. **Sticky Add to Cart Bar** — floating product bar with Add to Cart and Buy Now, triggered on scroll.
5. **Starter Templates Library** — one-click import for Shop, Cart, Checkout, Thank You, and My Account pages.
6. **Per-Module Settings Panel** — General, Display, and Behavior tabs for precise configuration of each module.

== Changelog ==

= 1.1.3 =
* New Widget: Trust Badges — configurable SSL, money-back, secure payment, free shipping, and 24/7 support preset badges with built-in inline SVGs (no Font Awesome required); custom image or icon option via repeater; horizontal row and grid layouts; full Elementor color, size, typography, border, and padding controls; works on checkout, cart, and product pages
* New Widget: Product Breadcrumbs — WooCommerce breadcrumb trail for Elementor product page templates via woocommerce_breadcrumb(); inherits Yoast SEO, RankMath, and AIOSEO breadcrumb overrides automatically; configurable separator, home label, and text alignment; Elementor editor preview with placeholder trail; storzen_breadcrumb_args filter for developer customisation
* Fix: WordPress.DB.SlowDBQuery.slow_db_query_tax_query warnings in class-storzen-style-grid.php and shop-sidebar-helpers.php — converted inline phpcs:ignore to reliable phpcs:disable/enable block wrappers with justification comments
* Fix: WordPress.DB.SlowDBQuery.slow_db_query_meta_key warning in shop-sidebar-helpers.php — same phpcs:disable/enable block approach
* Fix: WordPressVIPMinimum.Performance.WPQueryParams.PostNotIn_post__not_in warnings in class-storzen-module-cart-cross-sell.php (3 occurrences) — block wrapper fix
* Fix: WordPressVIPMinimum.Performance.WPQueryParams.PostNotIn_exclude warnings in product-details-elena-markup.php and product-details-storzen-markup.php — block wrapper fix
* Fix: WordPress.DB.SlowDBQuery.slow_db_query_tax_query warning in class-storzen-module-cart-cross-sell.php — block wrapper fix

= 1.1.2 =
* New Module: Back in Stock Notifier — email opt-in form on out-of-stock product pages (simple + variable); double opt-in confirmation email; GDPR consent checkbox; batched WP Cron notification sends; admin subscriber list with CSV export; WP Personal Data export/erasure hooks; custom indexed DB table; uninstall cleanup; zero third-party dependencies
* New: Product Reviews widget — standalone Elementor widget for the WooCommerce reviews section; position it anywhere on the product page independently of the Product Tabs widget
* New: Product Stock widget — real-time stock status ("Only 3 left!", "In Stock", "Out of Stock") with optional visual progress bar
* New: Upsell Products widget — upsell slider/grid powered by WC_Product::get_upsell_ids() with grid and carousel layouts, full Elementor style controls
* Fix: finalize_font_awesome_cdn() — removed duplicate condition checks that caused a double-enqueue bug on some themes
* Fix: Removed duplicate wp_dequeue_style( 'storzen-fontawesome' ) call in font awesome handler
* Fix: class_exists( 'Storzen_Pro_Init' ) now passes false as second argument to avoid triggering autoloaders
* Add: uninstall.php — all Storzen options and user meta are now cleaned up when the plugin is deleted (WordPress.org compliance)
* Update: Minimum PHP requirement bumped to 8.1
* Update: Minimum WordPress requirement bumped to 6.5
* Perf: sz-product-single-new-widgets.css is registered only and enqueued exclusively on single product pages

= 1.1.0 =
* New: Shop with Sidebar widget — combined product grid and live-filter sidebar in one Elementor widget.
* New: 3 selectable product card styles (Style One, Style Two, Style Three).
* New: Tab Products widget for category-tabbed product showcases.
* New: List Products widget for compact comparison-style product layouts.
* Improvement: All widgets fully responsive across mobile, tablet, and desktop breakpoints.

= 1.0.3 =
* Initial public release.
* 7 core Elementor widgets — Product Card, Product Grid, Archive Grid, Product Carousel, and more.
* WooCommerce template override support for cart, checkout, and quantity input.
* Translation-ready with full `.pot` file include.

== Upgrade Notice ==

= 1.1.2 =
Adds three new Elementor widgets — Product Reviews, Product Stock, and Upsell Products — plus bug fixes and performance improvements. Recommended update for all Storzen users.

= 1.1.0 =
Adds the Shop with Sidebar widget, three new product card styles, Tab Products, and List Products widgets. Fully responsive improvements across all widgets. Recommended update for all Storzen users.
