Perkbase for WooCommerce

Description

Perkbase adds an advent calendar to your WooCommerce store: shoppers open a new door every day until Christmas, and behind each door is a single-use coupon. Outside the holidays, run a prize wheel, scratch card or cup game. You design and publish them right in wp-admin, under the Perkbase menu.

Advent calendar

  • 24 or 25 doors from the start date you choose. A new door opens every day at midnight in your time zone.
  • Shoppers enter their email to open today’s door and get a single-use coupon, valid until midnight and applied to their cart.
  • The pop-up opens by itself until today’s door is opened; closing it leaves a small badge in the corner. Missed days can’t be opened later.
  • Pick the Winter village, Christmas tree or Classic design, or upload your own image.

Every activation

  • Show an activation as a pop-up (on page load, after a delay or, on desktop, on exit intent), or embed it in any page with the “Perkbase activation” block.
  • Winners get a single-use WooCommerce coupon with an expiry, applied to their cart automatically.
  • Orders placed with those coupons are attributed to the activation, so you see the revenue it brought in.
  • Optional email capture with a marketing consent checkbox. Emails appear in WooCommerce › Customers, and on paid plans shoppers who opted in can go straight to Klaviyo or Mailchimp.
  • Pop-ups fill the whole screen on phones and show as a card on tablets and desktops.

Perkbase is a hosted service

The plugin connects your store to the Perkbase service (run by Cultmetrics Oy, the authors of this plugin), where activations are designed, played and reported. A Perkbase account is created when you connect the store.

  • The Free plan costs nothing: one live activation and 30 actions (plays) a month.
  • Paid plans (Basic, Pro, Business) add more actions a month, the scratch card, cup game and advent calendar and email integrations; Pro and Business also run several activations at once. They start with a 7-day free trial and are billed monthly or yearly by Cultmetrics through Stripe. See perkbase.app for current prices.

External services

This plugin relies on the Perkbase service, provided by Cultmetrics Oy (Finland) at woo.perkbase.app. Without it the plugin does nothing. It is contacted only after a store administrator clicks Connect:

  • Connecting the store (when an administrator clicks Connect): the store URL, store name, admin email address, currency and, if typed, the subscription code are sent to Perkbase, which creates the account. WooCommerce then asks the administrator to approve a REST API key and an order webhook for Perkbase.
  • The Perkbase menu in wp-admin (Activations, Analytics, Integrations, Plans) runs the Perkbase admin, which is bundled with the plugin (its source is in the plugin’s source folder). When a Perkbase page opens, the plugin signs a short-lived, single-use request with the site ID and the WordPress user’s ID and display name. The admin exchanges it at Perkbase for a 15-minute access token, kept in memory only. It then loads and saves the store’s activations, analytics, integration settings and plan through the Perkbase API. Images uploaded to activations and fonts chosen for them are served by Perkbase; Google Fonts are fetched through Perkbase, so the browser does not contact Google. Klaviyo and Mailchimp API keys typed under Integrations are sent to Perkbase, which uses them to add subscribers. Choosing a paid plan opens Stripe Checkout or the Stripe billing portal in the same tab; Stripe then returns to Perkbase › Plans.
  • On the storefront, while the store is connected, the pop-up script loads the store’s published activations from Perkbase and shows them in a frame served by Perkbase. If the shopper is signed in to the store, their first name and email address are passed to the activation so they need not type them. When a shopper plays, Perkbase stores the play, the prize, any discount code and – if the shopper gives it – the email address and marketing consent, plus the IP address and browser user agent for abuse prevention.
  • The “Perkbase activation” block fetches the store’s activation list from Perkbase in the editor and embeds the chosen activation as a frame on the page, with the same data as the pop-up.
  • Through the WooCommerce REST API Perkbase creates single-use coupons for winners, receives order webhooks (order number, total, currency and discount codes used) to attribute revenue, and adds shoppers’ emails to WooCommerce › Customers as guest customers.
  • Disconnecting or deleting the plugin tells Perkbase the store disconnected (signed site ID only).

Service terms: Terms of Service. Privacy: Privacy Policy and Data Processing Agreement. Paid plans are billed by Cultmetrics through Stripe on perkbase.app; the plugin itself never handles payment details.

Screenshots

Blocks

This plugin provides 1 block.

  • Perkbase activation

Installation

  1. Install and activate the plugin (Plugins › Add New, search for “Perkbase”). WooCommerce must be active.
  2. Open Perkbase in the admin menu and click Connect store and start free. If you started a free trial on perkbase.app, enter your subscription code first.
  3. Approve WooCommerce’s “connect app” screen. This gives Perkbase API access to create coupons and read orders.
  4. Go to Perkbase › Activations, create an activation and click Publish. The pop-up appears on your storefront.

FAQ

What does connecting share with Perkbase?

Your store URL, name, admin email and currency, plus a WooCommerce REST API key (read/write) used to create winner coupons and an order webhook used to attribute revenue. See “External services” below.

How do I disconnect?

Plugins Perkbase for WooCommerce Disconnect. This removes the API key and webhook from your store. Your Perkbase account and activations are kept. Deleting the plugin disconnects as well. Disconnecting does not cancel a paid subscription; cancel it under Perkbase › Plans › Manage billing.

Does it work on a local site or in WordPress Playground?

You can install and activate it there, but connecting needs a store that can be reached from the internet: Perkbase creates coupons and reads orders through the WooCommerce REST API. Connect from a live or staging store.

Do I need a cookie banner for the pop-up?

The pop-up stores whether a shopper has already played in the browser’s local storage (first-party, functional) and sets no advertising cookies. Whether your storefront needs consent for that depends on your local law and your cookie policy.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“Perkbase for WooCommerce” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.7.1

  • The Perkbase admin follows your WordPress language: Finnish users see it in Finnish.
  • The “Perkbase activation” block loads its translations.

1.7.0

  • The Perkbase admin runs right inside wp-admin: Activations, Analytics, Integrations and Plans open under the Perkbase menu, with no new tab and no frame.
  • The wp-admin menu follows you as you move between sections.

1.6.1

  • The Perkbase admin opens in its own browser tab from the Perkbase menu instead of inside wp-admin.

1.6.0

  • Ready for the WordPress.org plugin directory: updates come from WordPress.org.
  • The readme lists every request the plugin makes to the Perkbase service.
  • The Disconnect confirmation runs from an enqueued script.

1.5.5

  • Pop-ups fill the whole screen on phones. Tablets and desktops keep the card.

1.5.4

  • Version number only.

1.5.3

  • Wording: activations and actions everywhere.

1.5.2

  • Scratch cards and cup games open as a phone-sized card on desktop too, and fit their frame in the block.
  • Connect screen talks about all activations.

1.5.1

  • Shorter subscription codes (PERK-XXXX-XXXX-XXXX).

1.5.0

  • New Integrations page: on paid plans, connect Klaviyo or Mailchimp and send emails with marketing consent to your list.

1.4.0

  • Emails given in your activations appear in WooCommerce › Customers as guest customers (no account is created and nothing is emailed to the shopper).

1.3.0

  • Free trials can start on perkbase.app: the download carries your subscription code, so the trial plan turns on when you connect. The code can also be typed on the Connect screen.

1.2.1

  • The won coupon now counts down in a neat card in the bottom-left corner (English or Finnish), stacked with the advent calendar badge.

1.2.0

  • New block “Perkbase activation”: embed any activation – advent calendar or prize wheel – inside a page or post. Wins put their coupon on the cart, and the pop-up stays closed on pages that embed the same activation.
  • The advent calendar’s corner badge follows the calendar language (English or Finnish).

1.1.1

  • The pop-up fills its frame to the bottom edge (no thin strip under the calendar or wheel).

1.1.0

  • New activation type: Advent calendar (paid plans). One door a day with a single-use coupon, three ready-made designs, special days and a corner badge until today’s door is opened.

1.0.1

  • After connecting, Perkbase opens on Plans with your free trial ready to start.
  • New activations start in Perkbase colours with your store name in the footer.

1.0.0

  • First release: connect, embedded admin in wp-admin (Perkbase › Activations / Analytics / Plans), storefront pop-up, single-use winner coupons with cart auto-apply, revenue attribution, Stripe billing.