Skip to content
WPPoland Documentation

Peek

Peek adds a quick view button to WooCommerce shop and archive loops. Clicking it opens an accessible modal that loads the product over AJAX — gallery, price, variations and add-to-cart — without leaving the listing.

Why stores pick Peek

Section titled “Why stores pick Peek”

Peek keeps shoppers in the catalog: they preview, compare and add to cart from the grid. The modal is focus-trapped, loads with vanilla JS in the footer, and stays hidden until opened so the page never jumps. The free edition is the complete quick view under GPL.

Highlights

Section titled “Highlights”
  • AJAX modal on shop, category, tag and taxonomy loops — no full navigation to the product page.
  • Full product preview: featured image, gallery, title, SKU, price, stock, short description, add-to-cart (with variations) and a link to the full product page.
  • Button placement: below the product card (default) or on-image overlay that appears on hover and keyboard focus — compact image-led grids.
  • Shortcodes [peek] and [peek_quick_view] — place a trigger anywhere, e.g. [peek id="123" text="Preview"].
  • Configurable modal sections — turn each block on or off from the Peek settings screen; empty fields hide automatically.
  • No jQuery in Peek’s own script — deferred footer JS; WooCommerce’s variation script loads only when needed.
  • No layout shift — closed modal is fully hidden; opening overlays the page instead of reflowing it.
  • Accessible dialog — focus trap, Escape and backdrop close, role="dialog" with aria-modal.

Settings at a glance

Section titled “Settings at a glance”

Open Peek in wp-admin:

  • Master toggle and trigger label.
  • Button style: text, icon only, or icon + text.
  • Where the trigger sits in loops: below the card or on the product image.
  • Where assets load: shop/archives only, or also related/upsell loops on single product pages.
  • Modal chrome: title, close button, loading/error copy, backdrop close.
  • Content toggles: image, gallery limit, title, SKU, price, stock, short description, add-to-cart, view-product link.

Each control includes inline help — hover the ? affordance when you are unsure.

Engine

Section titled “Engine”

Quick-view orchestration (AJAX, nonce, asset enqueue, loop hooks) lives in the shared wppoland/storefront-kit QuickView engine. Peek is a thin adapter for text domain, options, asset URLs and WooCommerce fragment markup.

Editions

Section titled “Editions”
  • Free on WordPress.org — the accessible AJAX quick view, overlay placement and shortcodes.
  • Pro (planned) for variation swatches in the modal, a related-products carousel, custom sections and quick-view analytics.

Polski overlap

Section titled “Polski overlap”

Polski includes quick view. Do not install Peek if that module is enabled. See Standalone storefront plugins in Polski.

Next steps

Section titled “Next steps”