v2.2Welcome!

How to use this guide

• Use the left navigation or On this page (right) to jump between sections.
• Each figure loads images/… next to this file — save screenshots using the exact filenames shown next to each <img> tag.
• Elementor widgets require Elementor active and usually a template built for your competition / shop pages.

What’s new in 2.2.0

• Referral and cashback programme — Wallet credits for ticket cashback and referral rewards. Configure under PXS Competitions → Settings → Cashback & referrals: enable the program, cashback %, referral reward amounts, qualifying spend, referral cookie duration, and whether store-wallet checkout counts toward referrals.
• 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.
• Optimised backend and settings — Settings reorganised into tabs (General, Jackpot, Checkout, Cashback & referrals, 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. Loyalty referrals have a separate wallet toggle on the Cashback & referrals tab.
• 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 → General → 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, cashback, referral credits, 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

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

Admin screens (detail)

Capture each primary PXS screen after logging in as a shop manager. Use full-width desktop screenshots where possible.

Winner Reveal

Closed Competitions

Jackpots

Instant Win Generator

Prize Claims

Global settings (Settings screen)

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

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

• General — Ticket count view (count vs %), boosted competitions master switch, manual picking highlight, Safe Play My Account page selector, claim prize visibility window.
• Jackpot — Sale contribution % and wallet order contributions.
• Checkout — Enable 18+ checkbox on checkout; cart hold countdown; redirect after checkout (order complete page).
• Cashback & referrals — Loyalty program, cashback %, referral rewards and cookies.
• Coins — Coin wallet accrual and spend-per-coin rate.
• Admin — WooCommerce orders/users list columns and dashboard widgets.
• 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.

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

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.
• 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, boosted master switch, 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).

Featured competitions

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

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. Example: Box 1 = 5 tickets with 0% off, Box 2 = 10 tickets with 2.5% off—the widget syncs quantity with PXS Add to Cart when a box is chosen.

Boosted competitions v2.2.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—for example, base £100, then at 50% sold the prize becomes £150, at 75% sold it becomes £200. Requires Enable boosted competitions in Settings → General.

Instant wins

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

Jackpots

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

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

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 TeraWallet cashback). Global rules live under Settings → Coins; customers see balances via the coin wallet widget and account areas you configure.

Coins settings

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

User balances

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

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.

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.

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.

Shortcodes

WooCommerce & catalog tools

• 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 — Optional PXS widgets (stats, charts).

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. Safe Play — Optional My Account tab for pause, monthly spend limit, and identity masking; see Safe Play.