PXS Competitions Plugin

v2.2Welcome!

Operator guide for Competitions for WooCommerce with PXS Competition Addons — admin screens, settings, Elementor widgets, and shortcodes.

Use the sidebar to navigate, or press Ctrl+K to search.

How to use this guide

  • Use the left navigation or On this page (right) to jump between sections.
  • Elementor widgets require Elementor active and usually a template built for your competition / shop pages.
Optional cover image for printed or PDF operator handouts

What’s new in 2.2.1

  • PXS Hero Elementor widget — Minimal hero slider for the front page. Each slide uses a live competition: the product image is rendered as a background: cover layer with the competition title, short description and a Play now for £X CTA stacked over the top. Hover reveals previous / next arrow boxes on the left and right edges. Configure the number of competitions to show, autoplay on/off, pause between slides, transition speed, pause-on-hover, loop, arrow visibility (hover/always), dots, and whole-slide click, plus a full Style → Overlay panel with colour, opacity and an optional two-colour gradient fade. See PXS Hero.
  • Competitions settings tab — A new Competitions tab in PXS Competitions → Settings groups competition-specific options. The existing Enable boosted competitions master toggle has moved here from the General tab. Site-wide on/off switches for the product badges shown on competition cards (Sale, Boosted, Instant wins) also live on this tab. See Global settings.
  • Referral programme — Wallet credits for referral rewards. Configure under PXS Competitions → Settings → Referrals: enable referrals, referral reward amounts, qualifying spend, referral cookie duration, and whether store-wallet checkout counts toward referrals. See Referrals.
  • Referrals admin tracker — A new PXS Competitions → Referrals screen (shown when referrals are enabled) tracks every referrer and referred customer: summary cards, two charts (status and conversion funnel), a Top referrers leaderboard (top 20), an All referrers table, and a filterable referrals table with each customer’s progress, amount still needed, status, payout, and triggering order. Both tables paginate at 20 rows per page. Referral links now also record clicks. See Admin tracker.
  • Cashback campaign — A single, time-limited tiered cashback promotion. Set a status (Draft / Scheduled / Active), start and end dates, one reward percentage, payout destination (site credit wallet or PXS Coins) and up to 10 spend tiers. Customers accrue qualifying spend across paid orders during the window; at the end you process payouts of percentage × the highest tier reached (not stacked). Configure under PXS Competitions → Settings → Cashback. See Cashback campaign.
  • VIP Coins — Separate coin wallet accrual on qualifying competition ticket spend. Configure under Settings → Coins: enable the coin wallet, set spend-per-coin, and choose whether Woo Wallet orders earn coins. Use the PXS Coin Wallet Elementor widget on account or hub pages where needed.
  • Dashboard — The modern dashboard that is the WordPress Dashboard → Home screen. It is the standard dashboard and is always on (no toggle). It shows six KPI cards (Tickets Sold, Total Revenue, Total Orders, Wallet Value, Live Competitions, Closed Competitions) with period-over-period change badges, a combined tickets & revenue chart, a competition overview, a real-data recent activity feed, an active coupon codes table, a top-competitions leaderboard, and a user overview with a new-users chart. A Last 7 / 30 / 60 / 90 / 120 days selector re-queries the whole dashboard without reloading. The classic PXS dashboard widgets and the old enable/disable toggle were removed in v2.2.1.
  • Optimised backend and settings — Settings reorganised into tabs (General, Competitions, Jackpot, Checkout, Referrals, Cashback, Coins, Admin, Winner reveal, Advanced). Cleaner admin flows and consolidated options for day-to-day operation.
  • Exclude wallet transactions from jackpot and coin contributions — Control whether orders paid with the store wallet (Woo Wallet) count toward the site jackpot pool and coin accrual. Jackpot: Settings → Jackpot → Wallet contributions. Coins: Settings → Coins → Coins & store wallet. Referrals have a separate wallet toggle on the Referrals tab, and the Cashback campaign has its own "include wallet spend" toggle.
  • Safe Play (responsible gaming) — Customers can set a monthly competition spend limit (£0–£1000), pause playing (1 day through permanent), and hide their identity on winner feeds (masked first name + alias code). Configure under Settings → General → Safe Play; build the page with the PXS Safe Play Elementor widget. Limits and pauses are enforced at add-to-cart and checkout. Support changes via PXS Users.
  • 18+ checkout confirmation — Optional age gate on checkout. Enable under Settings → Checkout → Enable 18+ checkbox on checkout. When on, customers must tick a required checkbox below the terms and conditions confirming they are aged 18 or over; confirmation is saved on the order. When off, the checkbox is hidden. See 18+ checkout confirmation.
  • Boosted competitions — Prize tiers driven by ticket-sales percentage: set a base cash prize and up to three tiers on each competition product. Enable globally under Settings → Competitions → Enable boosted competitions. Use the [pxs_boosted_prize] shortcode and the PXS Boosted Elementor widget on the storefront. See Competition products and PXS Boosted.
  • New operator and developer documentation — This guide (LottoReadme) for operators, plus plugin README.md / CHANGELOG.md. Advanced → Developer mode enables staging tools (bulk reset on Closed Competitions, settings export) for developers.

Requirements & access

  • WordPress 5.0+ and WooCommerce 4.0+.
  • Competitions for WooCommerce — Required. Competition products, tickets, and draws depend on this plugin (from WooCommerce.com).
  • TeraWallet — Required for store wallet, referral credits, cashback campaign payouts paid as site credit, and wallet-paid checkout options in PXS settings.
  • Elementor 3.0+ optional — PXS widgets appear in the editor when Elementor is installed and active.
  • Most PXS admin pages need manage_woocommerce (typically Shop Manager or Administrator).

WordPress: PXS Competitions menu v1.0.0

Open the left sidebar: PXS Competitions (ticket icon). Submenus vary slightly by version; typical items:

Submenu Purpose (operator summary)
Winner Reveal Run the live full-screen draw: pick a closed competition, enter winning ticket number(s), animation + optional email to winner.
Closed Competitions History of closed draws: reopen a locked reveal, delete a PXS winner row (orders untouched), optional bulk reset (Developer setting).
Jackpots Manage timed / sales-linked jackpots aligned with the Jackpot widget.
Referrals v2.2.1 Tracker for the referral programme (shown when referrals are enabled): summary cards, charts, and tables of referrers and referred customers with clicks, progress, status, and payouts.
Instant Win Generator Generate CSV files for instant-win ticket/prize data to import or configure in Competitions for WooCommerce.
Prize Claims Admin view of customers claiming main prize vs cash alternative.
Settings Global PXS options on tabbed screen: tickets bar mode, the Competitions tab (boosted competitions toggle, product tag switches), 18+ checkout confirmation, Safe Play My Account page, checkout countdown, notifications, winner reveal branding, developer toggles, etc.
PXS Users Search customers; edit wallet/coin balances; manage Safe Play (pause, monthly limit, hide identity) when customers need support.

Admin screens (detail)

Each primary PXS screen lives under the PXS Competitions menu after logging in as a shop manager. The summaries below link to the full walkthrough for each screen.

Winner Reveal

The live full-screen draw console: pick a closed competition or jackpot, enter the winning ticket number(s), run the animation, and optionally email the winner. See Winner reveals.

Closed Competitions

History of closed draws. Reopen a locked reveal, delete a PXS winner row (the underlying orders are untouched), or use the optional developer bulk reset on staging. See Managing closed draws.

Jackpots

Create and manage timed, sales-linked jackpots that power the PXS Jackpot widget. See Jackpots.

Referrals v2.2.1

A read-only tracker for the referral programme, shown directly after Jackpots while referrals are enabled. It reports who is sharing links, how their referrals are progressing, and who has been paid. See Admin tracker.

Instant Win Generator

Build CSV files of ticket numbers and instant prizes for import into Competitions for WooCommerce. See Instant win generator.

Prize Claims

Admin view of customers claiming the main prize vs the cash alternative, with status and linked order/competition. See Prize claims.

Dashboard v2.2.1

The WordPress Dashboard → Home screen is the main PXS dashboard. It is always on and replaces the old dashboard widgets. It shows KPI cards, tickets and revenue charts, competition overview, recent activity, active coupon codes, top competitions, and user overview, with a date range selector for 7 / 30 / 60 / 90 / 120 days.

Admin Dashboard showing KPI cards, tickets and revenue chart, competition overview, recent activity, active coupon codes, top competitions, and user overview

Health Dashboard v2.2.1

The optional Dashboard → Health Dashboard screen is enabled from PXS Competitions → Settings → Admin → Competition Health Dashboard. It shows an Overall Health Score, health KPIs for every live competition, sell-through bars, time remaining, a health distribution chart, and insights.

Health bands (based on % of tickets sold): Excellent is above 70% sold, Good is 40–70%, Moderate is 25–40%, and Low is under 25%. Each band is further split into three sub-statuses on the per-competition badges (for example Low → Very Low / Low / Moderately Low, Excellent → Excellent / Outstanding / Exceptional) so the label sharpens as sales move through the band.

Overall Health Score — a single 0–100 score, shown as a credit-score-style gauge at the top of the page. Each competition is scored on a 50/50 blend of level (raw % sold) and pace (sold vs. what would be expected by now for a linear sell-out by the end date; pace only counts once 10% of the run has elapsed, and falls back to level when there is no start/end date). Those per-competition scores are then averaged, weighted by ticket-pool size, so larger raffles count for more. The score maps to the same bands: 70–100 Excellent, 40–70 Good, 25–40 Moderate, 0–25 Low.

Health Dashboard showing the Overall Health Score gauge, KPI cards, competitions-at-a-glance list, and health distribution chart

Global settings (Settings screen) v1.0.0

Open PXS Competitions → Settings. Sections may include (names vary by version):

Settings are organised in tabs: General, Competitions, Jackpot, Checkout, Referrals, Cashback, Coins, Admin, Winner reveal, and Advanced.

  • General — Ticket count view (count vs %), manual picking highlight, Safe Play My Account page selector, claim prize visibility window.
  • Competitions v2.2.1 — Competition-specific options grouped on one tab:
    • Boosted competitions — Master Enable boosted competitions toggle (moved here from the General tab). When off, the boosted fields on the product editor and all boosted badges / widgets are hidden site-wide.
    • Product tags — Global on/off tick-boxes for the badges shown on competition products: Sale, Boosted, Instant wins. The PXS Live Competitions widget (and any other widget that surfaces product tags) checks these switches before rendering each tag, so a tag can be turned off site-wide in one place. Individual widgets can still hide a tag locally even when it is enabled here. Defaults: all three on.
  • Jackpot — Sale contribution % and wallet order contributions.
  • Checkout — Enable 18+ checkbox on checkout; cart hold countdown; redirect after checkout (order complete page).
  • Referrals — Enable referrals, referral reward amount, qualifying spend, referral cookie duration, store-wallet eligibility, and the optional My Account Referrals page selector.
  • Cashback v2.2.1 — Single time-limited tiered cashback campaign: status, start/end dates, reward percentage, payout destination (site credit or PXS Coins), include-wallet-spend toggle, up to 10 spend tiers, plus payout preview and processing.
  • Coins — Coin wallet accrual and spend-per-coin rate.
  • Admin — WooCommerce orders/users list column options, plus a Competition Health Dashboard v2.2.1 toggle. The WordPress Dashboard → Home screen is the modern PXS dashboard v2.2.1 (standard, always on).
  • Winner reveal — Live draw branding, colours, and winner email templates.
  • Advanced — Developer mode (bulk reset UI on Closed Competitions, settings export). A banner appears at the top of Settings when developer mode is on.
Tip: After changing countdown or tickets bar settings, confirm on a staging competition product before go-live.

18+ checkout confirmation v2.2.0

Under Settings → Checkout → Age verification, turn on Enable 18+ checkbox on checkout when you need customers to confirm they meet the minimum age before completing a purchase.

  • When enabled — A required checkbox appears on the WooCommerce checkout page directly below the agree-to-terms-and-conditions checkbox. Label: I confirm that I am 18 years of age or older. Checkout is blocked until it is ticked.
  • When disabled — No age checkbox is shown and no age validation runs.
  • Order records — A successful checkout stores confirmation on the order (for audit/support).

WooCommerce must have the terms and conditions checkbox enabled for the age checkbox to appear in the usual position (below terms). If terms are turned off site-wide, the age checkbox still appears before the Place order button.

Competition products v1.0.0

Create and maintain competition products in Products → Add New (or edit existing). Choose product type Competition (Competitions for WooCommerce), then complete catalogue details and the competition / PXS panels below. Duplicate an existing competition to copy ticket rules and PXS fields.

PXS adds the following fields to the competition product editor:

  • Cash alternative — Offer a cash option instead of the physical prize; works with Claim Prize flows and Cash Alternative widget.
  • Featured Competition — Flags the product for special card styling on Live / Related competition grids.
  • Hero Competition v2.2.1 — Adds the product to the PXS Hero slider when its Sort by control is set to Manual. Lets operators choose exactly which competitions appear in the front-page hero, regardless of date or featured status.
  • Quick select — Enable preset ticket bundles and tier discounts for the Quick Select widget.
  • Boosted competition (when enabled globally) — Mark the product as boosted, set a base cash prize, and up to three ticket-sales percentage tiers with prize amounts. Drives the PXS Boosted widget, boosted badges, bar tier markers, and [pxs_boosted_prize].

Competition settings

Store-wide competition behaviour from Competitions for WooCommerce and PXS Competitions → Settings (ticket bar mode, Competitions tab for the boosted master switch and product tag switches, checkout, etc.). Set these before publishing individual competitions.

Adding new competition

Steps to add a new competition product: title, publish status, and competition type. Duplicate an existing competition to copy ticket rules and PXS fields.

Competition images

Product image, gallery, and any card/thumbnail assets used on Live Competitions and single-product templates.

Competition categories

Assign WooCommerce categories/tags so competitions appear in the right shop grids and filters.

Competition descriptions

Long description, short description, and any Elementor body content for the competition landing page.

Competition product data

The competition data panel on the product edit screen: ticket pricing, limits, draw window, winners, and PXS options (featured, cash alternative, quick select, boosted tiers, instant wins).

Price

Ticket price and any sale pricing rules for the competition product.

Min / max tickets

Minimum tickets required for the draw to run and maximum tickets available before the competition is sold out.

Tickets per user

Per-customer ticket cap for the competition (where supported by Competitions for WooCommerce).

Winners

Number of main-draw winners whether in manual or auto picking.

Manual picking winners

When manual picking is enabled, winning ticket numbers are chosen in Winner Reveal after the competition closes instead of being drawn automatically. Set this on the competition product before go-live if your process requires a live or staged manual draw.

Start & end dates

When the competition opens for entries and when it closes (feeds countdown widgets and “closed” state).

Options

General competition options from Competitions for WooCommerce (e.g. skill question, manual draw flags — labels depend on your extension version).

PXS Featured competition flag for highlighted cards on Live / Related grids.

Hero competition v2.2.1

Tick Hero competition (directly under Featured competition in the PXS widgets options panel) to add the product to the PXS Hero slider when that widget's Sort by control is set to Manual. Manual mode shows only Hero-flagged competitions — full editorial control over which products appear in the front-page hero. Use the Products list drag handles (menu order) to control their sequence, or pick a different Manual order option on the widget.

Cash alternatives

Tick Offer cash alternative so winners can take a fixed cash payout instead of the main prize. Enter the cash alternative amount in your store currency (for example £100)—this is what you are offering if they decline the physical prize. The amount is shown on the product via the PXS Cash Alternative widget and used again when they claim through Prize Claims / the Claim Prize flow after a win.

Quick selection

Tick Enable quick select boxes so the PXS Quick Select widget can appear on the competition template. Configure four preset buttons (Box 1–4): for each, set how many tickets are added to the cart when a customer taps that button, and an optional discount % off the line total for that bulk buy. Leave discount at 0 for no reduction. The widget syncs quantity with PXS Add to Cart when a box is chosen.

Example: Box 1 = 5 tickets at 0% off, Box 2 = 10 tickets at 2.5% off, Box 3 = 25 tickets at 5% off. Tapping Box 2 adds 10 tickets and takes 2.5% off that line total.

Boosted competitions v2.1.0

Mark the product as boosted and set a base cash prize (the prize shown before any tier is reached). Add up to three tiers: each tier has a ticket sales % (sold ÷ max tickets) and a cash prize amount. As sales climb, the displayed prize updates to the highest tier the competition has passed. Requires Enable boosted competitions in Settings → Competitions.

Example: base prize £100 with tiers at 50% sold = £150 and 75% sold = £200. While under 50% sold the prize shows £100; once 50% of tickets sell it becomes £150; once 75% sell it becomes £200. The prize only ever moves up to the highest tier reached.

Instant wins

Instant-win prizes and ticket mapping on the product (or via imported CSV from the Instant Win generator).

Jackpots v2.0.0

Jackpot overview

The PXS Competitions → Jackpots screen manages site-wide prize pools that grow from qualifying sales (and optionally wallet orders). Active jackpots power the PXS Jackpot Elementor widget; global sale % is set under Settings → Jackpot.

Jackpot settings

Configure sale contribution % and whether TeraWallet (store wallet) orders count toward the pool under Settings → Jackpot.

Adding jackpots

On PXS Competitions → Jackpots, use Create jackpot to set a title and start / end date and time. The prize fund is not set here—it grows automatically from qualifying competition orders at the sale percentage in Settings → Jackpot. Only one scheduled or live jackpot can exist at once; close or wait for the current one to end before adding another.

Editing jackpots

Update amounts, dates, or status on an existing jackpot; pause or close when needed.

Viewing contributions

Review orders or lines that added to the jackpot total (audit trail for operators).

Prize claims v2.0.0

Claim overview

PXS Competitions → Prize Claims lists customer claims after a win: main prize vs cash alternative, status, and linked order/competition. Use this screen for day-to-day fulfilment and support.

Prize claim system

How customers submit claims (Claim Prize widget / account flow) and how claim visibility days work (Settings → General → Claim prize).

Maintaining claims

Update claim status, notes, and hand-off to fulfilment; align with your internal prize-dispatch process.

Winner reveals

Reveal overview

Winner Reveal is the live draw console: pick a closed competition or jackpot, enter winning ticket number(s), run the animation, and optionally email the winner. Branding and email copy are under Settings → Winner reveal.

Competition draws

Run the main-draw reveal for a single competition product after entries have closed.

Jackpot draws

Reveal a jackpot winner when a site jackpot closes or reaches its target.

Managing closed draws

Closed Competitions history: reopen a locked reveal, delete a PXS winner row (orders unchanged), or use developer bulk reset on staging.

Instant win generator v2.0.0

Instant win overview

Instant Win Generator builds CSV files of ticket numbers and instant prizes for import into Competitions for WooCommerce. Use for large instant-win matrices instead of entering tickets manually on each product.

Instant win settings

Generator options: prize columns, ticket ranges, and export format before download.

Instant win usage

Typical workflow: generate CSV → import or attach to competition → verify on product and Instant Tickets Table widget.

PXS Coins v2.2.0

Coins overview

VIP Coins accrue on qualifying competition ticket spend (separate from store wallet / site credit). Global rules live under Settings → Coins; customers see balances via the coin wallet widget and account areas you configure.

PXS coins system overview

Coins settings

Enable coin wallet, set spend-per-coin, and choose whether wallet-paid orders earn coins.

Example: spend-per-coin set to £1 = 1 coin. A customer who spends £40 on qualifying competition tickets earns 40 coins. If wallet-paid orders are excluded, only card/non-wallet spend earns coins.

User balances

View or adjust customer coin balances (admin tools or user profile integrations, depending on your setup).

Referrals v2.2.0

Overview

Referrals let customers share a referral code or link. When a referred customer registers and reaches the qualifying competition ticket spend, both the referrer and the referred customer receive a wallet credit.

  • Referrer — The existing customer who shares their referral link/code.
  • Referee — The new customer who signs up using the referral link/code.
  • Reward — A store-wallet credit paid to both people once the referred customer qualifies.
  • Qualification — Based on cumulative paid competition ticket spend, across one or more qualifying orders.

The customer-facing block explains what each person gets, how to qualify, provides copy/share buttons, and shows progress for both the referred customer and the referrer’s invited friends.

Example: reward £5 with a qualifying spend of £10. A referred friend who spends £4 then £7 on tickets reaches £11 total, crosses the £10 threshold, and both they and the referrer are credited £5 to their wallets automatically.

Settings

Open PXS Competitions → Settings → Referrals.

  • Enable referrals — Turns on referral wallet credits.
  • Referral reward amount — Wallet credit paid to both the referrer and referee when the referral qualifies.
  • Referral qualifying ticket spend — Minimum cumulative competition ticket spend the referred customer must reach before rewards are paid.
  • Referrals & store wallet — Choose whether orders paid with the store wallet count toward referral qualifying spend and bonuses.
  • Referral link cookie (days) — How long a visitor’s ?ref= code is remembered before registration.
  • My Account Referrals page — Optional page selector. Pick the WordPress page that contains the PXS Referral Elementor widget to control the layout and styling shown inside My Account.
Tip: If wallet-paid checkouts are later excluded from referrals, historic paid bonuses remain paid, but live spend progress may show a lower qualifying total.

Setup & My Account

  1. Create a WordPress page for referrals, for example My Referrals.
  2. Edit the page with Elementor and add the PXS Referral widget (see widget guide).
  3. Use the widget Style tab to style each section: box, heading, intro, reward cards, steps, share controls, progress bars, panels, tracker stats, table, chips, and guest text.
  4. Publish the page.
  5. Open PXS Competitions → Settings → Referrals and choose that page as My Account Referrals page.
  6. Save settings. Permalinks refresh automatically so the My Account endpoint works.

When a page is selected, customers see Referrals in the WooCommerce My Account menu. Clicking it loads the selected page’s PXS Referral widget inside My Account at /my-account/referrals/; the account menu stays visible.

Leave the page selector on — Default: built-in referral block — to use the default inline referral layout instead of an Elementor-built page.

Tip: After selecting the page, log in as a customer and visit /my-account/referrals/ to confirm the Elementor styling and copy/share buttons load correctly.

Customer flow

  1. The logged-in referrer opens My Account → Referrals.
  2. They copy their referral code, copy the referral link, or use the native Share… button on supported devices.
  3. The friend opens the link. The ?ref= code is stored in a cookie for the configured number of days.
  4. The friend registers. The referral code is captured automatically from the cookie, or can be entered in the optional referral-code field on registration.
  5. The friend buys competition tickets. Qualifying paid order totals are added together until the minimum spend is reached.
  6. Once the threshold is met, the referral reward is credited to both wallets automatically.

The customer does not need to redeem a coupon code at checkout. The referral is attached at registration and rewards are processed automatically when qualifying paid orders are handled.

Referral tracker

The PXS Referral widget can show two types of progress depending on the logged-in customer:

  • Your welcome bonus — Shown when the current customer was referred by someone else. The progress bar shows how much they have spent of the qualifying spend target.
  • Your referral tracker — Shown when the current customer has referred friends. It lists invited friends, qualified referrals, in-progress referrals, and total earned.

In the friend-by-friend table, the progress line is written as amount spent of target. Example: £3.00 spent of £10.00. The status chip shows whether the bonus is paid, processing, or not yet qualified.

If a row says Bonus paid but the spent amount later appears lower than the target, it usually means the bonus was paid previously and the live qualifying total later changed (for example, a refund/cancellation or a settings change around wallet-paid orders).

Admin tracker v2.2.1

Open PXS Competitions → Referrals. This screen appears directly after Jackpots in the menu and is only shown while Enable referrals is on. It gives a complete view of everyone who has shared their referral link and has a referral in progress or completed.

The top of the page shows summary cards:

  • Active referrers — Customers who have referred at least one person.
  • Total sign-ups — Customers who registered through a referral.
  • In progress — Referred customers who have not yet been paid.
  • Completed — Referred customers whose bonus has been paid.
  • Link clicks — Visits arriving via a referral link or code (de-duplicated per visitor for the cookie lifetime).
  • Click → sign-up — Sign-ups as a percentage of clicks.
  • Total paid out — Wallet credit paid across all completed referrals (both the referrer and the referee are credited).

Below the cards are two charts: a referral status doughnut (completed vs in progress) and a conversion funnel (clicks → sign-ups → completed).

Three tables follow:

  • Top referrers — A ranked leaderboard of the top 20 referrers with their clicks, sign-ups, in-progress and completed counts, conversion rate, and total earned.
  • All referrers — Every sharer with their link clicks, sign-ups, in-progress and completed counts, and total earned. Use the Sign-ups link to filter the referrals table to just that referrer. Paginated at 20 per page.
  • Referrals — Each referred customer with a live progress bar (amount spent of target), the amount still needed, a status badge (Completed, Qualified — pending, or In progress), the reward paid, and a link to the order that triggered the payout. Filter by status (all / in progress / completed), search by name, or filter by a single referrer. Paginated at 20 per page.
Tip: Link clicks are recorded from v2.2.1 onward, so referrals created before upgrading may show fewer clicks (and a higher conversion rate) than they actually earned.

Cashback campaign v2.2.1

Overview

A cashback campaign is a single, time-limited promotion that rewards customers for how much they spend during a set window. Only one campaign is configured at a time.

  • Spend tiers — Up to 10 spend thresholds (for example £10, £25, £50). Each tier is just an amount the customer must reach.
  • One reward percentage — A single percentage set at the campaign level.
  • Highest tier wins — At the end of the campaign each customer is paid percentage × the highest tier threshold they reached. Tiers are not stacked. Reaching no tier pays nothing.
  • Cumulative spend — Qualifying spend is added up across all of the customer’s paid orders dated within the campaign window.
  • Payout destination — Pay rewards as site credit (store wallet) or as PXS Coins.
Example: reward percentage 50% with tiers £10 / £20 / £50. A customer whose qualifying spend totals £35 reaches the £20 tier, so they receive 50% × £20 = £10. Spend above a tier does not pay more until the next tier is reached.

Settings

Open PXS Competitions → Settings → Cashback.

  • Status — Draft (off, no spend counted or paid), Scheduled or Active (the campaign runs between the start and end dates). A badge shows whether the campaign is Live, Scheduled, or Ended.
  • Start date / End date — Orders dated between these dates (inclusive) count toward the campaign.
  • Cashback (%) — The single percentage applied to the highest tier a customer reaches.
  • Pay cashback as — Site credit (wallet) credits the store wallet; PXS Coins credits the coin balance using your coin rate.
  • Wallet spend — When off, money spent using site credit (store wallet) does not count toward the tiers. Tick the box to include wallet-paid orders.
  • Spend tiers — Add from 1 up to 10 thresholds. Customers are paid on the highest threshold their qualifying spend reaches.
Paying as site credit requires TeraWallet. Paying as PXS Coins converts the cashback amount using your coin rate from Settings → Coins.

Payouts

Cashback is paid at the end of the campaign, not after each order. The flow is:

  1. Save the campaign settings.
  2. Click Preview eligible payouts to see each qualifying customer, their cumulative qualifying spend, the tier they reached, and the cashback due. A projected total is shown at the bottom.
  3. After the campaign end date passes, the Process payouts button becomes available. Click it to credit every eligible customer.

Payouts are idempotent — each customer is paid once per campaign window, so re-running Process payouts will not double-credit anyone. Customers already paid show as Paid in the preview.

Save changes before previewing — the preview reads the saved campaign, not unsaved edits in the form.

Customer view (My Account)

While a campaign is configured (Scheduled, Active, or Ended), logged-in customers see a Cashback tab in My Account (/my-account/cashback/). It shows their spend so far in the window, the cashback earned at the highest tier reached, how much more to spend to reach the next tier, the full tier table with reached/locked status, and when the cashback pays out. Progress is calculated live from their order history.

Safe Play v2.2.0

Overview

Safe Play (also labelled My Self Play on the storefront) gives logged-in customers responsible-gaming controls for competition ticket purchases. It does not affect non-competition products.

  • Pause playing — Block competition entries for a chosen period (1 day, 1 week, 1 month, 3 months, 1 year, or permanent).
  • Monthly spending limit — Cap competition ticket spend per calendar month (£0 = no limit, up to £1000).
  • Hide identity — Replace the customer’s public name on instant-winner and main-draw winner displays with a masked form (first name + 8-character alias, e.g. Stephen S9WG8M7P).

When a pause is active or a purchase would exceed the monthly limit, WooCommerce shows an error and blocks add-to-cart / checkout for competition products only.

Setup & My Account

  1. In Elementor, create or edit a WordPress page and add the PXS Safe Play widget (see widget guide). Style it on the widget Style tab as needed.
  2. Publish the page.
  3. Open PXS Competitions → Settings → General and under Safe Play, choose that page as My Account Safe Play page.
  4. Save settings. Permalinks refresh automatically so the My Account endpoint works.

When a page is selected, customers see a Safe Play item in the WooCommerce My Account menu (usually after the wallet link). The page content is embedded inside My Account at /my-account/safe-play/ — the left account menu stays visible; duplicate page titles from the theme are hidden on that tab.

Leave the setting on — Disabled: hide from My Account — to turn off the menu item entirely. You can still place the widget on any public page for a standalone Safe Play URL.

Tip: After changing the Safe Play page or Elementor layout, view /my-account/safe-play/ while logged in to confirm styles load (Elementor post CSS is injected for that tab).

Customer controls

Pause playing

Customers choose a period with a slider and click Activate pause. Once set, the pause cannot be changed or removed from the storefront — they must contact support. While paused, they cannot add competition tickets to the cart or checkout.

  • Timed pauses show an active notice with the end date.
  • Permanent pause stays until cleared in admin.

Monthly spending limit

Limit applies to paid competition line totals in the current calendar month (store timezone). The page shows Spent this month and the current limit.

  • Decreases (including setting a lower cap) apply immediately.
  • Increases take 24 hours before the higher limit applies; a pending message shows the effective date.
  • No limit is slider position 0 (£0).

Enforcement includes items already in the cart: if spent + cart competition total would exceed the limit, checkout is blocked with a message showing how much remains this month.

Example: limit set to £100 with £80 already spent this month. The customer can still add up to £20 of competition tickets; a £30 basket is blocked with a message that only £20 remains. Raising the limit to £150 only takes effect 24 hours later, but lowering it to £50 applies straight away.

Hide identity

When enabled, the customer’s name on Recent Instant Winners, Recent Drawn Winners, Winner name, and related feeds uses the masked alias. An example preview is shown before they save.

Once enabled, the toggle is locked on the storefront; only support (via PXS Users) can turn it off.

Admin & support

Open PXS Users in the WordPress sidebar (groups icon). Search for the customer, then Edit to open their profile. The Safe Play panel lets staff:

  • Pause playing — Set or clear any pause period (including ending a permanent pause).
  • Monthly spending limit — Set 0–1000; admin changes apply immediately (no 24-hour delay).
  • Hide identity — Enable or disable; view the customer’s permanent alias code.

Use this screen for support requests when customers cannot change locked settings themselves.

Elementor widgets (full list)

In Elementor, open the panel and search PXS or browse General / WooCommerce categories. Below: widget title in the editor, where operators typically place it, and what to configure first.

PXS Add to Cart v1.0.0

Primary purchase UI for competition entries. It renders the ticket quantity control, price summary and participate/add-to-cart button, with optional stock/progress messaging so customers can see availability before entering.

  • Use on: Single competition product templates.
  • Content tab:
    • Product ID — leave at 0 on a single-product template to use the current competition, or enter a specific product ID for a fixed CTA.
    • Quantity / slider settings — configure the visible quantity selector, min/max behaviour, step/handle labels and how the field responds when customers change ticket count.
    • Button text — customise the participate/add-to-cart button copy and disabled-state copy for sold-out, ended or not-yet-started competitions.
    • Price / savings messaging — show the ticket price, total line price and optional savings/discount messaging when quick-select or bulk pricing is active.
    • Tickets bar — show/hide the progress bar and text that follows the global ticket count mode (count vs percentage).
  • Style tab:
    • Layout / wrapper — spacing, alignment, padding, background, border and border radius for the overall add-to-cart panel.
    • Quantity slider — track, fill, handle, labels and input typography/colour.
    • Button — normal/hover colours, typography, padding, border, border radius and box shadow.
    • Tickets bar — track/fill colours, height, labels and optional boosted tier markers.
  • Works with: PXS Competition Question validates before entry; PXS Quick Select syncs ticket quantity; PXS Odds Bar can react to the live selected quantity.
  • Boosted: When the product has active boosted tiers and boosted competitions are enabled in Settings → Competitions, the tickets bar can show boosted tier markers.

PXS Competition Progress Bar v1.0.0

Standalone ticket sales progress bar for a competition. Use it when you want the sold/remaining status in a different part of the layout from the purchase form, or when the Add to Cart widget has its built-in bar turned off.

  • Use on: Product page when Add to Cart does not show the bar, or secondary column.
  • Content tab:
    • Product ID — 0 uses the current product on single competition templates.
    • Label / display mode — follows the global ticket count setting (count vs percentage) while still allowing the widget to be positioned independently.
    • Boosted tier markers — shows tier thresholds when the competition is configured as boosted and global boosted mode is enabled.
  • Style tab: Bar track, fill, height, border radius, label typography, label colour and boosted tier marker styling.
  • Tip: Pair with PXS Boosted on boosted competitions so customers see both the progress bar and the stage cards.

PXS Odds bar v2.0.0

Shows approximate odds for the current ticket selection. It combines sold/max ticket counts, main-draw winner count, remaining instant-win prizes and the live quantity selected in PXS Add to Cart to give customers a clearer "chance" summary.

  • Use on: Single competition product templates, usually close to PXS Add to Cart.
  • Content tab:
    • Product ID — use current product or a fixed competition ID.
    • Display mode — show odds as a fraction, percentage, or both.
    • Current field line — optional line that updates when the customer changes ticket quantity.
    • Show / hide controls — control whether the odds output appears for products without enough ticket/winner data.
  • Style tab: Container spacing, background, border, label typography, odds text typography, colours and responsive alignment.
  • Tip: Keep it near the purchase controls; the live quantity sync makes most sense when customers can see the number changing as they move the Add to Cart quantity slider.

PXS Competition Question v1.0.0

Renders the skill or qualifier question attached to a competition product. Customers must choose the correct answer before entry when the underlying Competitions for WooCommerce product requires a question.

  • Use on: Single competition product templates, directly above or beside PXS Add to Cart.
  • Content tab:
    • Product ID — use the current product or a specific competition.
    • Question / answers output — displays the configured product question and answer choices from the competition product data.
    • Empty state — hides when the product has no question, keeping templates reusable across products.
  • Style tab: Question text, answer rows/buttons, selected answer state, spacing, border, background and responsive alignment.
  • Tip: Keep near Add to Cart so the participate button state and question validation are obvious to the customer.

PXS Countdown Timer v1.5.0

Countdown timer for competition start/end dates. It helps customers understand urgency on live competitions and can also show future start timing where the competition has not opened yet.

  • Use on: Single competition templates, card sections, landing pages and any area that needs a clear "time left" message.
  • Content tab:
    • Product ID — 0 uses the current competition; a product ID can be used for fixed landing sections.
    • Labels / messages — configure countdown copy for active, upcoming or ended states where available.
    • Units — displays days, hours, minutes and seconds using the product's competition date fields.
  • Style tab: Timer box layout, number typography, label typography, colours, spacing, background, border and responsive alignment.
  • Tip: Use near Add to Cart for urgency, or above a product hero to make the closing window visible before the customer scrolls.

PXS Quick Select v1.5.0

Preset ticket bundle buttons for faster entry. The quantities and optional discounts are configured on each competition product, then the widget syncs the selected bundle into PXS Add to Cart.

  • Use on: Single competition product templates, close to PXS Add to Cart.
  • Requires: Tick Enable quick select boxes on the competition product and configure Box 1–4 quantities and discounts.
  • Content tab:
    • Product ID — current product or fixed product ID.
    • Box output — shows the enabled preset boxes from the product settings.
    • Discount messaging — displays savings or discount labels when the product box has a discount percentage.
  • Style tab: Button/card layout, typography, normal/hover/selected colours, discount badge styling, gaps, padding, border and border radius.
  • Tip: Works best when visible above the quantity slider so customers can pick a bundle before pressing the participate button.

PXS Cash Alternative v1.5.0

Displays the cash alternative offer for a competition. It is only meaningful when the product has Offer cash alternative enabled and a cash amount set in the PXS product fields.

  • Use on: Single competition templates, prize detail sections and winner/claim education blocks.
  • Content tab:
    • Product ID — current product or fixed competition ID.
    • Text / label controls — configure the wording around the cash alternative amount where available.
    • Empty behaviour — hides when the product has no cash alternative enabled, keeping the template reusable.
  • Style tab: Wrapper, icon/label, amount typography, colours, padding, border, background and alignment.
  • Tip: The same amount is used later in the Claim Prize flow, so make sure the product's cash alternative amount is final before launch.

PXS Price v1.0.0

Styled ticket price output for a competition product. It can show regular/sale pricing with widget-specific classes, without relying on the theme's default WooCommerce price markup.

  • Use on: Single competition templates, hero layouts and product summary sections where the ticket price needs independent styling.
  • Content tab:
    • Product ID — 0 uses the current product; a fixed ID can be used in custom landing sections.
    • Text prefix / suffix — optional copy before/after the price (for example "Tickets from").
    • HTML tag — choose an appropriate wrapper tag for the price output.
    • Decimal places — use WooCommerce defaults or override for this widget.
  • Style tab: Price typography, regular/sale price colours, prefix/suffix typography, spacing and alignment.
  • Tip: Useful when the Add to Cart widget is lower on the page but you still want a prominent price near the product title or hero.

PXS Instant Tickets Table v1.0.0

Public table of instant-win tickets, prizes and winner status for a competition. It gives customers transparency over which instant prizes exist and which tickets have already been claimed or drawn.

  • Use on: Single competition product templates or a dedicated "instant prizes" section.
  • Content tab:
    • Product ID — current product or fixed competition ID.
    • Header title / labels — configure table heading copy and optional intro text where used.
    • Rows — displays ticket numbers, prize names/amounts and claimed/winner state from the competition instant-win data.
  • Style tab: Table wrapper, header, row colours, text typography, borders, spacing and status/winner highlight styling.
  • Alternative: Use shortcode [pxs_competition_instant_tickets] outside Elementor.
  • Tip: Pair with the Instant Win Generator workflow; after importing/attaching instant tickets, verify the table before launch.

PXS instant wins v1.5.0

Marketing-friendly instant-win prize display. It turns a competition's instant-win data into cards/lists that can be styled for product pages, landing pages and promotional sections.

  • Use on: Single competition templates, prize breakdown sections and campaign landing pages.
  • Content tab:
    • Product ID — use the current competition or a fixed product.
    • Heading / intro copy — optional title and supporting copy for the prize list.
    • Prize output — show instant-win prizes, quantities, values and winner/remaining state where available.
    • Empty state — hide or show fallback copy when no instant-win data exists.
  • Style tab: Wrapper, heading, prize cards, icons/badges, winner/claimed state, typography, colours, grid spacing, border and shadows.
  • Tip: Use this for the sales-focused "what can I instantly win?" section; use PXS Instant Tickets Table when customers need the ticket-number-level audit view.

PXS Multi Step v1.0.0

Reusable step-card layout for explaining how a competition or customer journey works. It is useful for "how to enter", "how the draw works", onboarding panels and promotional explainers.

  • Use on: Product landing pages, home page sections, how-it-works pages and support/FAQ content.
  • Content tab:
    • Steps — add/edit step items with title, description and optional icon/number styling depending on the widget setup.
    • Layout — configure columns, spacing and ordering for desktop/tablet/mobile.
    • Heading / intro — optional section title or supporting text where used.
  • Style tab: Step card background, border, number/icon badge, title typography, body typography, spacing, alignment and responsive grid settings.
  • Tip: Keep copy short; this widget is best for quick, scannable steps rather than long instructions.

PXS Hero v2.2.1

Minimal hero slider for the front page. Each slide uses a live competition: the product image is rendered as background: cover with the competition title, short description and a Play now for £X CTA stacked over the top. Hover reveals previous / next arrow boxes on the left and right edges.

  • Use on: The home page hero / banner row, or any wide section that needs a rotating competition spotlight.
  • Content tab:
    • Competitions to show — Live (started, not ended), Future (not yet started), or Live + future.
    • Number of slides — 1–20 (default 5).
    • Sort by — Manual (Hero competitions only — see the Hero competition tick-box on each competition product), Featured (competitions marked as featured first, newest as tie-break), Most popular (highest total sales), Ending soonest (closest to closing first), Newest, plus secondary modes Title (A–Z), Price, and Random. Tip: with a small slide count (e.g. 3) Manual gives you full editorial control of exactly which three competitions appear; Featured or Ending soonest are good automatic choices.
    • Manual order — Only shown when Sort by is Manual. Controls how the Hero-flagged competitions are arranged against each other: WooCommerce menu order, then newest (drag in the Products list), Newest first, Title (A–Z), or Random.
    • Direction — ASC / DESC, shown only for Title and Price. Other sort modes use their natural direction.
    • Featured competitions first — pin featured to the top of any other sort. Hidden when Sort by is set to Featured (always on there) or Manual (ignored).
    • Show short description with a word limit (uses the competition product's WooCommerce short description; 0 = no trim).
    • Show CTA button with an editable CTA prefix text (default Play now for) and a Price decimals override (blank = WooCommerce default).
    • Whole slide clickable — When on, clicking anywhere on the hero opens the competition.
    • Title HTML tag — H1–H6, p, or div (use H1 only when this is the page's main heading).
  • Slider tab:
    • Autoplay on/off, Pause between slides (seconds), Transition speed (ms), Pause on hover, and Loop slides.
    • Show navigation arrows with Arrows visibility set to On hover only or Always visible.
    • Show slide dots for click-to-slide pagination.
  • Style → Hero:
    • Height mode — Fixed height uses the responsive Hero height slider (px or vh). Aspect ratio keeps the hero in proportion to its width so the background image is not aggressively cropped on wide screens; pick a preset (21:9 cinematic, 16:9, 3:1, 4:1, 2:1, 3:2, 4:3, 1:1) or Custom width:height numbers. A responsive Minimum height (safety floor) slider stops narrow viewports collapsing the hero too far.
    • Image fit — Cover (default, fills the hero and crops as needed), Contain (whole image visible, may leave bars), or Auto (natural size).
    • Image position — choose which part of the image stays visible when cropping (center, top, bottom, left, right, or any corner).
    • Letterbox / fallback color — shown in any empty space around the image when Image fit is set to Contain or Auto.
    • Border radius, content padding, horizontal + vertical content alignment, content max-width and box shadow.
  • Style → Overlay (fade): Master Enable overlay switcher, Overlay color + Opacity slider, plus an optional Use gradient fade mode with Gradient start, Gradient end, and Gradient angle for directional fades (e.g. transparent at top → dark at bottom for legible text).
  • Style → Title / Description / CTA / Arrows / Slide dots: Full typography, colour, hover state, padding, border, border-radius and box-shadow controls per element. Arrows include separate Box size, Icon size and Edge offset sliders.
  • Accessibility: Touch swipe is supported, autoplay pauses when the browser tab is hidden, focus inside the hero pauses autoplay, and arrows have descriptive labels.

PXS Live Competitions v1.0.0

Main storefront grid for competition products. It can list live, future, all or ended competitions, with card badges, sale/instant-win/boosted tags, countdown/end-date lines, tickets progress, pagination or Browse more behaviour and extensive card styling.

  • Use on: Home page grids, competitions archive pages, category landing pages and "all competitions" pages.
  • Content tab:
    • Competition scope — choose current/live, future, all current+future, or ended competitions.
    • Query controls — posts per page, columns, order/orderby, category/tag filters, exclude current product, include/exclude sold-out products and featured-first ordering where available.
    • Card content toggles — show/hide product image, title, price, countdown, end/start date, tickets bar, badges, instant-win badge, sale badge, boosted badge and button states.
    • Actions — configure buy/view button text, disabled button labels, future/ended/sold-out wording and optional Browse more controls.
  • Style tab:
    • Grid / card — columns, gaps, card background, border, border radius, padding and shadows.
    • Image / badges — image radius, badge placement, sale badge, instant-win badge and boosted badge styles.
    • Text / price / dates — typography and colours for title, price, countdown, end date, start date, ended and sold-out labels.
    • Buttons — buy/view, future, sold-out and ended button normal/hover styles.
    • Tickets bar — track/fill, labels and boosted tier markers.
  • Boosted/product tags: Sale, Boosted and Instant wins badges respect the global switches in Settings → Competitions → Product tags; widget-level controls can still hide tags locally.

PXS Recent Instant Winners v1.5.0

Trust-building feed of recent instant winners across competitions. It shows winner names (respecting Safe Play identity masking), prizes, competitions and relative time so visitors can see recent activity.

  • Use on: Home page trust sections, winner pages, product pages and sidebars.
  • Content tab:
    • Heading / subtitle — section title and supporting copy.
    • Rows / pagination — max rows, per-page behaviour and optional search/filter controls where enabled.
    • Winner wording — configure the middle word (for example "wins") and empty-state copy.
    • Timeline badge — choose or style the icon/badge used beside each winner row.
  • Style tab: Panel, header, search input, timeline list, badge, winner name, prize, time, pagination buttons and empty-state typography/colours.
  • Tip: Safe Play identity masking is applied automatically for customers who hide their identity.

PXS Recent Drawn Winners v2.0.0

Timeline of main-draw winners after the PXS Winner Reveal process is closed for each competition. It gives public proof of completed draws and links recent winners back to the competition/prize context.

  • Use on: Winners pages, home page trust sections and account/support pages where you show draw transparency.
  • Content tab:
    • Heading / subtitle — defaults to "Recent draw winners" with explanatory copy.
    • Max rows / pagination — controls the winner history loaded into the timeline.
    • Search — optional search field and placeholder text.
    • Winner wording / empty state — customise "wins" text, no-results title and no-results subtitle.
  • Style tab: Inherits Recent Instant Winners timeline styling, plus draw-date typography/colour controls.
  • Requires: PXS Winner Reveal data. Winners appear after a competition draw has been completed and the reveal is closed.

PXS Winner name v2.0.0

Single-competition winner display for ended products. It shows the main-draw winner name and draw date/time once the winner reveal is closed.

  • Use on: Ended single competition product templates or archive cards for previously drawn competitions.
  • Content tab:
    • Product ID — 0 uses the current product, or pass a specific ended competition.
    • Label above name — optional label such as "Winner".
    • Show "time ago" line — adds a relative time between the winner name and site date/time.
    • Alignment — left, centre or right.
  • Style tab: Label, winner name, time-ago line and date/time typography, colour and spacing controls.
  • Tip: In the Elementor editor it shows a placeholder until the product is ended, drawn and reveal-closed.

PXS Jackpot v2.0.0

Displays the active timed/sales-linked jackpot managed in PXS Competitions → Jackpots. It can show the current prize fund, jackpot title, date window and supporting promotional copy so visitors understand the site-wide prize pool.

  • Use on: Home page, competition archive pages, header/promo strips and any landing page promoting the active jackpot.
  • Content tab:
    • Jackpot source — uses the active/scheduled jackpot from the Jackpots admin screen and global jackpot settings.
    • Heading / labels — configure title, prize label, empty/inactive text and supporting copy where available.
    • Countdown / dates — show jackpot start/end timing and active-state messaging.
    • CTA / link — optional button or link to competitions/jackpot page depending on layout.
  • Style tab: Wrapper, title, prize amount, labels, countdown/date row, CTA button, background, border, radius, padding and shadows.
  • Requires: A configured jackpot under PXS Competitions → Jackpots and sale contribution settings under Settings → Jackpot.

PXS Boosted v2.1.0

Shows boosted prize stages (ticket-sales % thresholds) as cards with progress and status; optional section title and current boosted prize box. Only relevant when Enable boosted competitions is on in Settings → Competitions and the product is configured as boosted with tiers.

  • Use on: Single competition product templates (or pass a specific competition product ID).
  • Content tab:
    • Product ID — current competition or a fixed product ID.
    • Section title / intro — optional heading and explanatory copy for the boosted stage panel.
    • Current boosted prize — optional highlighted current prize box using the product's base amount and passed tiers.
    • Stages — stage cards are generated from the product's base amount and up to three configured boosted tiers.
  • Style tab: Wrapper, section heading, current prize box, stage cards, stage status, progress indicators, typography, colours, borders, padding and shadows.
  • Tip: Pair with Add to Cart / Progress Bar so customers see both the bar tier markers and the stage cards.

PXS Trustpilot v1.5.0

Trustpilot-style review/trust block for adding social proof to competition pages. Use it to display rating copy, review snippets, star visuals or a Trustpilot link/summary depending on your configured content.

  • Use on: Home page, product pages, checkout reassurance areas and landing pages.
  • Content tab:
    • Heading / copy — configure trust headline, supporting text and rating/review wording.
    • Trustpilot link / label — add destination URL and CTA text where needed.
    • Stars / rating display — show star-style visuals and rating text according to the widget settings.
  • Style tab: Panel background, stars, rating text, heading typography, review text, button/link styling, spacing, border and responsive alignment.
  • Tip: Keep the displayed score/review copy aligned with your live Trustpilot account and update it when the rating changes.

PXS Scrolling Bar v1.5.0

Horizontal ticker / announcement strip that can mix live site activity: instant winners, main draw winners, newest competitions, latest ticket purchases and newest members. It is useful for trust, urgency and social proof across the top or bottom of a page.

  • Use on: Site header, home page, competition archive, product template top/bottom strips.
  • Content tab:
    • Latest instant winners, Latest main draw winners, Newest competitions, Latest ticket purchases and Newest members toggles.
    • Winner line middle word — customise the word between winner name and prize (for example "wins").
    • Tag pill text — customise Instant win, Winner, New competition, Purchase and New member tags.
    • Scroll direction, Ticker slowdown, Between items, Randomize & mix, Max lines per type, Max lines in the bar, and Empty message.
  • Style tab: Bar width/background/border/radius/padding/height, text colour/typography, separator colour/size, and separate tag styling for Instant Win, Winner, New Competition, Purchased and New Member tags.
  • Tip: Use Randomize & mix to avoid long blocks of one event type; keep max lines sensible so the ticker feels fresh but not noisy.

PXS Order Confirmation v2.0.0

Custom order-received / thank-you layout for competition purchases. It can show order details, purchased tickets, competition summaries and optional instant-win scratch-card style results after checkout.

  • Use on: WooCommerce “Thank you” Elementor template (order received).
  • Content tab:
    • Order source — uses the current WooCommerce order received context.
    • Heading / messages — configure success copy, empty/fallback text and customer-facing instructions.
    • Ticket/order details — show purchased competitions, ticket numbers, totals and relevant order meta.
    • Instant-win reveal — optional scratch-card/reveal presentation for instant prizes where configured.
  • Style tab: Wrapper, heading, order detail cards, ticket lists, scratch-card/reveal elements, success/winner states, buttons, typography, colours, borders, padding and responsive layout.
  • Tip: Use this on the actual order-received template; outside that context it may show fallback/empty content because no order is available.

PXS Notification v1.0.0

Customer notification dropdown for competition wins and account alerts. It gives logged-in customers a compact bell/menu style entry point to recent win notifications, with dismiss and optional refresh behaviour.

  • Use on: Header templates, account pages and customer dashboard layouts.
  • Content tab:
    • Guest / empty text — configure messages for logged-out users and users with no notifications.
    • Notification rows — displays win-related notifications from PXS helper data.
    • Refresh behaviour — widget script supports refresh-on-tab-focus and timed refresh settings provided by plugin filters.
  • Style tab: Bell/button, dropdown panel, notification rows, dismiss buttons, badges/counts, empty state, typography, colours, spacing, borders and shadows.
  • Tip: Only logged-in users see personalised notifications; pair with account/header navigation for best visibility.

PXS Wallet v1.5.0

Store-wallet balance display and entry point for customers using the compatible wallet plugin. It is useful in headers, My Account areas and checkout-support pages so customers can quickly see wallet credit.

  • Use on: Header, My Account dashboard, wallet pages and customer hub layouts.
  • Content tab:
    • Heading / label — configure wallet copy shown before/around the balance.
    • Guest behaviour — show login prompt or fallback text for logged-out visitors.
    • Balance output — reads the current user's wallet balance when available.
  • Style tab: Container, balance amount, label, icon/button, guest text, typography, colours, background, border, radius, padding and alignment.
  • Requires: Compatible wallet plugin (TeraWallet / Woo Wallet) active for live balances.

PXS Coin Wallet v2.2.0

Customer VIP coin balance display. Coins accrue from qualifying competition ticket spend according to Settings → Coins, separate from store wallet / site credit.

  • Use on: My Account dashboard, VIP/loyalty pages, header account panels and competition hub pages.
  • Content tab:
    • Heading / intro — configure copy explaining the customer's coin balance.
    • Guest text — message shown to logged-out visitors.
    • Balance output — shows current user's coin balance and related summary text where available.
  • Style tab: Box, heading, balance number, icon/coin visual, explanatory text, guest state, typography, colours, padding, border and shadow.
  • Requires: Coin wallet rules configured under PXS Competitions → Settings → Coins.

PXS Basket v1.0.0

Basket / mini-cart presentation for competition sites. It gives customers a compact way to review cart state, ticket quantities and checkout entry points without relying on the theme's default mini-cart.

  • Use on: Header templates, sticky bars, account hubs and cart/checkout navigation sections.
  • Content tab:
    • Basket label / empty text — configure copy for populated and empty basket states.
    • Cart summary — show item count, totals and checkout/cart links depending on configuration.
    • Icon / badge — compact basket icon with count badge for header layouts.
  • Style tab: Basket icon, count badge, container, text, links/buttons, empty state, colours, spacing, border and hover state.
  • Tip: Use with the checkout countdown/cart hold messaging so customers understand they have reserved tickets waiting.

PXS Claim Prize v2.0.0

Claim interface for winners after a draw or instant win. It guides eligible customers through choosing the main prize or cash alternative where available, and gives operators claim records in the Prize Claims admin area.

  • Use on: My Account claim page, dedicated winner claim page, or page linked from winner emails/notifications.
  • Content tab:
    • Heading / instructions — explain what the winner needs to do and what happens next.
    • Claim options — main prize and cash alternative choices, depending on the product and claim rules.
    • Guest / no-claim states — messages for logged-out visitors, ineligible users or expired/no active claims.
    • Confirmation text — copy shown after a claim is submitted.
  • Style tab: Claim panel, option cards, buttons, status callouts, form text, confirmation state, typography, colours, border, padding and shadows.
  • Requires: Prize Claims flow enabled/configured and a qualifying winner/claim window.

PXS Safe Play v2.2.0

Responsible gaming: pause playing, monthly competition spend limit, and hide identity. Requires logged-in customers for the full UI.

  • Use on: A dedicated WordPress page selected in Settings → General → My Account Safe Play page (embedded in My Account), or any page for a standalone URL.
  • Content: Optional page title (default My Self Play), logged-out message, visibility (everyone / logged-in / logged-out).
  • Style: Container, title, active pause notice, section cards, typography, and toggle styling on the Style tab.
  • Operator note: One widget per configured Safe Play page is enough; My Account embeds this page’s Elementor design.

PXS Referral v2.2.0

Customer referral block: reward summary, how-it-works steps, referral code/link copy buttons, welcome-bonus progress, and referrer tracker.

  • Use on: A dedicated WordPress page selected in Settings → Referrals → My Account Referrals page (embedded in My Account), or any page for a standalone referral area.
  • Requires: Enable referrals under Settings → Referrals. TeraWallet is required for wallet credits.
  • Content: Heading, intro text, and logged-out message.
  • Style: Full per-section styling: box, heading, intro, reward cards, steps, share controls, progress bars, panels, stats list, status callouts, tracker cards, referrer table, status chips, hint text, and guest text.
  • Operator note: One widget on the configured referrals page is enough; My Account embeds this page’s Elementor design at /my-account/referrals/. Leave the page selector unset to use the built-in inline referral block.

PXS Claim Prize Icon v2.0.0

Compact icon/link entry point for the prize claim flow. Use it when you need a small visual CTA in a header, dashboard card or winner notification layout rather than the full Claim Prize panel.

  • Use on: My Account dashboards, header/account menus, winner hub pages and custom notification sections.
  • Content tab:
    • Icon — choose the visual icon for the claim action.
    • Text / label — optional short label beside or under the icon.
    • Link — point to the full Claim Prize page or My Account claim endpoint.
  • Style tab: Icon size, icon colour, label typography, normal/hover state, wrapper background, border, radius, padding and alignment.
  • Tip: Keep the label short: "Claim prize", "Prize claim" or "My wins" works best in compact layouts.

PXS Competition Hub v1.0.0

Dashboard-style hub for competition customers. It can present key account/competition links, quick stats, wallet/coin/referral/safe-play destinations and action cards in one branded block.

  • Use on: My Account landing pages, customer dashboard pages, competition hubs and members/VIP pages.
  • Content tab:
    • Heading / intro — customise the hub title and explanatory copy.
    • Hub cards / links — configure cards that point to competitions, basket, wallet, referrals, claims, Safe Play or other account areas.
    • Visibility / guest text — control what logged-out visitors see and which account panels are shown.
    • Stats / summary sections — optional customer-facing summary areas depending on enabled features.
  • Style tab: Hub wrapper, heading, cards, icons, buttons, stats, panels, typography, colours, gap, padding, border, radius and responsive columns.
  • Tip: Use as the "front door" for logged-in customers: link out to PXS Referral, Safe Play, Coin Wallet, Claim Prize and active competitions pages.

PXS Icon v1.0.0

General-purpose icon/content block for custom PXS layouts. It is handy for small feature cards, trust points, instructions, prize highlights and reusable branded icon rows.

  • Use on: Product sections, home page feature rows, FAQ/support layouts, hub cards and promotional strips.
  • Content tab:
    • Icon — choose an Elementor icon or image-style visual depending on the control setup.
    • Title / text — short headline and supporting copy.
    • Link — optional destination for clickable cards/icons.
    • Alignment — position icon/text for row, card or centred layouts.
  • Style tab: Icon size/colour/background, title/body typography, spacing, card background, border, radius, shadow and hover state.
  • Tip: Use when a full specialised widget is too heavy and you just need a branded icon + copy block.

Shortcodes

Shortcode Purpose Notes
[pxs_competition_cash_alternative] Cash alternative block. Optional product_id when not on single product.
[pxs_competition_instant_tickets] Instant tickets table. Optional product_id, header_title.
[checkout_countdown] Cart hold countdown. Configure timer copy under PXS Settings; place on cart/checkout.
[pxs_boosted_prize] Current boosted cash prize for a boosted competition. Requires global boosted mode + product boosted settings. Optional product_id, label, title_tag. Hidden when boosted is disabled.
[pxs_referral] Referral code, share link, reward summary, welcome-bonus progress, and referrer tracker. Requires Referrals enabled. Optional heading, intro, guest_text, and placement. The Elementor PXS Referral widget is preferred when styling a My Account referrals page.

WooCommerce & catalog tools v1.0.0

  • Orders list — Optional PXS columns/filters (HPOS-compatible).
  • Users list — Optional PXS columns.
  • Products list — Competition status column (Active / Finished / Fail) and filters for competition rows.
  • Dashboard — The v2.2.1 full-screen layout is the standard Dashboard → Home screen (always on).
  • Competition Health v2.2.1 — Optional Dashboard → Health Dashboard page (enabled under PXS Settings → Admin): an Overall Health Score gauge (0–100, weighted by ticket pool and sales pace), live health KPIs across four bands (Excellent above 70% sold, Good 40–70%, Moderate 25–40%, Low under 25%), a sortable competitions-at-a-glance list with sell-through bars/status badges, a health distribution doughnut, and insight recommendations.

Customer journeys (overview)

  1. Browse — Live / Related grids → single competition.
  2. Enter — Countdown, question, Add to Cart + Quick Select + Odds bar as configured; boosted competitions may show stage progress (PXS Boosted) and tier markers on the sold bar.
  3. Checkout — Checkout countdown holds reservation per settings; if Enable 18+ checkbox on checkout is on (Settings → Checkout), the customer must confirm they are 18+ below the terms checkbox.
  4. After purchase — Order Confirmation widget (+ scratch cards); notifications for wins.
  5. Winners — Winner Reveal (staff) → Winner name / Recent Drawn Winners on site; Claim Prize / My Account for fulfilment. Customers with Hide identity see a masked name on public winner feeds.
  6. Referrals — Optional My Account tab for sharing referral code/link, tracking invited friends, and monitoring qualifying spend; see Referrals.
  7. Cashback — Optional My Account tab (shown while a cashback campaign is configured) for tracking qualifying spend, tier reached, and cashback due; see Cashback campaign.
  8. Safe Play — Optional My Account tab for pause, monthly spend limit, and identity masking; see Safe Play.

PXS Competition Addons — operator guide (HTML), aligned with v2.2.1. Plugin documentation also lives in the plugin root README.md and CHANGELOG.md. Update this file when new widgets or admin pages ship.