Skip to content
WPPoland Documentation

Getting started

Most shops can show a working quick view in a few minutes. Peek ships enabled with sensible defaults — install, open the Peek menu, visit the shop page.

Before you start

Section titled “Before you start”
  • WordPress 6.5 or newer
  • WooCommerce 8.0 or newer (HPOS and Cart/Checkout Blocks supported)
  • PHP 8.1 or newer

Install

Section titled “Install”
  1. Install WooCommerce and make sure it is active.
  2. Install Peek from the plugin directory (when live on WordPress.org) or upload the peek folder to /wp-content/plugins/.
  3. Activate the plugin.

No wizard is required — the quick-view button can appear on the next shop page load.

First configuration

Section titled “First configuration”

Open Peek in wp-admin:

  • Enable quick view — master switch; when off, nothing loads on the storefront.
  • Button label — e.g. “Quick view” or “Peek inside”; used on the trigger and as the accessible name for icon-only style.
  • Button style — text only (safest for most themes), icon only (compact grids), or icon + text (clearest call to action).
  • Button placement — Below product card keeps card height predictable; On image (hover / focus) overlays the thumbnail and stays out of the way until the shopper hovers or tabs to the product.
  • Where to load — shop and archives only, or also related/upsell loops on single product pages.
  • Modal content — pick what the AJAX fragment shows (gallery limit, SKU, stock, add-to-cart, etc.).

Save changes on the settings screen. You do not need to flush permalinks for label updates.

Verify on the shop page

Section titled “Verify on the shop page”
  1. Open Shop (or a category archive).
  2. Confirm a Quick view button appears on each product card (placement depends on your setting).
  3. Click it — the modal should open, show a loading state, then the product fragment.
  4. Tab through the dialog, close with Escape or the backdrop, and confirm focus returns to the trigger.
  5. On a variable product, pick options in the modal and add to cart if enabled.

If the button is missing, check that quick view is enabled and that you are on a supported loop (not the single product template itself).

Shortcode triggers

Section titled “Shortcode triggers”

Place a trigger outside the default loop:

[peek id="123"]
[peek id="123" text="Preview" style="icon_text"]

[peek_quick_view] accepts the same attributes. When a shortcode is present, Peek enqueues assets on that request even if the normal shop hook did not run.

Overlay mode tips

Section titled “Overlay mode tips”

Overlay triggers appear on hover and :focus-within so keyboard users still reach them. With prefers-reduced-motion, the button stays visible instead of fading in — no hidden controls for motion-sensitive shoppers.

Free vs PRO

Section titled “Free vs PRO”

The free edition covers the AJAX modal, variation-aware add-to-cart, overlay/below placement, shortcodes and full settings.

Peek PRO (planned) adds variation swatches in the modal, a related-products carousel, custom modal sections and quick-view analytics — not basic modal access.

Need help?

Section titled “Need help?”