Skip to content

Configuration

Peek is configured from one screen: the Peek menu in wp-admin. It opens with sensible defaults, so you only change what you need. Settings fall into four groups — the master switch, the trigger button, where assets load, and what the modal shows.

The master switch. When off, Peek loads nothing on the storefront — no button, no script, no styles. Turn it on to render the trigger in your product loops.

The text shown on the trigger, for example Quick view or Peek inside. For the icon-only style this label is still used as the accessible name, so screen-reader users always hear a meaningful action.

  • Text — a plain text button. Safest for most themes and the clearest call to action.
  • Icon — an icon only, for compact image-led grids. The label above becomes the accessible name.
  • Icon + text — both, the most explicit option.
  • Below the product card — the trigger sits under each card. Card height stays predictable across the grid.
  • On the product image (hover / focus) — the trigger overlays the thumbnail and appears on hover and on keyboard focus, keeping dense grids clean until the shopper reaches for it.

Choose the loops Peek attaches to:

  • Shop and product archives only — the shop page plus category, tag and taxonomy archives.
  • Also single-product related / up-sell loops — additionally render the trigger in the related-products and up-sell sections on single product pages.

Peek never adds a trigger to the single product template itself — that page is already the full product.

These controls govern the dialog frame around the product fragment:

  • Modal heading — show or hide the product title as the dialog heading.
  • Close button — show or hide the close control, and set its accessible label.
  • Backdrop-click close — allow closing by clicking outside the dialog.
  • Loading text and error text — copy shown while the AJAX fragment loads and if it fails.
  • View-product link text — label for the link to the full product page.
  • SKU label — the prefix shown before the SKU in the modal.

Pick which parts of the product render in the AJAX fragment. Each is an independent toggle, and empty fields hide themselves automatically:

  • Featured image
  • Gallery — with a configurable thumbnail count (0–12)
  • Title
  • SKU
  • Price
  • Stock status
  • Short description
  • Add-to-cart — including the variation form on variable products
  • View-product link

Every control carries a ? affordance. Hover or focus it for a short explanation in context, so you can tune the screen without leaving it.

Changes save on the settings screen and take effect on the next page load. Label and copy updates need no permalink flush or cache rebuild.