Configuration

Lookbook is configured in two places. Each lookbook carries its own image and hotspots on the post itself; a single global screen at WooCommerce → Lookbook sets four presentation defaults that apply to every lookbook. The global screen is deliberately small, the real content lives with each lookbook.

Global settings

Open WooCommerce → Lookbook. All four values are stored in the lookbook_settings option (an array). The screen needs the manage_woocommerce capability, so shop managers can reach it.

Show lookbooks on the storefront

The master switch, stored as enabled, on by default. When off, the shortcode outputs an empty string and no CSS or JavaScript is enqueued on the page, every lookbook is hidden at once without deleting anything, which is useful while you are still setting up. Your lookbooks and hotspots stay saved for when you turn it back on.

Price

Stored as show_price, on by default. Shows the product’s price in the card, rendered from WooCommerce’s get_price_html() so sale prices and price ranges format exactly as they do elsewhere. If a product has no price HTML, the line is omitted rather than left blank.

Add to cart link

Stored as show_add_to_cart, on by default. Shows an add-to-cart link in the card. The link only appears for a product that is purchasable and in stock; for anything else, out of stock, or not purchasable, the card falls back to a View product link to the product page instead, so the card is never a dead end.

Add to cart label

Stored as add_to_cart_text, blank by default. Overrides the wording on the add-to-cart link for every product, for example Shop the look or Add to bag. Leave it blank to keep each product’s own WooCommerce button text (add_to_cart_text(), e.g. Add to cart, Select options). It is only used when the add-to-cart link above is on.

Per-lookbook data (the Lookbooks editor)

Each lookbook is a lookbook custom post type entry under the Lookbooks menu, supporting only a title and a featured image.

Image

Set the photo with the standard Featured image box (labelled Lookbook image). It renders at the large size with loading="lazy" and decoding="async", and reserves its space via width/height, so there is no layout shift. The lookbook’s title is used as the image alt; if the title is empty it falls back to Shoppable lookbook. A lookbook with no featured image renders nothing.

Hotspots

The Shoppable hotspots box is a repeater. Each row is stored in the _lookbook_hotspots post meta as ['x' => float, 'y' => float, 'product_id' => int]:

• X % / Y %, position from the top-left, clamped to 0-100 and rounded to one decimal. A non-numeric value becomes 0; a blank field defaults to 50.
• Product ID, a positive integer. A row with a missing or zero product ID is dropped on save, so empty rows never persist.

Hotspots are saved only when the lookbook is saved (never on autosave), behind a nonce check and the edit_post capability.

How the data combines at render

When [lookbook id="N"] renders, Lookbook checks the master switch, loads the post (must be a published lookbook), requires a featured image, then resolves each stored hotspot against wc_get_product(). A hotspot is skipped if its product is missing, unpublished, or otherwise not a valid product, so a marker is never drawn for a product that is gone. Price, stock and the add-to-cart URL are read live at this point; there is nothing to re-sync when prices change. If no hotspots survive, the image renders on its own.

Storage and cleanup

• lookbook_settings, the four global settings.
• lookbook_db_version, the schema version, used to seed defaults once.
• _lookbook_hotspots, per-lookbook hotspot meta on each lookbook post.

Everything stays in your own database, Lookbook contacts no external service. Deleting the plugin runs the uninstall routine, which removes both options and force-deletes every lookbook post (with its hotspot meta). Pinned products are WooCommerce products and are never touched.