WooCommerce Lucky Wheel


Created: 08/2018

Latest updated: 08/2022 – Updated version: 1.1.7

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: 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

 

 

Pop-up

  1. Custom popup icon: Select the icon for the popup. The default icon is the small wheel.
  2. Custom popup icon color: Select the color for the popup icon.
  3. Custom popup icon color background color: Select the background color for the popup icon.
  4. Popup icon position: Position of the wheel popup icon on the screen.
  5. Action required to open the popup: When the selected action in this option is done by the user, the popup icon appears.
    • If “Show wheel after users scroll down a specific value” or “Random one of these above” are selected, enter the “Scroll amount(%)” value.
    • If “Show wheel when users move mouse over the top to close the browser” is selected, no initial time is set.
  6. Initial time: How long it takes the popup icon to appear since it’s triggered by the action above. Time is selected randomly in the range you add.
  7. Hide popup icon: Enable this option to hide the popup icon after the user closes the wheel.
  8. If the wheel is closed without a spin, show the popup again after: If the wheel is opened and closed without a spin, make the popup icon show again after this time.
  9. When the spin is done, show the popup again after: Add the amount of time it takes to show the popup icon again after one spin.
    Note: The popup icon maybe available, but the wheel availability is based on the time set in the “Gap between 2 spins” option in the General settings
  10. Show only on Homepage: Show the popup icon on the Home page only.
  11. Show only on Blog page: Show the popup icon on the Blog page only.
  12. Show only on Shop page: Show the popup icon on the Shop page only.
  13. Conditional tags: Make the wheel popup icon show on particular pages. Please read the instruction below the option, or regard this instruction; and the important note as follows.

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

  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 Field

By default, only the field for user’s email address is required and visible, because the prize needs a particular address to be received. But you can enable 2 more fields and get the user’s information. They are fields for user’s name and their phone number.

  1. “Name” field: Enable a field for customers to enter their name before spinning
  2. “Name” field on mobile: Enable the “Name” field for mobile users
  3. “Name” field is required: Make the field mandatory. User must enter their name before spinning
  4. “Phone number” field: Enable a field for customers to enter their phone number before spinning
  5. “Phone number” field on mobile: Enable the “Phone number” field for mobile users
  6. “Phone number” field is required: Make the field mandatory. User must enter their phone number before spinning

 

 

Wheel Settings

In this settings page, you an customize the wheel, as well as edit its content.

  • To view how the wheel would look like on the frontend after finishing your customization, click the green “Preview Wheel” button.
  • To control the wheel segments, add/remove the index by cloning/removing particular segment, and configure the rest (see the second image below).

Wheel customization

  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.

 

Wheel content settings

 

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.

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

 

 

Inform Result

Email notification to user after winning prize

  1. Automatically hide wheel after spinning: Hide the wheel in how many seconds after one spin. Leave 0 to disable this feature
  2. Email subject: Email subject of the email sent to customers when they win a prize.
  3. Email heading: Header of the email sent to customers when they win a prize.
  4. Email content: Build the content of the email the plugin send to customers when they win a prize.
  5. Custom footer text: Add your custom text for the email footer.
  6. Suggested products: Select some products to display as suggested products at the end of the coupon email.
  7. “Shop now” button title: Add your ideal label to the button created by the shortcode in the email content above.
  8. “Shop now” button URL: Add the URL the user is redirected to once they click the “Shop now” button.
  9. “Shop now” button color: Pick a color for the “Shop now” button text.
  10. “Shop now” button background color: Pick a color for the “Shop now” button background.
  11. “Shop now” button font size(px): Select the font size for “Shop now” button label.
  12. 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.
  13. Winning effect: select an effect to display when customers win a prize, there is one effect “firework” now.
  14. Frontend message if lost: configure the frontend message when customers hit the non-prize slide.

 

Admin notification

  1. Admin notification: Enable this option to send email to the admin(s) when an user wins a prize.
  2. Custom admin address: The address of the email sent to the user (above) which included the coupon code.
  3. Admin Email subject: Email subject of the notification to the admin.
  4. Admin Email heading: Email header of the notification to the admin.
  5. Admin Email content: Build your email content of the notification to the admin.

 

Wheel message after the user finishes a spin

  1. Winning message if prize is WooCommerce coupon: Show the content built in this box when the user wins a WooCommerce coupon.
  2. Winning message if prize is custom type: Show this message in this box when the user wins a custom prize.
  3. “Apply Coupon” button: Enable this option to show the “Apply Coupon” button
  4. “Apply Coupon” button redirect: Add the URL the user will be redirected to once they click “Apply Coupon”
  5. “Apply Coupon” button text color: Color of the text “Apply Coupon”
  6. “Apply Coupon” button background color: Background color of the button.
  7. “Apply Coupon” button font size: Size of the text “Apply Coupon”
  8. “Apply Coupon” button rounded corner: Round the 4 corners of the button.
  9. Winning effect: Select one winning effect when the user wins a prize.
  10. Frontend message if lost: Show this message when the user does not win.

 

 

Unique Coupon

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

  1. Email restriction: Add the received email to the allowed email list of the coupon.
  2. Allow free shipping: Enable this option so the coupon grants free shipping method.
  3. Time to live: Coupon available duration.
  4. Minimum spend: The user’s subtotal must reach this minimum amount to use the coupon.
  5. Maximum spend: The user’s subtotal must be lower or equal to this value to use the coupon.
  6. Individual use only: Enable this option if the coupon can not be used in conjunction with other coupons.
  7. Exclude sale items: Enable this option to make the coupon not apply to sale items.
  8. Include Products: Products that the coupon will be applied to, or need to be in the cart for the “Fixed cart discount” to be applied.
  9. 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.
  10. 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.
  11. 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.
  12. Usage limit per coupon: How many times this coupon can be used before it is void.
  13. Limit usage to X items: The maximum number of individual items this coupon can apply to when using product discount.
  14. Usage limit per user: How many times this coupon can be used by an individual user.
  15. Coupon code prefix: Add your custom prefix to the coupon.

 

 

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

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

 

 

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.