=== Quick View for WooCommerce – Storzen  ===
Contributors: devhasib
Tags: quick view, ajax quick view, product popup, woocommerce quick view, WooCommerce popup
Requires at least: 6.3
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.1.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Requires Plugins: woocommerce

Fast WooCommerce Quick View & AJAX Product Previews. Boost sales and UX by letting customers view details instantly without page reloads.

== Description ==

**Quick View for WooCommerce** is a lightweight and fast product quick view plugin that allows customers to instantly preview products in a popup modal without leaving the shop page.

Instead of navigating back and forth between product and shop pages, users can quickly view product details, images, and add items to cart in a smooth AJAX-powered experience.

This improves WooCommerce store usability, reduces page reloads, and increases conversion rates. Perfect for modern eCommerce stores that want a faster, cleaner, and more engaging shopping experience.

**Lightweight and fast WooCommerce quick view plugin that works with any WooCommerce theme.**

**[View Documentation](https://storzen.webtend.net/storzen-quickview-doc.html)**


**Why Use WooCommerce Quick View?**

WooCommerce stores often lose customers due to slow navigation between product pages.

WooCommerce Quick View solves this by enabling:

* Instant product preview popup (no page reload)
* AJAX-powered quick view for WooCommerce products
* Faster shopping experience with reduced friction
* Improved user engagement and product exploration
* Mobile-friendly product modal experience
* Lightweight performance with minimal load impact

---


### Key Features

**Instant Product Preview Popup**
A smooth modal opens on click or hover — displaying product image gallery, title, category, price, stock badge, star rating with review count, short description, quantity selector (with variation support), Next/Previous navigation arrows, and Add to Cart button — all without a page reload.

**Quick View Button on Shop & Category Pages**
Automatically adds a customizable "Quick View" button to every product card on your shop, category, and archive pages.

**Works with Any WooCommerce Theme**
Built to be fully compatible with all standard WooCommerce themes right out of the box — no extra configuration needed.

**Full Design Control — No CSS Required**
Use the built-in settings panel to customize:

* Button background color & text color
* Button border radius
* Modal popup width
* Button label text & position (on image / below title / below price)

**Quantity Selector in Popup**
Customers can choose how many units to buy directly in the popup using +/− buttons before adding to cart — no need to visit the product page just to change quantity.

**Star Rating with Review Count**
The product's average star rating and total review count are displayed inside the popup. Social proof at the decision moment is proven to boost conversions.

**Product Category Badge**
The product category is shown as a linked badge above the title. Helps shoppers understand where a product fits without navigating away.

**Product Image Gallery in Popup**
A thumbnail strip below the main image lets shoppers browse all product photos without leaving the popup. Click any thumbnail to swap the main image instantly — no extra AJAX request, no page reload.

**Stock Availability Badge**
A colour-coded badge below the price shows "In Stock" (green) or "Only N left!" (amber) at a glance. Urgency cues at the decision moment are proven to lift conversion rates. The low-stock threshold is filterable via `storzen_qv_low_stock_threshold`.

**Next / Previous Product Navigation**
Arrow buttons inside the popup let shoppers browse to the next or previous product in the same category — without closing the modal or reloading the page. Keeps shoppers in the discovery flow and reduces bounce. Pro upgrade unlocks custom navigation order (price, popularity, newest) and keyboard arrow key support.

**Checkout Redirect After Add to Cart**
A simple toggle sends shoppers directly to the checkout page after adding a product to cart from the popup — no extra steps, no friction. Ideal for single-product stores and ad campaign landing pages. Pro upgrade adds a configurable delay and custom redirect URL.

**Variable Product Support**
Variation dropdowns (size, colour, and any custom attribute) render inside the Quick View popup for variable products. WooCommerce updates the price, stock, and Add to Cart button live as the shopper makes selections — no page visit required.

**Shortcode Support**
Place a Quick View button anywhere with `[storzen_quick_view id="123"]`. Works in Gutenberg blocks, Elementor, Divi, classic editor, and any widget area. Ideal for featured product sections and custom landing pages.

**Hover or Click Trigger**
Choose whether the Quick View popup opens on button click (default) or automatically after the cursor rests on the button for a moment. Hover mode is ideal for discovery-focused stores where shoppers browse quickly. Fully accessible — click always works as a fallback.

**Popup Open Animation Presets**
Pick from four popup entry animations — Slide up, Fade, Zoom in, or None — directly from the Design settings panel. Pure CSS, zero extra libraries. Works alongside all themes without conflict.

**Choose Where the Button Appears**
Control which pages show the Quick View button — shop page, category pages, or both.

**Disable on Mobile**
A one-click toggle hides the Quick View button on mobile devices — ideal for stores with mobile-optimised checkout flows.

**Mobile Responsive**
The popup is fully responsive and optimized for phones, tablets, and desktops.

**Lightweight & Performance-Friendly**
CSS and JavaScript load only on pages where the Quick View button is displayed — zero bloat on the rest of your site.

**Keyboard Accessible & Screen Reader Friendly**
Focus trap, Escape key support, and ARIA labels are included for full accessibility compliance.

---

### Perfect For

* Fashion & clothing stores with size/color variants
* Electronics & gadget shops with detailed specs
* Large WooCommerce catalogs where browsing speed matters
* Any store focused on improving conversion rate optimization (CRO)

---

### How It Works

1. User hovers or clicks on a product  
2. Quick view button opens a popup modal  
3. Product details load instantly via AJAX  
4. User can view images, price, and description  
5. Add to cart without leaving the shop page

That's it. Shortcode also available: `[storzen_quick_view id="123"]` for Elementor, Gutenberg, and any page builder.

---




== Installation ==

1. Upload the plugin folder to the `/wp-content/plugins/` directory, or install directly from the WordPress Plugin Directory.
2. Activate the plugin through the **Plugins** screen in WordPress.
3. Ensure WooCommerce is installed and active.
4. Go to **Storzen Quick View** to configure button text, position, display options, and design tokens.
5. Visit your shop page — the Quick View button will appear automatically on product cards.

== Frequently Asked Questions ==

= Where can I find the documentation? =

Full documentation is available at **[https://storzen.webtend.net/storzen-quickview-doc.html](https://storzen.webtend.net/storzen-quickview-doc.html)**

= Does this plugin require WooCommerce? =

Yes. WooCommerce must be installed and active for Storzen Quick View to work.

= Does it work with variable products (size, color, etc.)? =

Yes. Since v1.1.5, variation dropdowns (size, colour, and any custom attribute) render directly inside the Quick View popup. WooCommerce updates the price, stock status, and Add to Cart button live as the shopper selects options — no page visit required.

= Will it slow down my store? =

No. Storzen Quick View only loads its CSS and JavaScript on shop, category, and product pages where the button is shown.

= Does it work on mobile? =

Yes. The popup is fully responsive and optimized for all screen sizes.

= Which themes are supported? =

It works with most well-coded WooCommerce themes. If you experience a styling conflict, please open a support ticket and we will help you resolve it.

= Can I change the button text and position? =

Yes. Go to **Storzen QuickView** in your WordPress admin. You can change the button text, set the button position (on image, below title, or below price), and choose which pages to show it on.

= Can I customise the button colours and modal size? =

Yes — use the **Design** tab in the settings page. Colour pickers let you choose button background and text colours; number inputs control the border radius and modal width. All customisation is done through structured controls — no CSS editing required.

= Is the modal keyboard accessible? =

Yes. The modal traps focus, supports Escape key to close, and includes ARIA labels for screen reader compatibility.


== Screenshots ==

1. Quick View button on product cards in the shop loop
2. Product popup showing image, price, and Add to Cart
3. Design panel with colour pickers and size controls


== Upgrade Notice ==

= 1.1.6 =
Adds Next/Previous navigation arrows (browse products without closing the popup) and a checkout redirect toggle. Pro lock rows preview upcoming advanced options. Safe to update — existing settings preserved.

= 1.1.5 =
Adds variable product support (variation dropdowns with live price/stock update inside the popup) and shortcode support (`[storzen_quick_view id="123"]` for Elementor, Gutenberg, and page builders). Safe to update — all existing settings are preserved.

= 1.1.4 =
Adds hover trigger mode (open popup on hover instead of click) and four popup open animation presets (Slide up, Fade, Zoom in, None). Both are configurable from the settings panel. Safe to update — existing settings are preserved and defaults remain unchanged (click trigger, slide-up animation).

= 1.1.3 =
Adds product image gallery with thumbnail strip and a stock availability badge (In Stock / Only N left!) inside the Quick View popup. Also adds two new Display toggles to control these features. Safe to update — both features are enabled by default, all existing settings are preserved.

= 1.1.2 =
Adds quantity selector, star rating + review count, and product category badge inside the Quick View popup. Also adds a "Show product category" toggle in Display settings. Safe to update — all new features are enabled by default, existing settings are preserved.

= 1.1.1 =
Plugin renamed to "Storzen QuickView for WooCommerce". Added uninstall.php for proper data cleanup. Performance improvement: plugin settings no longer autoloaded on every page. Safe to update — no settings are changed.

== Changelog ==
= 1.1.6 =
* Added Next/Previous product navigation — arrow buttons inside the popup allow shoppers to browse same-category products without closing the modal; Pro advanced options (custom order, keyboard navigation) shown as locked upgrade prompts.
* Added checkout redirect toggle — when enabled, shoppers are sent directly to the checkout page after adding a product to cart from the popup; Pro advanced options (redirect delay, custom URL) shown as locked upgrade prompts.
* Added `get_neighbor_ids()` helper in AJAX class — finds prev/next product IDs by category using WP_Query.
* Added Pro lock UI to admin settings panel — locked rows with upgrade link for advanced Next/Prev and redirect options.
* Version bumped to 1.1.6.
= 1.1.5 =
* Added variable product support — variation attribute dropdowns render inside the Quick View popup; WooCommerce JS updates price, stock, and Add to Cart button live on selection.
* Added shortcode support — `[storzen_quick_view id="123"]` renders a Quick View button anywhere (Gutenberg, Elementor, Divi, widgets, templates).
* Assets now also enqueue on pages containing the shortcode.
* Version bumped to 1.1.5.
= 1.1.4 =
* Added hover trigger mode — popup can now open automatically after the cursor rests on the Quick View button, configurable via General settings.
* Added popup open animation presets — four options (Slide up, Fade, Zoom in, None) selectable from the Design settings panel; implemented with pure CSS keyframes.
* Added `trigger_mode` and `modal_animation` settings with allowlist validation.
* Version bumped to 1.1.4.
= 1.1.3 =
* Added product image gallery — thumbnail strip below the main image allows shoppers to browse all product photos inside the popup with a click-to-swap interaction.
* Added stock availability badge — shows "In Stock" (green) or "Only N left!" (amber) below the price; urgency cue drives conversions.
* Added "Show product gallery" toggle in Display settings.
* Added "Show stock badge" toggle in Display settings.
* Added `storzen_qv_low_stock_threshold` filter to customise the low-stock quantity threshold (default: 5).
* Version bumped to 1.1.3.
= 1.1.2 =
* Added quantity selector (+/− buttons) in the Quick View popup for simple products — customers can choose quantity before adding to cart.
* Added star rating with review count in the popup — links to the product review section for social proof at the decision moment.
* Added product category badge above the product title — linked to the category archive to help shoppers navigate.
* Added "Show product category" toggle in Display settings.
* Updated Display settings description for the rating toggle to reflect the new review count.
* Version bumped to 1.1.2.

= 1.1.1 =
* Renamed plugin to "Storzen QuickView for WooCommerce" across all strings, admin menu, and UI header.
* Fixed version constant mismatch (STORZEN_QV_VERSION was '1.1.0', now correctly '1.1.1').
* Added `uninstall.php` for WordPress.org compliance — removes plugin options on uninstall when opted in.
* Performance optimized.


= 1.1.0 =
* Replaced arbitrary Custom CSS textarea with structured Design controls (button colour pickers, border-radius, modal width) to comply with WordPress.org plugin guidelines.
* Custom CSS is now generated programmatically from validated design tokens — no freeform code is stored or injected.
* Existing installs are automatically migrated: the `custom_css` option is removed and new design-token defaults are written on plugin activation.
* Added wp-color-picker integration in the admin for colour fields.
* Added live preview swatch in the Design panel.

= 1.0.0 =
* Initial release.
* Quick View button on shop, category, and related product loops.
* AJAX-powered modal with product image, title, price, rating, excerpt, and Add to Cart.
* Settings page: button text, position, and display page control.
* Mobile responsive modal.
* Keyboard accessible (focus trap, Escape to close, ARIA labels).
* Compatible with WooCommerce 8.x and WordPress 6.x.
