{"id":399258,"date":"2026-11-15T07:55:21","date_gmt":"2026-11-15T07:55:21","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/perkbase-for-woocommerce\/"},"modified":"2026-11-15T08:43:10","modified_gmt":"2026-11-15T08:43:10","slug":"perkbase-for-woocommerce","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/perkbase-for-woocommerce\/","author":23445303,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.7.1","stable_tag":"1.7.1","tested":"7.1.4","requires":"6.4","requires_php":"8.1","requires_plugins":null,"header_name":"Perkbase for WooCommerce","header_author":"Cultmetrics Oy","header_description":"Activations for WooCommerce: prize wheels, scratch cards, cup games and advent calendars that capture emails, reward shoppers with single-use coupons and attribute order revenue to each activation.","last_updated":"2026-11-15 08:43:10","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/woo.perkbase.app","header_author_uri":"https:\/\/cultmetrics.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":133,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.6.1":{"tag":"1.6.1","author":"cultmetrics","date":"2026-11-15 07:55:12","revision":3802883},"1.7.0":{"tag":"1.7.0","author":"cultmetrics","date":"2026-11-15 08:02:37","revision":3802887},"1.7.1":{"tag":"1.7.1","author":"cultmetrics","date":"2026-11-15 08:43:10","revision":3802929}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3802883,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3802883,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":3802883,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3802883,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3802883,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"perkbase\/activation":{"name":"perkbase\/activation","title":"Perkbase activation"}},"tagged_versions":["1.6.1","1.7.0","1.7.1"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3802883,"resolution":"1","location":"assets","locale":"","width":1600,"height":900},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3802883,"resolution":"2","location":"assets","locale":"","width":2880,"height":1800},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3802883,"resolution":"3","location":"assets","locale":"","width":1600,"height":900},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3802883,"resolution":"4","location":"assets","locale":"","width":2880,"height":1800},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3802883,"resolution":"5","location":"assets","locale":"","width":1600,"height":900},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3802883,"resolution":"6","location":"assets","locale":"","width":2880,"height":1800}},"screenshots":{"1":"The advent calendar: shoppers pick today's door, enter their email and get a single-use coupon that is added to their cart.","2":"The advent calendar pop-up on a WooCommerce store.","3":"Calendar designs: Christmas tree and Classic doors in your brand colours, next to the Winter village. You can also upload your own image.","4":"On a phone the activation opens full screen.","5":"Prize wheel, scratch card and cup game for the rest of the year.","6":"The \"Perkbase activation\" block embeds an activation inside any page."}},"plugin_section":[],"plugin_tags":[17408,842,591,491,187661],"plugin_category":[37,45],"plugin_contributors":[277887],"plugin_business_model":[],"class_list":["post-399258","plugin","type-plugin","status-publish","hentry","plugin_tags-advent-calendar","plugin_tags-christmas","plugin_tags-coupons","plugin_tags-popup","plugin_tags-spin-to-win","plugin_category-arts-and-entertainment","plugin_category-ecommerce","plugin_contributors-cultmetrics","plugin_committers-cultmetrics"],"banners":{"banner":"https:\/\/ps.w.org\/perkbase-for-woocommerce\/assets\/banner-772x250.png?rev=3802883","banner_2x":"https:\/\/ps.w.org\/perkbase-for-woocommerce\/assets\/banner-1544x500.png?rev=3802883","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/perkbase-for-woocommerce\/assets\/icon.svg?rev=3802883","icon":"https:\/\/ps.w.org\/perkbase-for-woocommerce\/assets\/icon.svg?rev=3802883","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/perkbase-for-woocommerce\/assets\/screenshot-1.png?rev=3802883","caption":"The advent calendar: shoppers pick today's door, enter their email and get a single-use coupon that is added to their cart."},{"src":"https:\/\/ps.w.org\/perkbase-for-woocommerce\/assets\/screenshot-2.png?rev=3802883","caption":"The advent calendar pop-up on a WooCommerce store."},{"src":"https:\/\/ps.w.org\/perkbase-for-woocommerce\/assets\/screenshot-3.png?rev=3802883","caption":"Calendar designs: Christmas tree and Classic doors in your brand colours, next to the Winter village. You can also upload your own image."},{"src":"https:\/\/ps.w.org\/perkbase-for-woocommerce\/assets\/screenshot-4.png?rev=3802883","caption":"On a phone the activation opens full screen."},{"src":"https:\/\/ps.w.org\/perkbase-for-woocommerce\/assets\/screenshot-5.png?rev=3802883","caption":"Prize wheel, scratch card and cup game for the rest of the year."},{"src":"https:\/\/ps.w.org\/perkbase-for-woocommerce\/assets\/screenshot-6.png?rev=3802883","caption":"The \"Perkbase activation\" block embeds an activation inside any page."}],"raw_content":"<!--section=description-->\n<p>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.<\/p>\n\n<h4>Advent calendar<\/h4>\n\n<ul>\n<li>24 or 25 doors from the start date you choose. A new door opens every day at midnight in your time zone.<\/li>\n<li>Shoppers enter their email to open today's door and get a single-use coupon, valid until midnight and applied to their cart.<\/li>\n<li>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.<\/li>\n<li>Pick the Winter village, Christmas tree or Classic design, or upload your own image.<\/li>\n<\/ul>\n\n<h4>Every activation<\/h4>\n\n<ul>\n<li>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.<\/li>\n<li>Winners get a single-use WooCommerce coupon with an expiry, applied to their cart automatically.<\/li>\n<li>Orders placed with those coupons are attributed to the activation, so you see the revenue it brought in.<\/li>\n<li>Optional email capture with a marketing consent checkbox. Emails appear in WooCommerce \u203a Customers, and on paid plans shoppers who opted in can go straight to Klaviyo or Mailchimp.<\/li>\n<li>Pop-ups fill the whole screen on phones and show as a card on tablets and desktops.<\/li>\n<\/ul>\n\n<h4>Perkbase is a hosted service<\/h4>\n\n<p>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.<\/p>\n\n<ul>\n<li>The Free plan costs nothing: one live activation and 30 actions (plays) a month.<\/li>\n<li>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 <a href=\"https:\/\/woo.perkbase.app\">perkbase.app<\/a> for current prices.<\/li>\n<\/ul>\n\n<h3>External services<\/h3>\n\n<p>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 <strong>Connect<\/strong>:<\/p>\n\n<ul>\n<li><strong>Connecting the store<\/strong> (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.<\/li>\n<li><strong>The Perkbase menu in wp-admin<\/strong> (Activations, Analytics, Integrations, Plans) runs the Perkbase admin, which is bundled with the plugin (its source is in the plugin's <code>source<\/code> 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 \u203a Plans.<\/li>\n<li><strong>On the storefront<\/strong>, 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 \u2013 if the shopper gives it \u2013 the email address and marketing consent, plus the IP address and browser user agent for abuse prevention.<\/li>\n<li><strong>The \"Perkbase activation\" block<\/strong> 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.<\/li>\n<li><strong>Through the WooCommerce REST API<\/strong> 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 \u203a Customers as guest customers.<\/li>\n<li><strong>Disconnecting or deleting the plugin<\/strong> tells Perkbase the store disconnected (signed site ID only).<\/li>\n<\/ul>\n\n<p>Service terms: <a href=\"https:\/\/woo.perkbase.app\/terms\">Terms of Service<\/a>. Privacy: <a href=\"https:\/\/woo.perkbase.app\/privacy\">Privacy Policy<\/a> and <a href=\"https:\/\/woo.perkbase.app\/dpa\">Data Processing Agreement<\/a>. Paid plans are billed by Cultmetrics through Stripe on perkbase.app; the plugin itself never handles payment details.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate the plugin (Plugins \u203a Add New, search for \"Perkbase\"). WooCommerce must be active.<\/li>\n<li>Open <strong>Perkbase<\/strong> in the admin menu and click <strong>Connect store and start free<\/strong>. If you started a free trial on perkbase.app, enter your subscription code first.<\/li>\n<li>Approve WooCommerce's \"connect app\" screen. This gives Perkbase API access to create coupons and read orders.<\/li>\n<li>Go to <strong>Perkbase \u203a Activations<\/strong>, create an activation and click <strong>Publish<\/strong>. The pop-up appears on your storefront.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"what%20does%20connecting%20share%20with%20perkbase%3F\"><h3>What does connecting share with Perkbase?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"how%20do%20i%20disconnect%3F\"><h3>How do I disconnect?<\/h3><\/dt>\n<dd><p>Plugins \u2192 Perkbase for WooCommerce \u2192 <strong>Disconnect<\/strong>. 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 \u203a Plans \u203a Manage billing.<\/p><\/dd>\n<dt id=\"does%20it%20work%20on%20a%20local%20site%20or%20in%20wordpress%20playground%3F\"><h3>Does it work on a local site or in WordPress Playground?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"do%20i%20need%20a%20cookie%20banner%20for%20the%20pop-up%3F\"><h3>Do I need a cookie banner for the pop-up?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.7.1<\/h4>\n\n<ul>\n<li>The Perkbase admin follows your WordPress language: Finnish users see it in Finnish.<\/li>\n<li>The \"Perkbase activation\" block loads its translations.<\/li>\n<\/ul>\n\n<h4>1.7.0<\/h4>\n\n<ul>\n<li>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.<\/li>\n<li>The wp-admin menu follows you as you move between sections.<\/li>\n<\/ul>\n\n<h4>1.6.1<\/h4>\n\n<ul>\n<li>The Perkbase admin opens in its own browser tab from the Perkbase menu instead of inside wp-admin.<\/li>\n<\/ul>\n\n<h4>1.6.0<\/h4>\n\n<ul>\n<li>Ready for the WordPress.org plugin directory: updates come from WordPress.org.<\/li>\n<li>The readme lists every request the plugin makes to the Perkbase service.<\/li>\n<li>The Disconnect confirmation runs from an enqueued script.<\/li>\n<\/ul>\n\n<h4>1.5.5<\/h4>\n\n<ul>\n<li>Pop-ups fill the whole screen on phones. Tablets and desktops keep the card.<\/li>\n<\/ul>\n\n<h4>1.5.4<\/h4>\n\n<ul>\n<li>Version number only.<\/li>\n<\/ul>\n\n<h4>1.5.3<\/h4>\n\n<ul>\n<li>Wording: activations and actions everywhere.<\/li>\n<\/ul>\n\n<h4>1.5.2<\/h4>\n\n<ul>\n<li>Scratch cards and cup games open as a phone-sized card on desktop too, and fit their frame in the block.<\/li>\n<li>Connect screen talks about all activations.<\/li>\n<\/ul>\n\n<h4>1.5.1<\/h4>\n\n<ul>\n<li>Shorter subscription codes (PERK-XXXX-XXXX-XXXX).<\/li>\n<\/ul>\n\n<h4>1.5.0<\/h4>\n\n<ul>\n<li>New Integrations page: on paid plans, connect Klaviyo or Mailchimp and send emails with marketing consent to your list.<\/li>\n<\/ul>\n\n<h4>1.4.0<\/h4>\n\n<ul>\n<li>Emails given in your activations appear in WooCommerce \u203a Customers as guest customers (no account is created and nothing is emailed to the shopper).<\/li>\n<\/ul>\n\n<h4>1.3.0<\/h4>\n\n<ul>\n<li>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.<\/li>\n<\/ul>\n\n<h4>1.2.1<\/h4>\n\n<ul>\n<li>The won coupon now counts down in a neat card in the bottom-left corner (English or Finnish), stacked with the advent calendar badge.<\/li>\n<\/ul>\n\n<h4>1.2.0<\/h4>\n\n<ul>\n<li>New block \"Perkbase activation\": embed any activation \u2013 advent calendar or prize wheel \u2013 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.<\/li>\n<li>The advent calendar's corner badge follows the calendar language (English or Finnish).<\/li>\n<\/ul>\n\n<h4>1.1.1<\/h4>\n\n<ul>\n<li>The pop-up fills its frame to the bottom edge (no thin strip under the calendar or wheel).<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>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.<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>After connecting, Perkbase opens on Plans with your free trial ready to start.<\/li>\n<li>New activations start in Perkbase colours with your store name in the footer.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>First release: connect, embedded admin in wp-admin (Perkbase \u203a Activations \/ Analytics \/ Plans), storefront pop-up, single-use winner coupons with cart auto-apply, revenue attribution, Stripe billing.<\/li>\n<\/ul>","raw_excerpt":"An advent calendar with a single-use coupon behind every door, plus a prize wheel, scratch card and cup game. See the revenue each one brings in.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/399258","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=399258"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/cultmetrics"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=399258"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=399258"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=399258"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=399258"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=399258"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=399258"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}