When it appears

The Display screen controls the popup. Choose how it opens — after a delay, once the visitor scrolls part way, on exit intent, or only when they press the launcher or one of your own links — and how long to wait before showing it again to the same person. You can add a floating launcher tab, and switch the wheel off on phones with Show on mobile devices under Other Options. With Only when the shopper presses the launcher or one of my links the wheel never opens by itself, and the launcher is the way in on every page, so it is always shown then and its switch is greyed out. To place the wheel inside a page or post instead, use the shortcode [trasl_lucky_wheel].

On exit intent opens the popup when the cursor heads for the top of the window. Phones and tablets have no cursor, so there it opens when the visitor has read some way down the page and then scrolls quickly back up, which is what a visitor about to leave usually does.

Show again after (hours) is for a visitor who closed the popup. A visitor who has spun is left alone for as long as the wheel will not let them spin again: a year with one spin per email, and otherwise the wait between spins or the Show again after time, whichever is longer. Once an address has used every spin it is allowed, that browser is left alone for a year. The launcher stays, if you show one.

On a small phone, or a phone on its side, the popup can be taller than the screen. It then scrolls, with the close button kept in view at the top, and on a phone on its side the wheel and the form stay side by side.

A floating launcher at the bottom of the screen moves up to stand on top of a bar another Traslatability plugin has fixed there, such as Free Shipping Bar's bottom bar, instead of sitting underneath it. At the top of the screen it moves down below Free Shipping Bar's top bar in the same way. In the middle of a side it steps in beside Social Share's floating buttons when they are on that side, rather than covering them.

The launcher is drawn in your Pointer colour, which is the same orange it has always been until you change it. Its label is black or white, whichever can be read on that colour, and a pale colour also gets a hairline edge so the tab can still be found on a white page.

The launcher's words are your Spin button text, and they are also its name for a screen reader or voice control, so a shopper who says "click Spin the wheel" reaches it. On a phone the tab shows only its mark, and keeps the same name for a screen reader. With the text left empty, the tab and the Spin button both say "Spin the wheel".

Once a shopper has opened the popup and closed it, it does not open again by itself on that page when its delay, scroll depth or exit intent comes round.

Opening it from your own links#

The wheel can be something you promote: a menu item, a button, a banner, a link in a newsletter or a social post. Open it from your own links on the Display screen has the three things to copy.

• #trlw-open as a link's address. In Appearance → Menus add a Custom Link with the address #trlw-open; on a button or a banner image, link to #trlw-open. Pressing it opens the popup on the page the shopper is on.
• A page address with #trlw-open on the end, such as https://yourshop.com/sale/#trlw-open, in an email or a post. The page opens with the wheel already open, and #trlw-open is taken off the address so a reload or a shared link does not open it again.
• The class trlw-open on anything your theme or page builder lets you give a class to. Pressing it opens the wheel.
• [trasl_lucky_wheel_button] draws a button in your theme's own button style, with your Spin button text on it. Give it words of its own with [trasl_lucky_wheel_button text="Try your luck"].

The shopper has asked, so these open the wheel even for somebody who closed it before or pressed No thanks, and on phones when Show on mobile devices is off. The triggers are not changed by them: after No thanks the popup still never opens by itself. Opened from a link, focus goes into the popup, and back to the link when it closes.

The wheel's own rules still hold. A link works on the pages the wheel shows on (Display on, Exclude and Audience); elsewhere it does nothing. The button is the exception, as the inline wheel is: a page it is placed on gets the wheel, opening only when the button is pressed, even if Display on leaves that page out. Outside the Schedule, or with the wheel switched off, nothing is on the page for a link to open and the button is not drawn (an administrator sees a note in its place saying why). Every spin is still checked on your server, so a second spin with the same email gets the usual message instead of another prize.

On a page with the inline wheel, a link takes the shopper down to that wheel and into its first field, rather than open a second wheel over it.