WordPress Lucky Wheel


Created: 03/2018

Latest updated: 08/2024 – Updated version: 1.3.2

By: VillaTheme

Thank you for purchasing our plugin. If you have any questions that are beyond the scope of this documentation, please feel free to request support at our Support Forum. Thanks so much!

Lucky Wheel Spin and Win are like a game that helps to motivate purchasing.  Lucky Wheel Spin and Win are considered a commonly used marketing strategy by shop owners, Shoppers can not only buy goods, but they can also play the fortunate wheel games, which would be amazing if they win coupons or gifts, It truly promises to enhance their buying experience and promote customer shopping returns.

WordPress Lucky Wheel, Lucky Wheel Spin and Win plugin give you the best solution to get subscribers from your WordPress website. WordPress Lucky Wheel Spin and Win get subscribers by allowing visitors to fill in their email addresses and subscribe to your newsletter to spin for prizes. This is the best way to get subscribers from visitors, they will be pleased to fill in their email addresses. Prizes will be sent to subscribers automatically. Email addresses will be saved in the back-end and can be automatically synced with some famous email marketing platforms such as MailChimp, Active Campaign, Sendgrid, Klaviyo, Brevo (Sendinblue), MailPoet, Hubspot, FunnelKit.

LUCKY WHEEL SPIN TO WIN POP-UP

WordPress Lucky Wheel Spin and Win display a Lucky Wheel pop-up when users visit your website, allowing them to subscribe to their emails and spin to win prizes.

  • Server-side calculation: the result will be calculated on the server-side. No cheating.
  • Adding up to 20 slides: WordPress Lucky Wheel Spin and Win allows you to add up to 20 slides to the Lucky Wheel.
  • Winning probability: select the winning probability of each slide.
  • Pop-up intent: display the wheel after the scheduled time, after scrolling down the page, or when visitors are about to leave.
  • Lucky Wheel icon: a small lucky wheel icon, allow visitors to open the Luck Wheel pop-up.
  • Icon position: select the wheel icon position on the screen. There are 6 icon positions for you to select: bottom left, bottom right, top left, top right, middle left, middle right.
  • Initial time: schedule a time for the Lucky Wheel pop-up to appear after the page finish loading.
  • Scroll amount: select a scroll amount in percentage. The Lucky Wheel pop-up will appear when visitors scroll down this amount.
  • Spinning time: select how many times an email address can be used to spin the wheel.
  • Wheel spinning duration: set up how long the wheel will take to finish a spin.
  • Conditional Tags: you can display the lucky wheel on selected pages only. Using built-in options for Homepage, Blog pages, Shop page or using WordPress conditional tags.
  • Wheel Description: display the description of the wheel.
  • Custom fields: you can add up to 3 fields to your Lucky Wheel pop-up, including email, name, phone number.
  • Show pop-up after closing without spin: select a time to display the lucky wheel pop-up if a visitor closes it without spinning.
  • Show pop-up after a successful spin: select a time to display the lucky wheel pop-up after a successful spin.
  • Automatically hide wheel after finishing spinning: automatically hide the lucky wheel pop-up.
  • Delay time between each spin: select the delay between each spin of an email address.
  • Wheel speed: you change the rolling speed of the lucky wheel. There are ten speeds from 1 to 10 for you to select.

 

LUCKY WHEEL PAGE

WordPress Lucky Wheel Spin and Win provide a shortcode that allows you to display the WordPress Lucky Wheel on any page.

  • Shortcode: the shortcode  [wordpress_lucky_wheel] will display the lucky wheel. The lucky wheel displayed by the shortcode is the same as the WordPress Lucky Wheel Spin and Win pop-up will all elements. You can use this shortcode to create a lucky wheel page where you allow customers to subscribe to email and spin the wheel for discount coupons.
  • Shortcode params: you can add parameters to the short to change it without changing WordPress Lucky Wheel settings. Below is a list of WordPress Lucky Wheel Spin and Win shortcode para, to use these parameters you just need to add them into the shortcode. For example to change the background [wordpress_lucky_wheel bg_image="image_url.png"]
  • bg_image: allow to change the background image using a picture URL. Example: bg_image="img.com/photos.jpg"
  • bg_color: change the background color using color code. Example: bg_color="#ffffff"
  • text_color: change the lucky wheel text color of the lucky wheel. Example:text_color="#303030"
  • pointer_color: change the pointer color. Example:pointer_color="#303030"
  • spin_button_color: change the spin button text color. Example:spin_button_color="#303030"
  • spin_button_bg_color: change the spin button background-color. Example:spin_button_bg_color="#303030" 
  • pointer_position: change the pointer position. You can put in one of these value centers, bottom, right, top, random. Example:pointer_position="top"
  • wheel_dot_color: change the small bot on the border of the lucky wheel color. Example:wheel_dot_color="#303030"
  • wheel_border_color: change lucky wheel border color. Example:wheel_border_color="#303030"
  • wheel_center_color: change the lucky wheel center color. Example:wheel_center_color="#303030"
  • spinning_time: change the spinning time. Example: set up the wheel to spin in 5 secondsspinning_time="5"
  • wheel_speed: change the wheel spin speed, enter a value from 1 to 10. Example:wheel_speed="2"
  • custom_field_name_enable: this shortcode allows you to enable the name field. Example:custom_field_name_enable="yes"
  • custom_field_name_enable_mobile: allows you to enable the name field on mobile. Example:custom_field_name_enable_mobile="yes"
  • custom_field_name_required: select if the name field is required. Example:custom_field_name_required="yes"
  • custom_field_mobile_enable: select if you want to enable the mobile phone number field. Example:custom_field_mobile_enable="yes"
  • custom_field_mobile_enable_mobile: select if you want to enable the mobile phone number field on mobile. Example:custom_field_mobile_enable_mobile="yes"
  • custom_field_mobile_required: select if the mobile phone number is required. Example:custom_field_mobile_required="yes"
  • font_size: change the font size of the text of the lucky wheel. Example:font_size="12"
  • wheel_size: change the size of the wheel.  Example: To display the wheel with 90% sizewheel_size="90"
  • congratulations_effect: select the congratulation effect when customers win a prize. Example:congratulations_effect="firework"
  • wheel_center_image: allow to use of an image instead of color on the wheel center. Example: wheel_center_image="img.com/photos.jpg"

 

COLLECT EMAIL USING WORDPRESS LUCKY WHEEL SPIN AND WIN

Subscribed emails will be saved to your database. You can export to have CSV files of email addresses. This WordPress Lucky Wheel Spin and Win plugin also helps you to sync with some famous email marketing platforms such as MailChimp, Active Campaign, Sendgrid, Klaviyo, Brevo (Sendinblue), MailPoet, Hubspot, FunnelKit email list using API keys.

  • Save Emails: you can view subscribed emails in the plugin’s backend with email addresses, subscribed time, customer name, phone number, spun time, coupons, wheel slide label of the last spin.
  • Export CSV file: select a date range and export the subscribed email at that time into a CSV file.
  • Report: The report feature allows you to check the quantity of subscribed emails, spins, given coupons at a specific time.

 

EMAIL API 

This plugin integrates some email marketing platforms, allowing subscribed emails to sync to these platforms and perform other marketing strategies as needed. The email marketing platforms available:

  • Mailchimp
  • Sendgrid
  • Active Campaign
  • Hubspot
  • MailPoet
  • Klaviyo
  • Brevo (Sendinblue)
  • FunnelKit

GDPR COMPLIANCE IN WORDPRESS LUCKY WHEEL SPIN AND WIN

WordPress Lucky Wheel Spin and Win allow visitors to give you permission to collect their information.

  • GDPR Checkbox: the GDPR checkbox allows customers to agree with your site’s Terms of Use and Conditions. By ticking on the GDPR Checkbox, visitors give you permission to collect their information.
  • GDPR Message: set up your GDPR/ Term of use and Conditions message as an HTML form.

 

DESIGN IN WORDPRESS LUCKY WHEEL SPIN AND WIN

Change the front-end design of the Lucky Wheel pop-up with so many built-in options.

  • Show full wheel: WordPress Lucky Wheel Spin and Win offer 2 wheel styles on desktop full-size and half-size.
  • Background: Select an image or pick a color to use as your background.
  • Background effect: Select a full-screen animation effect to display along with the lucky wheel pop-up.
  • Winning effect: Display a full-screen animation effect when the visitor wins a prize.
  • Text color: Select the color of the text on the plugin.
  • Spin button: Change label text, text color, and background color of the spin button.
  • Wheel border-color: Pick colors for the wheel border and dots in the border.
  • Pointer position: Select a pointer color and position. There are 4 pointer positions for you to select the top, bottom, right, middle.
  • Wheel slide text size: Change the text size of the labels on slides.
  • Font: Select the font family of the wheel pop-up.
  • Wheel center color: Select a color for the wheel center. You also can upload a picture here.
  • Wheel size: You are able to change the size of the Wheel.
  • Currency: Choose to display currency symbol ($, €… ) or currency code (USD, EUR…) on the Lucky Wheel pop-up.
  • Wheel slide: Change the text color and background color of each slide.
  • Auto-color: This option allows you to change the color of the wheel automatically.
  • Custom CSS: Add CSS code to change the front-end design of the pop-up.
  • Preview: The plugin allows you to preview the wheel design in your back-end.

 

SUPPORT GOOGLE RECAPTCHA

Google reCAPTCHA helps protect websites from spam and abuse. A “CAPTCHA” is a turing test to tell human and bots apart. It is easy for humans to solve, but hard for “bots” and other malicious software to figure out. By adding reCAPTCHA to a site, you can block automated software while helping your welcome users to enter with ease.

The Google reCAPTCHA feature of the plugin is now available from version 1.1.1.

 

ADDITIONAL FEATURES 

  • Auto-update: update the plugin automatically in your back-end.
  • AJAX end-point: WordPress Lucky Wheel Spin and Win provide 2 AJAX endpoints to make sure the pop-up works fine on your site.
  • Multilingual support: WordPress Lucky Wheel Spin and Win support multi-languages. You can create different front-end messages, emails, descriptions for different languages. This option is working with WPML and Polylang plugins.

System Requires:

Make sure that those limits are to a minimum as follows for free-trouble while installing:

  • WordPress 5.x+
  • PHP 7.x+

 

Install Plugin:

Go to Plugin/Add New /Upload Plugin/Choose file/ select plugin file zip/ Install Now/Active Plugin

Done, let start learning how to use the plugin.

After a successful install, go to Dashboard/ WP Lucky Wheel/ to configure the WordPress Lucky Wheel plugin.

Remember to enable the plugin in the General Tab, also set up spin times options here.

 

Move to the Wheel Background Tab, in this tab, you can customize the Wheel design on the front-end with Logo, description, background …

 

 

In the Wheel Settings Tab, configure the number of pieces, the price, winning probability, the color of each piece.

 

 

In the Email API tab, configure to sync customer data collected from spinning the wheel to available email marketing platforms such as MailChimp, Active Campaign, Sendgrid, Klaviyo, Brevo (Sendinblue), MailPoet, Hubspot, FunnelKit.

How does it work


General

  1. Enable: Enable the plugin settings.
  2. Enable mobile: Enable the plugin settings for mobile users.
  3. Ajax endpoint: Select the endpoint. Only use REST API if Ajax is not working for you
  4. The number of spins per email: How many times the email address owner can spin the wheel.
  5. Gap between 2 spins: Gap time between 2 consecutive spins of an email.
  6. Choose using white/black list: This option allows you to select the email spinning based on either a “whitelist” or “blacklist”
    • Whitelist: If you choose this option, only emails on a predefined list (whitelist) will be eligible for spinning.
    • Blacklist: With this option, emails on a predefined list (blacklist) will be excluded from spinning, while all other emails will be eligible for spinning
  7. White list: Enter domains to this list, each domain per line, leave empty if not use this feature. For example: abc@email.com is “email.com”
  8. Auto reset spin: Reset the total of every email to zero at a specific time. For example, set at 12:00 AM every day, all total spins of every email will be reset to zero.
    So every email is able to keep spinning with the number of spins as you set in the spinning time of an email address at that time.

 

 

Pop-up

The pop-up is the small icon that appears in the corner of your site. Click on the pop-up will open the wheel.

 

 

1. Custom popup icon: There are many icon templates for you to choose from. When clicking on the icon, the lucky wheel popup will be opened.

2. Custom popup icon color: Select the color of the popup icon as you want.

3. Custom popup icon background color: Select the color of the popup icon background.

4. Popup icon position: There are some positions to display the popup icon, available: Top left; Top right; Middle left, Middle right; Botton left; Botton right.

5. Select intent: The intent is what will open the WordPress Lucky Wheel pop-up. There are 5 options:

  • Popup icon: display a small icon on the screen. The pop-up will appear when customers click on the icon.
  • Automatically show wheel after initial time: display the pop-up after an initial time.
  • Show wheel after users scroll down a specific value: display the pop-up after customers scroll down on your pages.
  • Show wheel when users move their mouse over the top to close the browser: display the pop-up when customers are about to leave your page.
  • Random one of these above: random one of the above options each time customers visit your page to open the pop-up.

6. Initial time: the delay time before opening the WordPress Lucky Wheel pop-up after finishing loading the page.

7. Hide popup icon: This allows you to hide the popup icon that is used to open the wheel when you click on it.

 

 

8. If customers close and do not spin, show popup again after when a customer closes the pop-up without spinning it, display the pop-up after this selected time.

9. When finishing a spin, show popup again after when a customer finish spinning the wheel, display the pop-up after this time.

10. Show only on Homepage: display the pop-up only on your Homepage.

11. Show only on the Blog page: display the pop-up only on your blog.

12. Conditional tags: Use WordPress conditional tags to configure which page you want to display the Lucky Wheel pop-up.

Important note:

To handle WP’s Conditional Tags, this plugin uses eval() which is very dangerous because it allows the execution of arbitrary PHP code. Therefore, please only fill this field with proper conditional tags which are validated and/or provided by trusted developers.

Wheel Background

In Wheel Background Tab, you can change the design of the Lucky Wheel pop-up.

  1. Background image: Add the wheel background image.
  2. Background color: Select wheel background color.
  3. Background effect: Select one effect for the wheel background.
  4. Content text color: Text color in the wheel background content, including wheel description, text to not show the wheel again.
  5. Wheel description: Create the description for your wheel.
  6. Spin Wheel button: Add the label for the Spin Wheel button.
  7. Spin Wheel button color: Select the color for the label above.
  8. Spin Wheel button background color: Select the background color for the Spin Wheel button
  9. Not display wheel again: This option shows a few text, allow user to hide the wheel after clicking one of them.
  10. Select font: Font of the wheel background text content.
  11. GDPR checkbox: Enable GDPR checkbox.
  12. GDPR message: Add your GDPR message.
  13. Custom CSS: Add your custom CSS if there’s no customization above match your need.

 

 

Custom Fields

In the Custom Fields settings, you can control which fields are displayed or hidden on mobile and PC. You can also set fields as mandatory to ensure that essential user information is collected.

1. “Email” field:

    • Enable a field for users to enter their email before spinning
    • Enable a field for users to enter their email before spinning on the mobile
    • Make this field mandatory. User must enter their email before spinning

2. “Name” field:

    • a field for users to enter their name before spinning
    • Enable a field for users to enter their name before spinning on the mobile
    • Make this field mandatory. User must enter their name before spinning

3. “Phone number” field:

    • Enable a field for users to enter their phone number before spinning
    • Enable a field for users to enter their phone number before spinning on the mobile
    • Make this field mandatory. User must enter their phone number before spinning
    • Enable to display the country code on the phone number field

 

 

 

Wheel Settings

Configure the wheel and its segments in Wheel Settings Tab.

  • After finish your settings and customization, if you want to see how it will look like, click “Preview Wheel” button on the top right corner.
  • In the premium version, you can add unlimited number of segments to the wheel. Do it by hovering over a particular segment, clicking the green “Clone” button to duplicate that current segment.

 

  1. Pointer position: select the pointer position. There are 4 positions for you to select Center, Bottom, Right and Top.
  2. Wheel pointer color: select the pointer color.
  3. Wheel center background image: upload an when center image.
  4. Wheel center color: select a wheel center color. This option will be overwritten by the wheel center image.
  5. Wheel border color: select a wheel border color.
  6. Wheel border dot color: select a wheel border dot color.
  7. Wheel speed: Choose the speed of spin.
  8. Wheel spinning duration: the spinning time from when customers hit the spin button until the wheel stop.
  9. Show full wheel: this option allows you choose to display full wheel or half on the desktop.
  10. Adjust font size of text on the wheel by(%): configure the text font size on the wheel.
  11. Adjust wheel size by (%): Adjust the wheel size.

 

1. {quantity_label} is used in prize label if quantity is greater than 0

2. Index: The number of wheel parts with each prize on the lucky wheel.

3. Prize type: You can customize to display Non prize or custom prizes in WordPress Lucky Wheel.

– Non: The visitor wins nothing .

– Custom: Add many custom prizes as you need in each slice of the wheel.

4. Label: Enter the label for the prize value of each slide. The shortcode {quantity_label} to display in prize label if quantity is greater than 0.

For example: An Iphone {quantity_label}, if there are 3 Iphone prizes left, the wheel slice will show: Iphone (3 left).

5.Value: enter the prize of each slide.

6. Probability(%): You can change the probability to get a prize.  To change probability, please adjust weight, weight total must be 100%.

7. Quantity: The Number of prizes available in stock to give customers. Set quantity to -1 to not limit the number of prizes. Each time a customer wins a prize, its quantity will be automatically reduced by 1.

8. Color: Select the slide background color of each slide.

9. Text color: Select the text color of each wheel slide.

10. Auto color: set up slide color automatically.

11. Enable option to Color is set randomly from predefined sets for each visitor.

 

 

Emails

Customize/Edit the email content of the emails sent to customers and admin in this settings page.

 

  1. “From” name: Name of the sender.
  2. “From” address: Email address of the sender.
  3. Email subject: Subject of the email.
  4. Email heading: Header of the email.
  5. Email content: Edit the content; add the media and the shortcode; apply the HTML/CSS if needed; and preview the email before the real sending.
  6. Footer text: Custom text for the email footer.
  7. Base color: Email base color.
  8. Background color: Email background color.
  9. Body background color: Background color of the email content
  10. Body text color: Text color of the email content.
  11. Enable admin notification: Enable this option to send the admin(s) notification when an user wins a prize.
  12. Send notification to: The receiver’s address. If this field is blank, the “From” email will be used.
  13. Notification Email subject: Subject of the notification email to admin.
  14. Notification Email heading: Header of the notification email to admin.
  15. Notification Email content: Edit the content; add the media and the shortcode; apply the HTML/CSS if needed; and preview the email before the real sending.

 

 

Inform Result

Configure the front-end messages which appear after spinning.

  1. Automatically hide wheel after finishing spinning: Hide the wheel after spinning. Leave 0 to disable this feature.
  2. Frontend Message if win: This message shows if the user wins a prize. Edit the content here.
  3. Winning effect: Show your congratulation with one of these effects.
  4. Frontend message if lost: Show this message when the user does not win a prize after spinning.

 

 

Email API

 

  1. Enable/Disable MailChimp API.
  2. Enter your MailChimp API key
  3. Select a MailChimp List, subscribing emails will be added to this list.
  4. Enable/Disable  Active Campaign API.
  5. Enter you Active Campaign API Key.
  6. Enter your Active Campaign API URL.
  7. Select an Active Campaign list, subscribing emails will be added to this list.
  8. Enable/Disable SendGrid API.
  9. Enter your SendGrid API Key.
  10. Select a SendGrid list, subscribing emails will be added to this list.

A. Email API configuration for Mailchimp

1. Enable/Disable MailChimp API.

2. Mailchimp API Key: You need to enter the Mailchimp API key to make it work. Click on the “here” to direct to the page you can create an API key on your Mailchimp account. Copy the API key to the “Mailchimp API Key” box in WP Lucky Wheel Setting. Then, Click on the Save button.

3. Choose the Mailchimp list you want to work with WP Lucky Wheel and save it again.

B. Email API configuration for Active Campaign

 

1. Enable/Disable  Active Campaign API.

2 and 3: Sign in to your Active campaign account, Go to settings/Dashboard/ Developer/ Copy the URL and Key to the Active Campaign API key and Active Campaign API URL boxes in the WP Lucky Wheel Settings then click on the Save button.

4. Choose the active campaign list you want to work with WP Lucky Wheel.

C. Email API configuration for Sendgrid

1. Enable/Disable SendGrid API.

2. Log in your SendGrid account, go to settings/API keys/ Create an API Key then copy the key which has just been created to the SendGrid API Key box in the WP Lucky Wheel Enter your SendGrid API Key then click on the Save button,

3. Select a SendGrid list, subscribing emails will be added to this list.

D. Email API configuration for Hubspot

1. Enable/Disable Hubspot API.

2. Hubspot API key: You need to enter the Hubspot API key to make it work. Please follow these steps:

  • In your HubSpot account, click the settings icon in the main navigation bar.
  • In the left sidebar menu, navigate to Integrations > API key.
    • If a key has never been generated for your account, click Generate API key.
    • If you’ve already generated an API key, click Show to display your key.

  • With the key displayed, click Copy to copy the key. You can then paste the key to provide it to your developers or use it in your applications.

For further information about Access your HubSpot API key

E. Email API configuration for Klaviyo

1. Enable/Disable Klaviyo API.

2. Klaviyo API key: You need to enter the Klaviyo API key to make it work. Go to get the API key here.

3. Klaviyo version API: Select the supported Klaviyo API versions.

4. Klaviyo list: Choose the Klaviyo list you want to work with WP Lucky Wheel and save it again.

F. Email API configuration for Brevo (Sendinblue)

1. Enable/Disable Brevo API.

2. Brevo API key: You need to enter the Brevo API key to make it work. Click here and register/login to obtain the API key.

a. Go to SMTP & API section

b. Create a new API key

c. Copy API key and paste to the Brevo API key field in the plugin.

3. Brevo list: Choose the Brevo list you want to work with WP Lucky Wheel and save it again.

Important note: When you are mapping to the SMS field, the Mobile Number should be passed with the proper country code.

For example, it can only accept the value to be either +91xxxxxxxxxx or 0091xxxxxxxxxx form. Any other value entered would result in an error, hence the form submission will not be successful.

This means that the field type has to be a TEXT type if you want it to accept both formats (i.e +91xxxxxxxxxx or 0091xxxxxxxxxx). E.g 0061467029760 or +61467029760

G. Email API configuration for MailPoet

To let the MailPoet settings appear on the Email API tab of the WordPress Lucky Wheel plugin, you must install the MailPoet plugin. These steps are below:

Step 1: Install the MailPoet plugin

Step 2: Go to the MailPoet website: mailpoet.com and sign up for a plan. Go to Account, Copy the key in your MailPoet settings to use the plan.

Step 3: Go to the MailPoet’s setting in WordPress, paste that key.

Step 4: Go to WP Lucky Wheel > Mail API, the MailPoet settings will appear there.

Step 5: Enable/Disable Mailpoet API.

Step 6: Choose the Mailpoet list you want to work with WP Lucky Wheel and save it again.

H. Email API configuration for Mailster

To let the Mailster settings appear on the Email API settings, you must install and activate the Mailster plugin. This plugin does not have a free version. The steps are as follows:

Step 1: Install the Mailster – Email Newsletter Plugin for WordPress plugin

Step 2: Now the Mailster settings are available in the Email API settings. You don’t need an API key to use, simply enable Mailster API.

Step 3: Select one Mailster list. There’ll always be a Default list.

 

 

I. Email API configuration for Sendy

Sendy is a self hosted application that runs on your web server. Pay once and there’s no recurring fee. At the moment, it does not have a free plan

To connect to your email list on Sendy, you must have a Sendy account activated, and follow the steps below:

Step 1: Enable Sendy

Step 2: Go to your account settings and get the API key. See instruction at: https://sendy.co/api

Step 3: Enter your Sendy login URL >> Hit “Save” button

Step 4: Now your Sendy brands are available to select. After selecting brand in “Sendy Brand” field >> Hit “Save” button again

Step 5: After step 4, email list of the brand you select is available >> Choose the list you want your spinners’ email to go to >> Hit “Save” the last time.

That’s pretty much for the connecting Sendy to our plugin.

 

 

J. Email API configuration for Metrilo

1. Enable/Disable Metrilo API.

2. Metrilo Token: You need to enter the Metrilo token to make it work. Please visit the website: https://www.metrilo.com/ follow this guide:

Step 1. Go to your WordPress administration
Step 2. Go to Plugins, then click “Add New”. Type “metrilo” in the search box.
Step 3. Install the plugin and click “Activate”
Step 4. Go to WooCommerce Settings, then click the “Integration” tab
Step 5. Enter your API Token: xxxxx for Metrilo
Step 6. Enter your API Secret: xxxxx and click “Save Settings”
Copy the API Token in step 5 into the Metrilo token field of this WC Lucky Wheel.
3. Metrilo tag: Create many tags as you want, these tags will be synced to the customer list in Metrilo
4. Subscribed: enable or disable this option if the user has optioned in for receiving emails

K. Email API configuration for FunnelKit

  1. Enable/Disable to sync the lucky wheel data to the FunnelKit
  2. FunnelKit List: Choose the Funnel list you want to work with WP Lucky Wheel
  3. FunnelKit Status: Choose (a) specific statuses for the snippers on FunnelKit

To use this function, ensure that your site has core FunnelKit plugins installed:

Step 1: In the Dashboard > Go to FunnelKit Automations > Contacts, create Lists

Step 2: Go to WP Lucky Wheel > Email API, choose the lists you’ve created and wish to synchronize with.

After your site visitors spin on your site, their data will be synced automatically to the list contact of FunnelKit

Google reCAPTCHA

Google reCAPTCHA helps protect websites from spam and abuse. A “CAPTCHA” is a turing test to tell human and bots apart. It is easy for humans to solve, but hard for “bots” and other malicious software to figure out. By adding reCAPTCHA to a site, you can block automated software while helping your welcome users to enter with ease.

  • ReCaptcha 2: “I’m not a robot” Checkbox. This requires the user to click a checkbox indicating the user is not a robot. This will either pass the user immediately (with No CAPTCHA) or challenge them to validate whether or not they are human. This is the simplest option to integrate with and only requires two lines of HTML to render the checkbox.
  • ReCaptcha 3: reCAPTCHA v3 allows you to verify if an interaction is legitimate without any user interaction. It is a pure JavaScript API returning a score, giving you the ability to take action in the context of your site: for instance requiring additional factors of authentication, sending a post to moderation, or throttling bots that may be scraping content.

*  Note: Follow the Guide to get Google reCAPTCHA V3 Site and Secret key.

Shortcodes

WordPress Lucky Wheel provides a shortcode to display the WordPress Lucky Wheel on any page.

  • Shortcode: the shortcode  [wordpress_lucky_wheel] will display the lucky wheel. The lucky wheel displayed by the shortcode is the same as the lucky wheel pop-up will all elements. You can use this shortcode to create a lucky wheel page where you allow customers to subscribe to email and spin the wheel for discount coupons.
  • Shortcode params: you can add parameters to the short to change it without changing WordPress Lucky Wheel settings. Below is a list of WordPress Lucky Wheel shortcode para, to use these parameters you just need to add it into the shortcode. For example to change the background [wordpress_lucky_wheel bg_image="image_url.png"]
  • bg_image: allow to change the background image using a picture URL. For example: bg_image="img.com/photos.jpg"
  • bg_color: change the background color using color code. For example: bg_color="#ffffff"
  • text_color: change the lucky wheel text color of the lucky wheel. For example :text_color="#303030"
  • pointer_color: change the pointer color. For example:pointer_color="#303030"
  • spin_button_color: change the spin button text color. For example:spin_button_color="#303030"
  • spin_button_bg_color: change the spin button background-color. For example:spin_button_bg_color="#303030"
  • wheel_dot_color: change the small bot on the border of the lucky wheel color. For example:wheel_dot_color="#303030"
  • wheel_border_color: change lucky wheel border color. For example:wheel_border_color="#303030"
  • wheel_center_color: change the lucky wheel center color. For example:wheel_center_color="#303030"
  • pointer_position: change the pointer position. You can put in one of these value centers, bottom, right, top, random. For example:pointer_position="top"
  • spinning_time: change the spinning time. For example: set up the wheel to spin in 5 secondsspinning_time="5"
  • wheel_speed: change the wheel spin speed, enter a value from 1 to 10. For example:wheel_speed="2"
  • custom_field_name_enable: this shortcode allows you to enable the name field. For example:custom_field_name_enable="yes"
  • custom_field_name_enable_mobile: allows you to enable the name field on mobile. For example:custom_field_name_enable_mobile="yes"
  • custom_field_name_required: select if the name field is required. For example:custom_field_name_required="yes"
  • custom_field_mobile_enable: select if you want to enable the mobile phone number field. For example:custom_field_mobile_enable="yes"
  • custom_field_mobile_enable_mobile: select if you want to enable the mobile phone number field on mobile. For example::custom_field_mobile_enable_mobile="yes"
  • custom_field_mobile_required: select if the mobile phone number is required. For example::custom_field_mobile_required="yes"
  • font_size: change the font size of the text of the lucky wheel. For example::font_size="12"
  • wheel_size: change the size of the wheel.  For example: display the wheel with 90% sizewheel_size="90"
  • congratulations_effect: select the congratulation effect when customers win a prize. For example:congratulations_effect="firework"
  • wheel_center_image: allow to use of an image instead of color on the wheel center. For example: wheel_center_image="img.com/photos.jpg"

 

Hooks

Our plugin provides 3 hooks in case you want to redirect customer to another page after spinning. They are:

'wplwl_redirect_after_spin' value true/false

'wplwl_redirect_after_win' value string url

'wplwl_redirect_after_lost' value string url

An example for how to use the hooks: add_filter('wplwl_redirect_after_spin', '__return_true', 99);

After configuring the hook, you can add it to your theme function php or follow this instruction to add it using another plugin.

BUT for the hooks we added for you, each hook can only redirect to one page. Which means you only have 1 page for winning and one page for not lucky customers
If you want more, like 6 different pages for 6 rewards, it’s not available.

 

compatibility


 

Plugin Author Compatible
9Mail – WordPress Email Templates Designer  VillaTheme Fully
WPML OnTheGoSystems Fully
Polylang WP SYNTEX Fully
FunnelKit FunnelKit Fully

Extra Information


Thank you for your attention!

If you have any question, please create a topic at our FORUM, we will support within 24 hours.