WooCommerce Lucky Wheel


Created: 08/2018

Latest updated: 03/2022 – Updated version: 1.1.4

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 attract customers to subscribe through spinning the lucky wheel and gain the prize. Lucky wheel spin and win will encourage customers to come back to your website to purchase, increase traffic and improve sales and revenue.

WooCommerce Lucky Wheel is a WooCommerce extension that helps you to convert your site traffic into customers or at least, an email subscriber. It takes you a lot of work and money to have traffic to your store, so don’t waste it. Lucky wheel spin and win offers visitor entering their email address to spin the lucky wheel. Then the plugin will send a discount coupon to the subscribed email address. The subscribed email addresses from lucky wheel spin and win will be saved in the back-end and can be synced with some famous email marketing platforms such as MailChimp, Active Campaign, Sendgrid, Klaviyo, Sendinblue, MailPoet, Hubspot, and Metrilo.

  • Allowing customers to subscribe to emails through lucky wheel spin and win discount coupons.
  • Auto-generate unique coupons with selected options.
  • Send coupon code to the email address that is required to spin the wheel.
  • Sync customer emails from lucky wheel spin and win to your MailChimp, Active Campaign, Sendgrid, Klaviyo, Sendinblue, MailPoet, Hubspot, and Metrilo.

 

FEATURES:

LUCKY WHEEL POP-UP

This lucky wheel spin and win plugin display a Lucky Wheel pop-up when users visit your website. Allowing them to subscribe to 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: the plugin allows you to add up to 20 slides to the Lucky Wheel.
  • Wheel label: add a custom label for each wheel slide.
  • 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.
  • Popup icon position: Select the pop-up icon position on your site front-end, available: Top left, Top right, Middle left, Middle right, Bottom left, Bottom right.
  • Hide popup icon: Option to hide the popup icon.
  • 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. This will be displayed in the front-end.
  • 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.
  • Delay time between each spin: select the delay between each spin of an email address.
  • Do not display again: allows customers to hide the pop-up if they don’t want to subscribe.,
  • Automatically hide wheel after finishing spinning: automatically hide the lucky wheel pop-up after the scheduled time.
  • 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

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

  • Shortcode: the shortcode  [woocommerce_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 WooCommerce Lucky Wheel settings. Below is a list of WooCommerce Lucky Wheel shortcode para, to use these parameters you just need to add it into the shortcode. For example to change the background [woocommerce_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"

 

GENERATE AND SEND COUPON FROM LUCKY WHEEL SPIN AND WIN

Coupons will be sent to subscribed emails which collect from lucky wheel spin to win. So you need to choose using existing WooCommerce coupons or let WooCommerce Lucky Wheel generates unique coupons with given values.

  • Existing coupons: select a WooCommerce coupon to use as the prize for each slide.
  • Unique coupons: Create unique lucky wheel coupons like the way to generate WooCommerce Coupons. You can add a suffix title for this unique coupon to distinguish it from other coupon types.
  • Front-end message: the plugin allows you to create and display different messages when customers win a prize or do not win. Use shortcodes to display necessary information in your message. {coupon_label}: the label of coupon that customers win.{checkout}: “Checkout” with a link to the checkout page. {customer_name}: customers’ name if they enter. {customer_email}: the email that customers enter to spin. {coupon_code}: coupon code/customs value will be sent to the customer.
  • Coupon email: coupons will be sent to the winner automatically. The plugin provides shortcodes to display information:{customer_name}: customer’s name.{coupon_code}: coupon code.{date_expires}: the expiry date of the coupon.{coupon_label}: the label of the wheel slide that the visitor hit when spinning the wheel.{featured_products}: display a list of featured products.{shop_now}: display a “Shop Now” button in the email, redirect to your shop page.
  • Suggested products: select specific products to display at the bottom of the coupon email.
  • Send email to admin: the plugin will send a notification email to admin whenever a customer wins a prize with the lucky wheel. The email included the coupon, the email address of the winner. And you are able to edit this notification email.

 

WHEEL PRIZE 

The Wheel prizes section allows you to create as many coupon prizes as you want, this helps you to quickly create,  customize and manage coupon prizes for the lucky wheel on the Wheel Prizes page. The wheel prize section is designed as a page listing available wheel prizes. You can edit, quick edit, trash, duplicate a wheel prize on this page. On each page, you can configure the coupon in detail.

 

COLLECT EMAIL FROM LUCKY WHEEL SPIN AND WIN

Subscribed emails from lucky wheel spin and win will be saved to your database. You can export to have CSV files of email addresses. Then lucky wheel spin and win also helps you to sync emails to your email marketing platforms (Email API).

  • 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 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
  • SendinBlue
  • Metrilo

 

GDPR COMPLIANCE

The Lucky wheel spin and win plugin allow visitors to give you permission to collect their information. Therefore, your site can fit with the GDPR law of Europe.

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

 

DESIGN LUCKY WHEEL SPIN AND WIN 

The plugin provides many design options that allow you to change the front-end design of the lucky wheel. So you can change the background, the text color, each slide color.

  • Preview: the plugin allows you to preview the wheel in your backend.
  • Show full wheel: the plugin 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: change the color of the text on the Lucky Wheel pop-up.
  • Font: select the font family of the text on the Lucky Wheel pop-up.
  • Spin button: design the spin button with options for label text, text color, background color.
  • Wheel center color: select a color for the wheel center, you also can use a picture to display in the center of the wheel.
  • Pointer: select the position of the wheel pointer center, top, right, or bottom. You can change the color of the pointer.
  • Wheel border: change the color of the wheel border and dots on the border.
  • Currency: choose to display currency symbol ($, €… ) or currency code (USD, EUR…) on the Lucky Wheel pop-up.
  • Wheel slides: change the label text size, text color, and background color of the wheel slide.
  • Wheel size: plugin allows to change the size of the wheel.
  • Icon position: select the wheel icon position on the screen. There are 6 icon positions bottom left, bottom right, top left, top right, middle left, middle right. And the icon can be hidden after a successful spin.
  • Auto-color: this option allows you to automatically color up the wheel.
  • Custom CSS: This Lucky wheel spin and win plugin offer the Custom CSS section which allows you to add custom design for the wheel on the front 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 dashboard.
  • AJAX end-point: The plugin provides 2 AJAX endpoints to make sure the pop-up works fine on your site.
  • Multilingual support:  This lucky wheel spin and win plugin support multi-languages. So you can create different front-end messages, emails, descriptions for different languages. However, this option is working with WPML and Polylang plugin.

Install Plugin:

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

Done! Let’s start using the plugin.

This video guides you on how to install and use the plugin:

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

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

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

 

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

 

 

In Mail API Tab, 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
  • SendinBlue
  • Metrilo

 

After finishing those settings, your lucky wheel is now ready to collect emails from your customers.

General

  1. Enable/Disable the WooCommerce Lucky Wheel plugin.
  2. Enable/Disable the WooCommerce Lucky Wheel plugin on mobile devices.
  3. Select the “REST API” option or Ajax option.
  4. Select how many time can an email address spin the wheel.
  5. The time between each spin of an email address.

Pop-up

  1. Select the pop-up icon position on your site front-end
  2. Select the intent. This is the trigger that will open the lucky wheel pop-up. There are4 intent for you to select.
    Pop-up icon, display an icon and the pop-up will appear when visitors click on this icon.
    Automatically show wheel after an initial time: display the wheel after a selected time.
    Show wheel after users scroll down a specific value: after visitor scroll your site a specific value (by percentage) the lucky wheel pop-up will appear.
    Show wheel when users move the mouse over the top to close the browser: display the lucky wheel when the visitor is going to leave your site.
    Random one of these above: random one of 4 options above to display the lucky wheel pop-up.
  3. The initial delay time for the lucky wheel pop-up to appear.
  4. The lucky wheel pop-up will appear when the user scrolls his/her mouse amount out of the page.
  5. Hide the pop-up icon.
  6. Display the lucky wheel pop-up after this time when customers refuse to spin it.
  7. After a successful spin, the wheel will be hidden in this selected time.
  8. Select where will the wheel appear using WordPress conditional tags, you can learn more about WP conditional tag

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.

Design

  1. Upload a background image.
  2. Or pick a background color.
  3. Select a background effect. There are 7 options for you to select.
  4. Pick a color for the wheel text. The color of the wheel label.
  5. Type in your wheel description text. This is an HTML form.
  6. The Spin button text.
  7. The color of the Spin button text.
  8. The spin button background color.
  9. Display the option to allow customers to avoid the wheel forever.
  10. Select the font for the front-end style.
  11. Display GDPR check box.
  12. Type in your GDPR message.
  13. Add Custom CSS code to change the front-end style.

Custom Field

The Custom Field tab allows you to configure which fields will appear on front-end. The email field is required, this is a must, so the email name settings does not appear here. But you can choose to display the name and the telephone fields or not.

  1. Enable/Disable the name field.
  2. Enable/Disable the name field on mobile.
  3. Select if the name field is required.
  4. Enable/Disable the mobile field.
  5. Enable/Disable the mobile field on mobile.
  6. Select if the mobile field is required.

Inform Result

 

Select a time to automatically hide the lucky wheel after a successful spin

  1. Automatically hide wheel after finishing spinning: After a successful spin, the lucky wheel pop-up will automatically close after this time.
  2. Email subject: the subject of the email the plugin send to customers when they win a prize.
  3. Email heading: the heading of the email the plugin send to customers when they win a prize.
  4. Email content: the content of the email the plugin send to customers when they win a prize. You can use shortcodes to display information about
  5. Suggested products: select some product to display as suggested products at the end of the coupon email.
  6. Button “Shop now” title: the text of the shop now button in the congratulation email.
  7. Button “Shop now” URL: the URL of the “Shop Now” button.
  8. Button “Shop now” color: pick a color for the shop now button text.
  9. Button “Shop now” background color: pick a color for the shop now button background.
  10. Button “Shop now” font size(px): select the text font size of Shop Now button.
  11. Frontend Message if win: set up the front-end message when customers win some prize. You can use shortcodes to display coupon label, check out page link, customer name, customer email and coupon code in this message.
  12. Winning effect: select an effect to display when customers win a prize, there is one effect “firework” now.
  13. Frontend message if lost: configure the frontend message when customers hit the non-prize slide.

Wheel Settings

  1. Pointer position: Select the position of the lucky wheel pointer: Center, top, right, bottom, random.
  2. Wheel pointer color: Choose color for the pointer.
  3. Wheel center background image: Add image for the small wheel in the center of the lucky wheel.
  4. Wheel center color: Select color for the small wheel in the center of the lucky wheel.
  5. Wheel border color: Select color for the border of the wheel.
  6. Wheel border dot color: Select color for the dot the in the border of the wheel.
  7. Display currency: Select if you want to display the currency symbol ($) or currency code (USD) on the wheel.
  8. Wheel speed: Choose the speed of spin.
  9. Wheel spinning duration: Select the spinning duration. It can be set from 3 seconds to 15 seconds.
  10. Show full wheel: Choose the front-end size of the lucky wheel. You can choose to display full wheel or half on front-end.
  11. Adjust font size of text on the wheel by: Adjust font size of the text in the wheel.
  12. 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. The coupon type: There are 6 coupon types you can select:
– Non: the visitor wins nothing.
– Existing coupon: choose an existing coupon to give.
– Percentage discount: the plugin will generate a coupon with your select value to give.
– Fixed product discount: discount a specific amount on a product price.
– Fixed cart discount: discount a specific amount on cart total.
– Custom: give a custom prize to customers. Anything you want to give.

4. Label: Set up coupon labels, and prize labels that you offer to your customers. You can use:

– The shortcode {coupon_amount} to display the coupon value in labels.

– 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 part will show: Iphone (3 left).

– To create more flexible prizes, please go to Wheel Prizes section in the plugin setting.

5. Values: Value of prizes can be coupon codes with respective minus amount with coupon value and/or physical prizes.

– For existing coupon type, you can search for available WooCommerce coupons, you can learn how to create and manage WooCommerce Coupon here.

– For generated coupon type, you can add the coupon value.

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. Email template: Choose available email templates to send different emails for each prize, please use WooCommerce Email Template Customizer or Email Template Customizer for WooCommerce to create and customize your own email template.

 

8.1. How to send Lucky wheel emails using the WooCommerce Email Template Customizer plugin.

Step 1. Activate the WooCommerce Lucky Wheel premium version and WooCommerce Email Template Customizer free or premium version.

Step 2. Choose available lucky wheel templates in the Email template option  that are designed in the WooCommerce Email Template Customizer plugin.

8.2. How to build and customize Lucky wheel email templates in the WooCommerce Email Template Customizer plugin.

You can build unlimited lucky wheel email templates using layouts and elements of WooCommerce Email Template Customizer, and shortcodes designed uniquely for WooCommerce Lucky Wheel. You can read how to build email templates here, how to customize available email templates here, look for available lucky wheel shortcodes here. After building a lucky wheel template, save that email template under “WooCommerce Lucky Wheel – Coupon email” type.

* If you don’t use WooCommerce Email Template Customizer plugin to design the lucky wheel email, default email will be used, you can customize the default template in the Inform Result tab

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

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

11. Auto color: set up slide color automatically.

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

13. Preview: Preview the wheel front-end design in your back end.

Unique Coupon

In this tab, you can configure settings of the unique coupons the plugin generate and send to customers.

  1. Allow free shipping: choose if the coupon grand free shipping.
  2. Time to live: generated coupon will be expired after this time.
  3. Minimum spend: the minimum spend amount that can use generated coupons.
  4. Maximum spend: the maximum spend amount that can use generated coupons.
  5. Individual use only: choose if generated coupons can be used with other coupons.
  6. Exclude sale items: choose if generated coupons can be used with sale items.
  7. Products that the coupon will be applied to: choose some specific items that generated coupon can be applied.
  8. Usage limit per coupon: choose how many times this coupon can be used before it is void.
  9. Limit usage to X items: choose the maximum number of individual items this coupon can apply to when using product discount.
  10. Usage limit per user: choose how many times this coupon can be used by an individual user.
  11. Coupon code prefix: choose a prefix text for generated coupons.

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 double optin:  Enable Mailchimp double option to send email to each subscriber to confirm that they subscribe to your list successfully. If they agree to subscribe, the data will be allowed to sync to the Mailchimp contact list.

3. 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 WC Lucky Wheel Setting. Then, Click on the Save button.

4. Choose the Mailchimp list you want to work with WC 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 WC Lucky Wheel Settings then click on the Save button.

4. Choose the active campaign list you want to work with WC 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 WC 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 list: Choose the Klaviyo list you want to work with WC Lucky Wheel and save it again.

 

F. Email API configuration for Sendinblue

1. Enable/Disable Sendinblue API.

2. Sendinblue API key: You need to enter the Sendinblue API key to make it work.

a. Go to SMTP & API section

b. Create a new API key

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

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

G. Email API configuration for MailPoet

To let the MailPoet settings appear on the Email API tab of the WooCommerce 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 WooCommerce, paste that key.

Step 4: Go to WC 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 WC Lucky Wheel and save it again.

H. 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

Update

Enter you Envato purchase code to enable the auto-update option.

Shortcode

WooCommerce Lucky Wheel provides a shortcode to display the WooCommerce Lucky Wheel on any pages.

  • Shortcode: the shortcode  [woocommerce_lucky_wheel] will display the lucky wheel. The lucky wheel displayed by the shortcode is 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 email and spin the wheel for discount coupons.
  • Shortcode params: you can add parameters to the short to change it without changing WooCommerce Lucky Wheel settings. Below is a list of WooCommerce Lucky Wheel shortcode para, to use these parameters you just need to add it into the shortcode. For example to change the background [woocommerce_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 center, 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 an image instead of color on the wheel center. For example: wheel_center_image="img.com/photos.jpg"

 

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.

The Wheel prizes section allows you to create as many coupon prizes as you want, this helps you to quickly create,  customize and manage coupon prizes for the lucky wheel on the Wheel Prizes page.

 

1. Add New: create new wheel prizes

2. Available wheel prizes: customize and manage available wheel prizes. You can edit, quick edit, trash, duplicate a wheel prize on this wheel prize page.

This is a wheel prize page of a coupon in detail.

1. The coupon name or coupon label.

2. Coupon code prefix: add a prefix in front of each coupon to distinguish it from other coupons.

3. Coupon amount: the value of this coupon.

4. Coupon type: The coupon types can be Fixed product discount, Fixed cart discount, Percentage discount.

5. Email restriction: Add received email to coupon’s allowed emails list

6. Allow free shipping: Check this box if the coupon grants free shipping. A free shipping method must be enabled in your shipping zone and be set to require “a valid free shipping coupon” (see the “Free Shipping Requires” setting).

7. Time to live: Coupon will expire after x day(s) since it’s generated and sent.

8. Minimum spend: The minimum spend to use the coupon.

9. Maximum spend: The maximum spend to use the coupon.

10. Individual use only: Check this box if the coupon cannot be used in conjunction with other coupons.

11. Exclude sale items: Check this box if the coupon should not apply to items on sale. Per-item coupons will only work if the item is not on sale. Per-cart coupons will only work if there are items in the cart that are not on sale.

12. Include Products: Products that the coupon will be applied to, or that need to be in the cart in order for the “Fixed cart discount” to be applied

13. Exclude Products: Products that the coupon will not be applied to, or that cannot be in the cart in order for the “Fixed cart discount” to be applied.

14. Include categories: Product categories that the coupon will be applied to, or that need to be in the cart in order for the “Fixed cart discount” to be applied.

15. Exclude categories: Product categories that the coupon will not be applied to, or that cannot be in the cart in order for the “Fixed cart discount” to be applied.

16. Usage limit per coupon: How many times this coupon can be used before it is void.

17. Limit usage to X items: The maximum number of individual items this coupon can apply to when using product discount.

18. Usage limit per user: How many times this coupon can be used by an individual user.

19. Custom winning message: create each custom winning message with the respective coupon.

 

Plugin Author Compatible
WooCommerce Email Template Customizer  VillaTheme Fully
Elementor for shortcode Elementor Fully
WPML OnTheGoSystems Fully
Polylang WP SYNTEX 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.