Configuration

All of Proof’s settings live on one screen, WooCommerce → Proof, and are stored in a single option, proof_settings (an array). The page requires the manage_woocommerce capability and saves through the Settings API with a nonce. Every value is sanitised and clamped on save, and saving drops the cached order feed so changes apply immediately.

General

Enable Proof

The master switch, on by default (enabled). When off, no popup script or CSS is enqueued and nothing renders anywhere on the storefront. Proof never loads inside wp-admin regardless of this setting.

Screen corner

position, which corner the popup slides in from: bottom-left (default), bottom-right, top-left, or top-right. Because the popup is fixed-position, the corner choice never affects Cumulative Layout Shift. An unrecognised value falls back to bottom-left on save.

What each popup shows

A popup always shows the buyer’s first name (or the fallback below), the billing city when the order has one, the first product in the order, and a relative time. There are no toggles for these, the content is fixed so a popup always reads as a complete sentence.

Fallback name

anonymous_name_text, the word shown in place of a first name when an order has none. Defaults to Someone; saving the field empty restores that default. This is the only text on the popup you can customise from the settings screen.

Timing

All three values are entered in seconds and clamped to the ranges below on save; Proof converts them to milliseconds before handing them to the browser.

Setting	Option key	Default	Range
Initial delay	initial_delay	5s	0-120
Display time	display_time	6s	2-60
Interval between popups	interval	12s	3-600

• Initial delay, how long after page load before the first popup appears.
• Display time, how long each popup stays on screen before it slides away.
• Interval, the gap between one popup disappearing and the next appearing. Higher values feel calmer; lower values show more popups.

What is fixed by design

These behaviours are deliberately not settings:

• Only orders with status completed or processing, created in the last 30 days, are eligible.
• Proof draws from at most the 40 most recent such orders.
• Only the first name and billing city are ever sent to the browser, there is no way to expose more.
• The feed query is cached for five minutes in a transient and refreshed automatically on order or settings changes.

The order age (30 days) and order count (40) are constants in the order-feed service, not options.

Developer filter

Proof exposes one merchant/developer-facing filter, proof/notifications, which receives the privacy-safe feed before it is localised to the browser. Add-ons append items using the same shape, name, city, product, time, ts (unix timestamp):

add_filter( 'proof/notifications', function ( array $notifications, array $settings ): array {
  $notifications[] = [
    'name'    => 'Sam',
    'city'    => 'Oslo',
    'product' => 'Gift Card',
    'time'    => '',           // recomputed from "ts" per request
    'ts'      => time() - 3600,
  ];

  return $notifications;
}, 10, 2 );

The time string is recomputed from ts on every request, so cached timestamps never go stale, set ts and leave time empty. Returning an empty array makes Proof load nothing.

Theming with CSS

The popup styles are built on --proof-* custom properties, background, foreground, accent, border, shadow, radius and gap, each falling back to a theme variable (such as --wp--preset--color--base) before a literal. You can recolour Proof from your theme stylesheet without overriding markup. Dark mode (prefers-color-scheme: dark), a visible :focus-visible ring on the dismiss button, and prefers-reduced-motion handling are built in and need no configuration.

Storage and cleanup

Settings live in the single proof_settings option. Deleting the plugin runs uninstall.php, which removes proof_settings, the proof_db_version option, and the proof_feed_cache transient. Proof creates no custom database tables and never touches your order data.