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.
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.
WordPress Lucky Wheel Spin and Win provide a shortcode that allows you to display the WordPress Lucky Wheel on any page.
[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.[wordpress_lucky_wheel bg_image="image_url.png"]
bg_image="img.com/photos.jpg"
bg_color="#ffffff"
text_color="#303030"
pointer_color="#303030"
spin_button_color="#303030"
spin_button_bg_color="#303030"
pointer_position="top"
wheel_dot_color="#303030"
wheel_border_color="#303030"
wheel_center_color="#303030"
spinning_time="5"
wheel_speed="2"
custom_field_name_enable="yes"
custom_field_name_enable_mobile="yes"
custom_field_name_required="yes"
custom_field_mobile_enable="yes"
custom_field_mobile_enable_mobile="yes"
custom_field_mobile_required="yes"
font_size="12"
wheel_size="90"
congratulations_effect="firework"
wheel_center_image="img.com/photos.jpg"
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.
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:
WordPress Lucky Wheel Spin and Win allow visitors to give you permission to collect their information.
Change the front-end design of the Lucky Wheel pop-up with so many built-in options.
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.
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.
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:
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.
In Wheel Background Tab, you can change the design of the Lucky Wheel pop-up.
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:
2. “Name” field:
3. “Phone number” field:
Configure the wheel and its segments in Wheel Settings Tab.
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.
Customize/Edit the email content of the emails sent to customers and admin in this settings page.
Configure the front-end messages which appear after spinning.
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.
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.
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.
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:
For further information about Access your HubSpot API key
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.
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
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.
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.
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.
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:
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.
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.
* Note: Follow the Guide to get Google reCAPTCHA V3 Site and Secret key.
WordPress Lucky Wheel provides a shortcode to display the WordPress Lucky Wheel on any page.
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.wordpress_lucky_wheel bg_image="image_url.png"]
bg_image="img.com/photos.jpg"
bg_color="#ffffff"
text_color="#303030"
pointer_color="#303030"
spin_button_color="#303030"
spin_button_bg_color="#303030"
wheel_dot_color="#303030"
wheel_border_color="#303030"
wheel_center_color="#303030"
pointer_position="top"
spinning_time="5"
wheel_speed="2"
custom_field_name_enable="yes"
custom_field_name_enable_mobile="yes"
custom_field_name_required="yes"
custom_field_mobile_enable="yes"
custom_field_mobile_enable_mobile="yes"
custom_field_mobile_required="yes"
font_size="12"
wheel_size="90"
congratulations_effect="firework"
wheel_center_image="img.com/photos.jpg"
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.
Plugin | Author | Compatible |
---|---|---|
9Mail – WordPress Email Templates Designer | VillaTheme | Fully |
WPML | OnTheGoSystems | Fully |
Polylang | WP SYNTEX | Fully |
FunnelKit | FunnelKit | Fully |
Thank you for your attention!
If you have any question, please create a topic at our FORUM, we will support within 24 hours.