Peek - Product Preview for WooCommerce
| 开发者 | motylanogha |
|---|---|
| 更新时间 | 2026年10月30日 19:22 |
| PHP版本: | 8.1 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Peek adds a product quick view button to your WooCommerce shop and archive product loops, and to block Product Collection grids on any page. Clicking it opens an accessible AJAX product modal, so shoppers can preview products, choose options and add to cart without leaving the listing.
The modal shows the featured image and gallery thumbnails, title, SKU, price, stock status, short description, the native add-to-cart form (including variable products), and a link to the full product page. Each part can be toggled from the settings screen.
Documentation and links
- Documentation - plogins.com/plogins-peek/docs
- Plugin page - plogins.com/plogins-peek
- Source code - github.com/wppoland/plogins-peek
- Bug reports and feature requests - GitHub issues
- Peek Pro - plogins.com/plogins-peek-pro/
- No jQuery in the plugin's own front-end code, the script is vanilla JS, deferred, and loaded in the footer.
- No layout shift (CLS). The modal is fully hidden until opened and scrolls internally, so it never reflows the page.
- Focus-trapped & keyboard friendly. Focus moves into the dialog on open, is trapped while it is open, closes on Escape or backdrop click, and returns to the trigger button on close. The dialog uses
role="dialog"witharia-modal. - Variation aware. The add-to-cart form supports variable products via WooCommerce's own variation script, loaded only on pages that list a variable product.
- Enable or disable the quick view.
- Set the trigger button label and style (text, icon, or icon + text).
- Choose where it loads: shop and product archives only, or also the related/up-sell loops on single product pages.
- Configure the modal chrome: title, close-button label, loading and error text, the "view product" link text and the SKU label, plus toggles for the modal heading, close button and backdrop-click close.
- Choose which parts render in the modal (image, gallery with a configurable thumbnail count, title, SKU, price, stock status, short description, add-to-cart, full-product link).
[peek_quick_view id="123"], or the shorter [peek id="123"] alias. Optional attributes: text (custom label) and style (text, icon, or icon_text). The modal and its assets load automatically wherever the shortcode appears.
Peek is developed in the open. The code, open issues and release history live at GitHub, bug reports and patches are welcome there.
Works with other Plogins plugins
- Swift - Buy Now Button for WooCommerce - Swift's Buy Now button in the quick view goes straight to checkout, and Add to cart still adds through the quick view.
- Swatch - Variation Swatches for WooCommerce - from Swatch 1.0.24, variable products opened in the quick view show the same colour and label swatches as the product page.
- Reel - hover zoom, an accessible lightbox and product video for WooCommerce galleries: plogins.com/plogins-reel
- Sizer - accessible size guides and tables in a modal: plogins.com/sizavo
- Marks - automatic and manual product badges, CSS-only: plogins.com/plogins-sale-stock-badges
- Swatch - accessible colour and label variation swatches, no jQuery: plogins.com/plogins-swatch
安装:
- Upload the plugin to
/wp-content/plugins/plogins-peek, or install via Plugins > Add New. - Activate it. WooCommerce must be active.
- Visit the Peek menu in wp-admin to configure the button label and modal contents.
屏幕截图:
常见问题:
Does it require WooCommerce?
Yes. Peek requires an active WooCommerce installation.
Does it use jQuery?
The plugin's own front-end script is vanilla JavaScript with no jQuery dependency. When a variable product is listed on the page, WooCommerce's bundled variation script (which itself uses jQuery) is loaded so the variation form works in the modal. Pages without a variable product do not load it.
Where does the quick-view button appear?
On the shop page and product archive loops (categories, tags, taxonomies), after each product, and in block Product Collection grids on any page, such as a block theme homepage. It does not change single product pages.
Does the modal support add to cart?
Yes. Peek renders WooCommerce's native add-to-cart form inside the quick shop modal, including quantity and variable-product choices. The product is added without leaving the page: the modal confirms it with a View cart link and the mini-cart refreshes. If WooCommerce refuses the add (for example the product just sold out), its message is shown inside the modal. Grouped and external products keep their normal behaviour.
Does it work with variable products?
Yes. Variable products use WooCommerce's own variation form inside the product modal, so shoppers can choose a variation before adding to cart.
Will it cause layout shift?
No. The modal is hidden until opened and overlays the page, so opening it never reflows existing content.
Can I place a quick-view button manually?
Yes. Use [peek_quick_view id="123"] or [peek id="123"] to add a product quick view trigger in custom layouts.
Does it work with Swift and Swatch?
Yes, with no setting in Peek. Swift's Buy Now button works in the quick view and goes to checkout. With Swatch 1.0.24 or later, variable products in the quick view show Swatch's swatches instead of dropdowns.
Does this plugin work on WordPress Multisite?
Yes. This plugin is compatible with WordPress Multisite. Network activate it or activate it on individual sites; each site keeps its own settings and data.
更新日志:
1.1.7
- Fixed: deleting the plugin on a multisite network now removes its settings from every site, not only the main one. Settings an installed add-on shares are still kept on every site.
- Fixed: deleting the plugin no longer removes settings that an installed add-on keeps in the same option; the plugin deleted last removes them.
- Fixed: the site could fatal ("Unknown named parameter") when another Plogins plugin with an older copy of the shared library was active. The plugin's bundled copy now lives under its own namespace.
- Fixed: a Buy Now button with its own form action, such as Swift's, now goes to checkout from the quick view instead of being sent as Add to cart.
- Links point at the new plogins.com address.
- The Upgrade to PRO links open the pricing page in the admin's language where plogins.com has one, and tell plogins.com which plugin the visit came from (utm_source, utm_medium and utm_campaign in the link). Nothing is sent from your site.
- Readme: the PRO section lists what the free plugin includes and what the paid edition adds as two lists, which WordPress.org can display (it does not display tables).
- Readme only: a PRO section with links to the paid edition.
- New: add to cart inside the quick view stays on the page. The modal confirms the add with a View cart link, mini-carts (classic header cart and the Mini-Cart block) refresh, and a WooCommerce error such as an out-of-stock product is shown in the modal. Before, the form posted to the product page and the shopper left the listing.
- New: the quick view button appears in block Product Collection grids on any page, such as a block theme homepage, with the modal and its assets loaded there. Before, it showed only in shop and archive loops.
- Changed: WooCommerce's variation script (which uses jQuery) now loads only on pages that list a variable product, instead of on every shop page.
- Fixed: with the button placed over the thumbnail, block themes (including the default Twenty Twenty-Five) stacked every product's quick view button in one corner of the shop page, always visible, and each one opened the same product. The button now sits on its own product card and appears on hover or focus.
- Fixed: on a product on sale, the block Sale badge covered the overlay button so it could not be clicked.
- Security (low): the quick view served password-protected products to anyone. A visitor who had not entered the password could open the preview and read the short description, gallery and add-to-cart form that the product page keeps behind the password form. The preview now refuses a password-protected product (or a variation of one) until the password has been entered; shop managers still see it.
- Security (low): a disabled variation, or a variation of a draft or password-protected product, is no longer shown in the quick view either.
- Fixed: the PRO upgrade promo kept selling to people who had already bought the paid edition. Only the banner could be dismissed, so the sidebar promo and the locked feature cards followed a paying customer around for good. The promo now checks whether the paid edition is active and steps aside when it is.
- Fixed: arrow glyphs in the admin menu paths, and in the strings handed to translators. An arrow inside a translatable string makes the glyph every translator's problem and changes the layout in any locale that drops it.
- Changed: the PRO feature cards printed an arrow glyph in menu paths where the rest of the plugin and the documentation use a plain ">". Same navigation, one character that renders everywhere.
- Fixed: deleting the plugin left the per-user "dismiss" flag from the PRO notice in the database. Uninstall now removes it for every user, not just the one who dismissed it.
- Fixed: every customer-facing string was untranslatable. The button label, the modal title, the close label, the loading and error messages, the SKU prefix and the view-product link shipped as English sentences in a config file and were written into the settings option the moment the plugin activated, so a shop running in another language showed English however complete its language pack was. The settings screen already offered to fall back to a default for a blank field; the packaged value meant blank never happened.
- The defaults are now translated strings resolved when the label is about to be shown, never written back to the database. A label you typed yourself is still used exactly as typed.
- On update, a label left byte for byte as the English default is cleared so the translated one takes over. Anything you edited, including a hand translation, is matched exactly and kept.
- Fixed: the plugin reported an older version number internally than the one it was released under. That number versions the stylesheets and scripts the admin screen loads, so a browser holding the previous files kept them after an update instead of fetching the corrected ones.
- Fixed: the package no longer ships its own translation files. WordPress.org builds language packs from translate.wordpress.org, and a bundled catalogue shadows that pack, so a translation corrected upstream could not reach you until the next release. Your language now comes from the language pack, which is the copy that stays current.
- Declared compatibility with WooCommerce 11.0.
- Fixed the PRO promo on the settings screen quoting a price in PLN. PRO is priced and charged in EUR, so an admin on a Polish site was shown a zloty amount and then billed in euro, and the zloty figure was a fixed conversion that drifted from the real charge as the rate moved. The promo now shows the euro price that is actually taken.
- The "Modal heading" setting now works: the modal title appears above the product instead of being wiped the moment the product loaded.
- Turning off "Product image" now really hides it. Products with no gallery no longer showed the featured photo (or the placeholder) anyway, and the summary now uses the full width when there is no image to show.
- The PRO notice no longer calls the custom modal sections plain HTML. They are stored as post-safe HTML, so scripts and iframes are stripped, and the notice now says so.
- Fix: the quick-view button no longer prints in the related and up-sell loops on single product pages, where the modal it opens is not loaded. It obeys the same "where to load" setting as the modal itself.
- The modal now announces when it has finished loading a product, which is what Peek Pro's quick-view analytics counts. Without it that screen could only ever show zeros.
- Translations: completed Polish, German and Spanish for the PRO upgrade panel.
- Declared compatibility with WooCommerce 10.9.
- Description: converted the links in the readme to proper anchors (documentation, plugin page, source, related plugins).
- Added an in-plugin Peek PRO upsell (dismissible banner + feature cards) on the settings screen.
- Shortened display name (dropped the Plogins prefix; slug unchanged).
- Reverted Author header to WPPoland.com to match the plugin family (author credit is the motylanogha contributor).
- Author header now credits Mariusz Szatkowski (motylanogha).
- Readme: added Peek PRO and related Plogins plugins links.
- Clearer name: Plogins Peek - Product Preview for WooCommerce.
- Added bundled Polish, German and Spanish translations for the plugin interface.
- First stable release.
- Renamed to Plogins Peek for WooCommerce for a more distinctive plugin name.
- New: loop button placement, below the card or overlay on the thumbnail (hover/focus).
- New:
[peek]shortcode as an alias for[peek_quick_view].
- New:
[peek_quick_view]shortcode to place a quick-view trigger anywhere, with optionalid,textandstyleattributes. - New: stock status row in the modal, with a toggle.
- New: configurable gallery thumbnail count (0-12).
- New: trigger button style, text, icon, or icon + text (icon-only keeps an accessible name).
- New: display scope, load on shop/archives only, or also single-product related/up-sell loops.
- New: modal chrome controls in the settings page (title, close-button label, loading/error text, view-product link text, SKU label, and toggles for the modal heading, close button and backdrop-click close).
- New:
uninstall.phpremoves the plugin's options on delete. - Added Domain Path for translations.
- Initial release: accessible AJAX quick-view modal for WooCommerce shop and archive loops, with a settings page for the button label and modal contents.