Prizes and odds

Each prize has a label, a type, an amount, a weight and a stock.

• Type is what the winner gets: a percentage discount, a fixed cart or product discount, free shipping, or "no luck" for a blank slice.
• Weight sets the odds relative to the other slices. A slice with weight 20 is twice as likely to be landed on as one with weight 10. The weights do not need to add up to anything in particular: the chance each one gives is shown under it as a percentage, and the line under the table says how many spins win anything at all, or that only No luck can come up. Both keep up as you type, add or remove a prize, change a type, or tick Sold out, which takes a prize out of the odds.
• Stock caps how many times a prize can be won. Leave it at 0 for unlimited. When a positive stock runs out, the prize is marked Sold out under its row and is no longer awarded. It stays sold out when you change its weight or save the screen: enter a new stock to offer it again, or untick Sold out to offer it with no limit. The stock is taken the moment the wheel draws the prize, before its coupon is made, so two shoppers spinning at once cannot both win the last one: the second spin lands on another slice. A prize the wheel has shown is never taken back. If no other slice can be won, the second shopper is told no prizes are available and keeps their spin; if the coupon cannot be made, the one taken goes back to the stock. In the rare case that the prizes are changed again and again while a shopper spins, they are asked to try again in a moment and keep their spin. A shopper turned away at that point is not kept as a lead unless they had spun before. A change you save while a shopper wins is not written over by the win. The Stock boxes show the numbers from when you opened the Wheel screen. A box you leave as it is is saved as the number left for that prize when you press Save, so a prize won while the screen was open keeps that win, and one that sold out meanwhile stays sold out. That holds when another tab or another administrator saved the prizes in between: each prize is followed wherever it moved, and if it was made a different prize there, whichever of the two stocks offers fewer is kept. A number you type, a Sold out box you untick, or a row you make into a different prize (a new type, amount or coupon rules) is saved as you set it. A prize removed in another tab meanwhile comes back when you save, with the stock your screen showed. After the save the screen shows the numbers as they are then. Saving the Settings, Display or Email Lists screen, or turning the wheel on or off, leaves the prizes as they are at that moment. On a database cluster that does not share MySQL's named locks between its servers, a win in the same instant as a save can still be lost to that save.
• Coupon rules (optional, under the row) lets one prize take its limits from a coupon you already made. See Coupon rules for one prize below.

A wheel needs at least three slices and a prize that can be won before it can go live. A No luck slice is not a prize, so weight on No luck alone does not count. If a save leaves the wheel without them, the message says so: with fewer than three prizes the appearance is saved and the prizes are not, and when every prize has a weight of 0 or is sold out the wheel is saved but cannot go live. When only No luck has a weight, it says that only No luck can come up. Mixing in a couple of "no luck" slices keeps the good prizes feeling special.

When the last prize with a stock sells out and nothing else can be won, the wheel stops showing on your shop, even if a No luck slice has a weight: it does not go on asking for email addresses and marketing consent for spins that can only land on No luck. The page caches it knows (the same list as for the Schedule, below) are emptied once so no cached page keeps the popup, and the Dashboard says No prize can be won right now. Where you placed the wheel with the shortcode, you see a note that says no prize can be won, and visitors see nothing. Give a sold-out prize a new stock, or untick Sold out, or give another prize a weight above 0, and it comes back. Raising the weight of a sold-out prize does not.

New shops start with six example prizes, written in your site's language and, for the fixed-amount one, in your store's currency.

On a narrow screen, such as a phone or a window with the preview beside the prizes and little room left, each prize's fields are stacked: the label and the type a line each, then amount, weight and stock side by side with their names over them, then the colours with the remove button at the end. The keyboard goes through a row in the same order the eye does.

Showing shoppers the prizes and their chances#

Wheel → Prizes and Chances. With Show shoppers the prizes and their chances on, a Prizes and chances link under the Spin button opens a short list inside the popup, and on the inline wheel:

• each prize that can be won now, with its chance, such as 10% off: 25%, and the No luck slices together as No prize: 40%. The chances come from the same weights the draw uses, so a sold-out prize, a prize with a weight of 0 and a prize waiting for its coupon rules are not listed, and the others are shares of what is left. They are shown to one decimal place; when that makes them add up to a little more or less than 100%, the list says they are rounded. A chance under a tenth of a percent reads less than 0.1%;
• a prize with Coupon rules names its conditions under it, the same Conditions: line a winner reads after the spin, with anything looser than your Coupon Defaults and its own expiry;
• what every code is, from Settings → Coupon Defaults: how many days it lasts, the minimum spend, how many times it can be used, that it works only with the winner's email, that it cannot be combined with other coupons, that sale items are left out and that it gives free shipping, each only where you have set it;
• how often one email address may play, from Spins per email and Wait between spins, and the end of the Schedule on the Display screen, with its time, if it has one;
• a link to your own Terms page, if you choose one.

The link opens and closes from the keyboard, a screen reader says whether the list is open, and it works without JavaScript too. The list is still there after the spin, under the result.

Show how many are left adds the real number still to be won beside each prize with a stock, such as 20 left. It is off unless you switch it on. While it is on, the list is read from your site again each time a shopper opens it, so a page cache never shows an old count, and the page with [trasl_lucky_wheel_rules] on it is not cached.

[trasl_lucky_wheel_rules] shows the same list on a page of your own, such as your terms. Like the inline wheel it keeps to the Schedule: outside it, and while the wheel is off, visitors see nothing there and an administrator sees a note saying why.

Chances change when a prize sells out. While the link is on, or once the shortcode has been placed on a page, the page caches the plugin knows (the same list as for the Schedule) are emptied when a prize sells out or comes back, so no cached page shows the old chances. An ordinary win, which leaves every weight as it was, empties nothing.

New shops have the link on. A shop that had the wheel before keeps its popup as it was, and the Dashboard offers the link once, with Switch it on and No thanks.

The list says what you have set in the plugin, so shoppers can see it before they play. It is not legal advice and not a set of terms and conditions: if your promotion needs those, write them on a page and choose it as the Terms page.