Lottery for WooCommerce

Lottery for WooCommerce is a full-featured lottery plugin for creating and managing online lotteries in your WooCommerce Shop.

1. Download the lottery-for-woocommerce.zip file from your WooCommerce account.
2. Go to: WordPress Admin > Plugins > Add New and Upload Plugin with the file you downloaded with Choose File.
3. Install Now and Activate the extension.

More information at: Install and Activate Plugins/Extensions.

PHP max input variables: 10000 or higher

PHP post max size: 300M or higher

PHP memory limit: 2GB or higher

PHP time limit: 600 or higher

In this type of lottery, the ticket number will be automatically generated once the user participates in the lottery. The ticket details will be mailed to the user.

In this type of lottery, site admin can allow their users to choose their own ticket numbers for participating in the lottery. The ticket details will be mailed to the user.

• In this type, you can choose one or more products sold on your site as the Lottery Winning Item.
• Once the winner is decided(Automatically/Manually), an order will be created on behalf of the winner with the winning item for free of cost.
• The product can be shipped to the winner in case if the product is a physical product. If the product is a downloadable product, the winner will gain access to files.
• The Lottery Winning Item can be accessed from the My Account Page > Orders similar to any other order.

• You can choose this type if your Lottery Winning Item is not sold on your site.
• You may have to create a page which explains what the winners will receive if they participate in the lottery and link that page’s URL in the URL option provided.
• Once the winner(s) are decided, you will have to manage the process of sending the winning items to the winners outside the site.

Lottery for WooCommerce Requires Server Cron in order for the plugin to work. To setup Server cron do the following steps.
1. Login to the cPanel of your site
2. Locate “Cron Jobs” within the cPanel
3. Under the “Add New Cron Job” section, fill the following data

a. Common Settings

In this section, you can set up how frequently the Cron should run. For Example, if the value is set as “Once Per Minute”, then the cron will run once every minute. Once the cron is triggered, the following activities will be updated.

• Starting Future Lotteries
• Ending Closed Lotteries
• Automatic Relist for finished and failed lottery

b. Update Cron Command

Starting Future Lotteries and Ending Closed Lotteries

wget -q -O – http://www.your-domain.com/?lty_lottery_cron=update

Automatic Relist for finished and failed lottery

wget -q -O – http://www.your-domain.com/?lty_lottery_cron=relist

General

General Settings

• Once the plugin is installed, a page for displaying the lottery products will be automatically created and assigned. If you want to modify the page in which the lottery products are displayed, you can do so by selecting a different page in the “Lottery Page” option.
• The lottery products created will be displayed in the lottery page. The order in which the lottery products should be displayed can be customized in the “Default Sorting in Lottery Page”.
• A separate page to list the On-going, Closed, Finished and Failed lottery products will be available to the user. Your users can view additional details regarding the lottery product from this page. To display this information on a different page, you can do so by customizing the “Lottery Entry List Page” option.
• If you want to differentiate normal products from Lottery products, you can do so by adding a badge to the product image. To configure a badge, enable the “Enable lottery Badge” option.
• By default, an image will be selected. If you want to change the badge icon, you can do so by choosing a new image.
• By default when guest users try to participate in the lottery, they will be forced to login on the checkout page. Optionally you can completely prevent guest user participation/allow guest user participation by customizing the “Guest User Participation Type” option.
• By Default, the Lottery will reach “Completed” status when their payment order reaches “Processing or Completed”. If you want to customize the order status, you can do so by modifying the “Order Status” option.
• By default on the thank you page, the lottery ticket numbers will be displayed immediately after the order is placed. If you wish to ticket numbers only after payment confirmation, you can do so by customizing the “Display Ticket Number(s) in Thank You Page & Order Details Page” option.
• By default, all lottery products will be closed only when the end date has reached. If you want to close the lottery products once all the tickets have been sold, you can do so by enabling the “Close Lottery when All the Tickets have been Sold”.

Reserve Ticket Number Settings

• In “Users are allowed to choose the Ticket Number” mode, if you wish to hold the ticket number for a specified time period, you can do so by enabling the “Reserve Ticket Number Till Purchase Completion” option.
• You can customize the duration in the “Ticket Reserve Duration in Minutes” option.

Question Answer

Q&A Settings

• If you want to ask a Question to your users before purchasing a ticket, you can do so by enabling the “Ask a Question before Purchasing Tickets”.
• By default, the user will not be forced to answer the Question to purchase a ticket. If you want to force your users to answer the question, you can do so by enabling the “Force Users to Answer the Question”.
• By default, there is no time limit for answering the question. If you wish to place a time limit for answering the question, you can do so by selecting “Limited” in the Q/A Limit Type option. You can set the time limit in the “Set Time Limit” option.
• If you wish to prevent ticket generation for choosing incorrect answer , you can do so by enabling the “Don’t Generate Ticket Numbers for Incorrectly Answered Question” option.
• By default, the user will be allowed to purchase a ticket once they select an answer. The answer will not be verified. If you want to allow your users to purchase tickets only when a correct answer is selected, enable the “Verify Answer Purchasing Lottery”.
• By default, if your users answer incorrectly for 1 time, they will not be allowed to participate in that lottery. You can customize the limit to any value you want or you can set it to unlimited.
• In the “Your Question” option, input the question which you want to ask your users. You can display all the answer options at once or display the options in a dropdown by customizing the “Options Display Type” option.
• To add answer options, click the “Add Answer Options” button. You can mark the correct answer by selecting the “Correct Answer” checkbox next to the answer. You can add any number of options.

Ticket Generation

Automatic Random Ticket Generation Settings

• You can configure the ticket attributes like Ticket Number Type, Ticket Length, Ticket Prefix and Ticket suffix.
• Please note this options not applicable for User selection lottery tickets Numbers type.

Shop, Category and Other Pages

General Display Settings

• By default, Lottery products will be visible in shop page. If you want to hide the Lottery Products on the shop page, you can do so by enabling “Hide Lottery Products on Shop Page”.
• By default, Lottery products will be visible in category page. If you want to hide the lottery products on the category page, you can do so by enabling “Hide Lottery Products on Category Page”.
• By default, lottery products will be visible in Tag page. If you want to hide the lottery products from the tag page, you can do so by enabling “Hide Lottery Products on Tag Page”.
• By default, Finished Lottery products will be visible in shop & category pages. If you want to hide the Finished Lottery products from the shop and category pages, you can do so by enabling “Hide Finished Lottery Products on Shop & Category pages”.
• By default, Failed Lottery products will be visible in shop & category pages. If you want to hide the Failed Lottery products from the shop and category pages, you can do so by enabling “Hide Failed Lottery Products on Shop & Category pages”.
• By default, Closed Lottery products will be visible in shop & category pages. If you want to hide the Closed Lottery products from the shop and category pages, you can do so by enabling “Hide Closed Lottery Products on Shop & Category pages”.

Lottery Products Display Settings

• If you want to display a progress bar on the shop and category pages, you can do so by enabling “Display Progress Bar in the Shop and Category Page(s)”.
• By default, the Remaining Ticket Info will be visible in the Progress Bar. If you want to hide the Remaining Ticket Info in the Progress Bar, you can do so by enabling the “Hide Remaining Ticket Info message in the Progress bar”.
• By default, the Lottery Start Date will be visible on the shop page. If you want to hide the Countdown Timer, you can do so by enabling “Hide Lottery Start Date on Shop Page”.
• By default, the Lottery End Date will be visible on the shop page. If you want to hide the Countdown Timer, you can do so by enabling “Hide Lottery End Date on Shop Page”.
• By default, the Countdown timer for the Lottery will be displayed. If you want to hide the countdown timer, enable the “Hide Countdown timer for the Lottery Products in Shop and Category Pages” option.
• If you wish to hide the Lottery Status on shop and category pages, you can do so by enabling the “Hide Lottery Status on Shop and Category Pages” option.

Single Product Page

General Settings

• To add multiple quantities of the ticket to the cart, the default quantity field will be available. If you wish to provide a range slider for choosing the quantity, you can do so by customizing the “Quantity Selector Type” option.
• If you want to disable the “Participate Now” till the user answers the question and selects the ticket number, enable the “Disable Participate Now button when Question Answer and Ticket Number not Selected” option.
• If you wish to redirect your users to the checkout page by clicking the Participate Now button, you can do so by enabling the “Enable Participate Now button Redirection to Checkout Page” option.
• If you wish to display the ticket search bar on the product page, you can do so by enabling the “Enable Ticket Search Bar” option.
• If you wish to hide Instant Win Prizes tab on the product page, you can do so by enabling the “Hide Instant Win Prizes Tab” option.

Display Settings

• By default, Lottery status will be visible on the single product page. If you want to hide the Lottery status, you can do so by enabling “Hide Lottery Status on Single Product Page”.
• By default, the Lottery start date will be visible on the single product page. If you want to hide the countdown timer, you can do so by enabling “Hide Lottery Start Date on Single Product Page”.
• By default, the Lottery End Date will be visible on the single product page. If you want to hide the countdown timer, you can do so by enabling “Hide Lottery End Date on Single Product Page”.
• By default, countdown timer will be visible in the single product pages. If you want to hide the countdown timer, you can do so by enabling “Hide Countdown Timer for Single Product Pages”.
• By default, timezone info will be visible in the single product page. If you want to hide the timezone info, you can do so by enabling “Hide Timezone info in the Single Product Page”.
• By default, Minimum Ticket Info will be visible on the single product page. If you want to hide the Minimum Ticket Info, you can do so by enabling “Hide Minimum Ticket info in the Single Product Page”.
• By default, Maximum Ticket Info will be visible on the single product page. If you want to hide the Maximum Ticket Info, you can do so by enabling “Hide Maximum Ticket info in the Single Product Page”.
• By default, Minimum Tickets per user info will be visible on the single product page. If you want to hide the Minimum Tickets per user info, you can do so by enabling “Hide Minimum Tickets per user info in the Single Product Page”.
• By default, Maximum Tickets per user info will be visible on the single product page. If you want to hide the Maximum Tickets per user info, you can do so by enabling “Hide Maximum Tickets per user info in the Single Product Page”.
• If you want to display a progress bar on the single product page, you can do so by enabling “Display Progress Bar”.
• By default, the Winner Message will be visible on the single product page. If you want to hide the Winner Message, you can do so by enabling “Hide Winner Message on Single Product Page”.
• By default, the Lottery Tickets Sold count will be visible on the single product page. If you want to hide the Lottery Tickets Sold count, you can do so by enabling “Hide Lottery Tickets Sold on Single Product Page”.
• By default, the bidder name will be masked and displayed. If you want to display the name of the bidder, disable the “Mask the user name in Ticket Logs tab on the Single product page” option.

Alert Settings

If you wish to hide the confirmation alert when the user answers a question correctly, you can do so by enabling the “Hide Confirmation Alert when Selected the Answer for the Question(To make sure the selected Answer)” option.

Lottery Ticket Details

Lottery Ticket Details on the Single Product Page

You can customize how the purchased lottery tickets are displayed on the single product page in this section.

Dashboard Settings

You can customize the number entries of page displayed in the lottery dashboard in this section.

Winner Details
You can customize how the winner details are presented on the product page in the section.

PDF Settings

PDF

PDF for Entry List

• You can enable PDF for Entry List to download using Enable PDF Download for Entry List option.
• You can set Logo Image on the header of Entry List PDF by Upload Site logo in Entry List PDF header option.
• Customize Width & Height(In pixels) for Logo Image on Entry List PDF.
• Customizable Entry List PDF file name using Entry List PDF File Name option.

PDF for Tickets

• You can enable PDF for lottery ticket number using Enable PDF Download for Ticket numbers on Thank you page & Order details page.
• Customizable PDF lottery ticket number file name using Lottery Ticket(s) PDF File Name option.

Lottery Ticket(s) PDF Color Customization Settings

• Customizable option for lottery ticket PDF background color -1 using Background Color – 1 option
• Customizable option for lottery ticket PDF background color -2 using Background Color – 2 option

You can set color ratio in degree between Background Color – 1 & Background Color – 2 of lottery ticket PDF using Color Ratio in Degree option.

Entry List PDF Color Customization Settings

Here you can customize the color for the Entry List PDF

• PDF Header Background Color
• PDF Header Font Color
• Table Header Background Color
• Table Header Font Color
• Table Border Color
• PDF Footer Background Color
• PDF Footer Font Color

Advanced

General

IP Address Restriction  Settings

By default, multiple users from the same IP Address can participate in a lottery. If you want to prevent multiple users from the same IP from participating in the lottery, you can do by enabling the “Restrict User to Purchase Lottery Ticket based on IP address” option.

Export CSV File Settings

You can customize the file name of the Export CSV file in the “Export CSV File Name” option.

Cron

Cron Settings

There are 2 types of Crons

1. WP Cron

WP Cron is supported in all WordPress sites by default(Unless turned off manually in the wp-config file). The main disadvantage of WP Cron is that it will trigger only when someone visits the site. For example, If there is no site activity for some time say 10 days, the cron will not be triggered on those 10 days.

2. Server Cron

Server Cron is an alternate to WP Cron. The main advantage of Server Cron is that it is not dependent on site activity. But, Server Cron requires separate configuration. As far as we know, it cannot be configured using a Plugin within the site. It can only be configured from the site’s C-Panel or control panel.
If you want to use WP Cron, then in “Select Cron Type” select “WP Cron”. If you want to run Server cron, select “Server Cron”. Please follow the steps mentioned in the “Server Cron Configuration” section.

Color Customization

You can customize the color of the lottery elements in single product page, shop, category and tag pages.

Shortcodes

In this section, you can find the supported shortcodes along with their purpose.

Notifications

In this section, you can find the supported email notifications. Notifications can be turned On/Off as per preference.

Localization

In this section, the labels displayed for the Lottery products can be customized.

Messages

In this section, the messages displayed while interacting with Lottery products can be customized.

• Once the initial configuration is completed, a Lottery product has to be created.
• To create a new product go to WordPress Dashboard > Products > Add New
• In the Product Type selection, select “Lottery”

Lottery

• Fill in the following details in the section,
  • Start Date
  • End Date
  • Minimum Tickets
  • Maximum Tickets
  • Minimum Tickets Per Order
  • Maximum Tickets Per Order
  • Number of Winner
  • Ticket Price Type
  • Regular Price
• By default, the ticket number will be automatically generated.

Automatic Ticket Type

• If you choose to generate tickets automatically, the ticket numbers can be generated in the following patterns,

i. Random – Ticket numbers will be generated randomly.
ii. Sequential – Ticket numbers will be generated in sequential order. The Starting Number, Prefix and Suffix can be customized.
iii. Shuffled – Ticket numbers will be shuffled and assigned to the user. The Starting Number, Prefix and Suffix can be customized.

User Chooses Ticket Type

If you want the user to choose the ticket number(s), You can select the Allow Users to Choose Ticket Numbers option in the Ticket Generation Type dropdown.

i. Sequential – Ticket numbers will be generated & display in a sequential order. The Starting Number, Prefix and Suffix can be customized.

ii. Shuffled – Ticket numbers will be generated & display in a shuffled order. The Starting Number, Prefix and Suffix can be customized.

iii. Use Alphabet Ticket Numbers:

• Enable to display ticket number with Alphabet, Example: (A1, A2, B1, B2,………E1, E2).
• An option to display Alphabet with Sequence number, Example: (A1, A2, B3, B4,………E10, E11).

iv. Number of Tickets per Tab:
Set the value to display the number of ticket numbers per tab.

v. Display View More Tickets in each Tab

• If you have more tickets in a tab, You can split and display the tickets in multiple tabs by enabling the View More Tickets in per Tab option.
• Set value in Set Number of tickets in View More field to split and display the ticket numbers.

vi. Enable Lucky Dip

• When enabled, users can allow the Lottery System to randomly pick a ticket number for them by clicking a Lucky Dip button and selecting the ticket quantity.

Lucky Dip Method

Display & Add the Tickets to the Cart Directly:

When selected, the ticket number will be displayed & added to the cart automatically.

Only Display the Tickets:

When selected, the ticket number will only be displayed and will not be added to the cart. User can re-generate the ticket number. Finally, once the user finalizes the ticket number, they can add the finalized ticket number(s) to the cart.

vii. Hide Sold Tickets per Tab

When enabled, the sold tickets in each tab will be hidden.

• By default, the winner of the lottery will be automatically decided. If you want to manually pick the winner for the lottery, you can do so by customizing the “Winner Selection Method” option.
• Configure the Winning Item Selection Method as per your preference.
• By default, Countdown Timer visibility will be decided based on Global Level settings. If you wish to override the settings for the product, you can do so by setting Product Level in the “Hide Countdown Timer Level Selection Type” option.
• By default, Progress Bar visibility will be decided based on Global Level settings. If you wish to override the settings for the product, you can do so by setting Product Level in the “Hide Progress Bar Selection Type” option.

Q&A

By default, When Q&A is enabled and configured, it will apply to all the lottery products. If you want to customize the Q & A for a particular Product, then locate the “Q&A” section.

• In Question Answer Level Selection Type select “Product Level”.
• Enable the “Ask a Question before Purchasing Tickets” checkbox.
• If you want to force your users to answer the question before participating, enable the “Force Users to Answer the Question” checkbox.
• Enter your question in the “Your Question” field.
• You can provide any number of options you want to your users. To add an option, click the “Add Answer Options” button.
• To set the correct answer, enable the “Correct Answer” checkbox next to the option.

Predefined Buttons

To optionally offer multiple tickets for a single price, the Predefined Buttons can be used.

• Enable the Enable Predefined Buttons checkbox.
• Enable Display Quantity Selector(Allow user to update quantity or use Predefined Button).
• Display discount tag for predefined buttons by enabling Display Discount Tag for Predefined Buttons checkbox.
• In Select Discount Type select the discount type(Percentage Or Fixed) of discount you wish to offer.
• In the Ticket Quantity, input the number of tickets which has to be purchased by the user. In the Discount field, input the discount value.
• You can create any number of buttons for a single product.

Automatic Relisting

Finished Lottery Relisting

• If you wish to relist lottery when it is successfully finished, you can do so by enabling the “Enable Finished Lottery Relisting” option
• You can set the validity of the relisted lottery in the Set Relist Duration option.
• If you wish to relist the lottery after a pause, you can do so by enabling the “Enable Pause Time to Relist” option.
• You can set the validity of the pause duration in the Set Pause Time to Relist option.
• If you wish to relist the lottery for an indefinite period, you can do so by setting the value as Limited in the Finished Relitst Type option.

Failed Lottery  Relisting

• If you wish to relist a lottery when it has failed, you can do so by enabling the “Enable Relist for Failed Lottery” option.
• You can set the validity of the relisted lottery in the Set Relist Duration option.
• If you wish to relist the lottery after a pause, you can do so by enabling the “Enable Pause Time to Relist” option.
• You can set the validity of the pause duration in the Set Pause Time to Relist option.
• If you wish to relist the lottery for an indefinite period, you can do so by setting the value as Limited in the Finished Relitst Type option.

Instant Win Prizes

• To offer Instant Win Prizes to your users for purchasing lottery tickets.

• Instant Win Prize is applicable only for “Automatic Ticket Generation” type & “User Chooses Ticket” type..
• Enable the Instant Win Prize checkbox.
• Enable Display Image for Instant Win Prize. If the option is enabled, you can set image for each instant win prize on rule settings.
• If you wish to display an image for Instant Win Prizes, enable the Display Image for Instant Win Prize checkbox. If the option is enabled, you can set image for each instant win prize on rule settings.
• By default Instant Win Prize Display Mode will be set in Default option(Table format).
• Click on the Add New Rule button to view the Instant Win Prize rule settings.
• Enable Display Image for Instant Win Prize. If the option is enabled, you can set image for each instant win prize on rule settings.
• Fill in the eligible ticket numbers one number per row and the information on the gift the user will be receiving.
• You can also export the instant win settings data as csv file and able import to the data to another lottery product instant win settings.

Physical

If you select Physical option in Prize Type dropdown, you can give the prize to the instant winner manually. Enter the prize details in Prize text field.

Coupon

If you wish to offer a WooCommerce Coupon as an Instant Win Prize, select Coupon option in Prize Type dropdown.

• Select the Coupon Type dropdown option to create New Coupon or Existing Coupon.
• Before selecting the New coupon option, please configure the Instant Winner Coupon Creation Settings. Go to Lottery -> Settings -> General -> Instant Win -> Instant Winner Coupon Creation Settings
• Select New Coupon option on Coupon Type dropdown in Instant Win Prizes rule. settings after configured Instant Winner Coupon Creation Settings
• Select Percentage or Fixed type in Coupon Discount Type.
• Enter the Coupon Discount Value.
• Enter the prize details in Prize text field.

Wallet

This plugin is compatible with Wallet for WooCommerce. You can offer a store credit as an Instant Win Prize.

• Select Wallet option in Prize Type dropdown.
• Enter the site credit value in wallet credit value field.
• Enter the prize details in Prize text field.

Note

This option will be visible only when the Wallet for WooCommerce plugin is installed and it is active.

Store Credit(Store Credit for WooCommerce ) for Instant Win Prize

This plugin is compatible with Store Credit(Store Credit for WooCommerce). You can offer a store credit as an Instant Win Prize.

If you select Store Credit option in PrizeType dropdown

• Enter the site credit value in store credit value field.
• Enter the prize details in Prize text field.

Store Credit(Smart Coupon ) for Instant Win Prize

This plugin is compatible with Store Credit(Smart Coupon). You can offer a store credit as an Instant Win Prize.

If you select Store Credit(Smart Coupon) option in PrizeType dropdown

• Enter the site credit value in store credit value field.
• Enter the prize details in Prize text field.

Note

This option will be visible only when the Store Credit for WooCommerce plugin is installed and it is active.

Instant Win Prize Group Settings

If you select Display Prizes by Group option in Instant Win Prize Display Mode dropdown on Instant Win Prizes settings tab, you can see Instant Win Prize Groups settings tab.

You can create Instant Win Prize Group to add more ticket numbers in single prize Group.

• If click Add New Prize group button you can see the instant win prize group settings
• Enter the group title in Group Title field .
• Upload prize group image.
• Select the prize type you want to award the instant winner in Prize Type field.
• If you select Physical option in Prize Type dropdown, you can give the prize to the instant winner manually.
• Enter the prize details in Group Prize Message text field.
• If you select Coupon option in PrizeType dropdown
• Select the Coupon Generation Type dropdown option to create New Coupon or Existing Coupon.
• Before selecting the New coupon option, please configure the Instant Winner Coupon Creation Settings. Go to Lottery -> Settings -> General -> Instant Win -> Instant Winner Coupon Creation Settings.
• Select New Coupon option on Coupon Type dropdown in Instant Win Prizes rule settings after configured Instant Winner Coupon Creation Settings.
• Select Percentage or Fixed type in Coupon Discounnt Type.
• Enter the Coupon Discount Value.
• Enter the prize details in Group Prize Message text field.

Instant Win Prize Settings for Prize Group

• Assign the ticket numbers to created prize group on Instant Win Prize tab by clicking the Add New Rule button.
• Enter the ticket number in Ticket Number field.
• You can see the created prize group list on Group Prize dropdown.
• Select one created prize group in Group Prize dropdown.
• You can also export the instant win settings data as csv file and able import to the data to another lottery product or update instant win settings.

Tera Wallet(Wallet for WooCommerce)

This plugin is compatible with Tera Wallet(Wallet for WooCommerce). You can offer a store credit as an Instant Win Prize.

• Select Woo-Wallet option in Prize Type dropdown.
• Enter the site credit value in wallet credit value field.
• Enter the prize details in Prize text field.

Note

This option will be visible only when the Tera Wallet(Wallet for WooCommerce) plugin is installed and it is active.

• A user lands on the single product page. The user selects the number of tickets they wish to purchase and adds the product to the cart.
• The users can also manually select the ticket number(s)/Allow the system to select a ticket for them(Based on Configuration).
• Once the purchase is completed and the payment has been received, the users will receive the ticket number(s).
• Once the Lottery end date has been reached, the winner will be automatically picked by the system and they will be notified via email.
• If the winning item is configured “Products Inside the Site”, then the product associated with the lottery will be added to the user’s account in a separate order for free of cost.

• A user lands on the single product page. The user selects the number of tickets they wish to purchase and adds the product to the cart.
• The users can also manually select the ticket number(s)/Allow the system to select a ticket for them(Based on Configuration).
• Once the purchase is completed and the payment has been received, the users will receive the ticket number(s).
• Once the Lottery end date has been reached, the admin will be notified via email. The site admin will have to manually pick the winner(s).
• If the winning item is configured “Products Inside the Site”, then the product associated with the lottery will be added to the user’s account in a separate order for free of cost.

• To access the admin dashboard go to WordPress Dashboard > Lottery > Lottery
• From this dashboard, the site admin can view the following data
  1. Status of the Lottery
  2. Minimum and Maximum Tickets for a Lottery
  3. Number of Tickets sold in a Lottery
  4. Number of Participants in a Lottery
  5. Lottery Winning Type and Number of winners in a Lottery
  6. Admin can manage and see more details in each Lottery
  7. Admin can export the Lottery Details as a CSV File.

To display the customer dashboard, place the shortcode “ [lty_dashboard]”. Your customer can access the following details from the customer dashboard,

1. List of Participated Lotteries
2. List of Won Lotteries
3. List of Lost Lotteries

To configure the wallet widgets go to WordPress Dashboard > Appearance > Widgets. The following widgets are available,

Displays the Lottery products. The following filters are available

• Future Lottery
• Running Lottery
• My Lottery

Displays the Lottery product Search Widget.

Lottery for WooCommerce is translation ready, meaning you can edit the po files by which you can translate the text to any language. Steps to perform the translation are as follows. For example, a translation to French.

• Download and install Poedit
• Open the file lottery-for-woocommerce > languages > lottery-for-woocommerce.pot using Poedit.
• Create a new translation file by clicking Create new translation button.
• Choose the Source text and set its corresponding French text in Translation Text Area.
• Save the changes.
• Save the file name as lottery-for-woocommerce-fr_FR.po.
• If you are using WordPress Version 3.9.13 or below, then in wp-config.php define the WPLANG as French. Syntax is define(‘WPLANG’, ‘fr_FR’);
• If you are using WordPress Version 4.0 or above, then go to WordPress dashboard > Settings > General and select the Site Language as French.

Q: Can we allow guest users to purchase the lottery tickets?

Yes, you can allow guest users to purchase the lottery tickets.

Q: How can i pick the manual Winners for closed lottery?

You can see Select Winner option in lottery post table for closed lottery. Please refer the below steps and screenshot to select the manual winners for closed lottery,Lottery -> Lottery -> Lottery product -> View Details

Q: Does the plugin has Instant Win Prizes option?

(i) Yes, it is available.

(ii) Instant Win Prizes work for both Automatic Ticket Generation type & User Chooses Ticket Type.

(iii) Instant Win Prizes settings available in Lottery product settings(Edit product page).

Note: Instant Win Prizes work only for display purposes and admin should award the Prizes and credit it to the winners manually.

Q: I’m not able to add more than 100 Instant Win Prizes on the Instant Win Prizes settings, it is taking too long to load. How can i fix this issue?

(i) We hope this issue occurs because of “PHP max input variables” and “PHP post max size” limit is not enough to store more data on your site. That is the reason for Instant Win loading issue when creating more rules.

(ii) We suggest you please check by increasing the “PHP max input variables” to 4000 or higher and “PHP post max size” to 100M or higher.

(iii) Also, please make sure your PHP memory limit is minimum 512M to use our lottery plugin.Please refer the below steps to see the current limits on your site WordPress Dashboard -> Tools -> Site Health -> Info -> Server

Q: Is the Email option available for Instant Win Prizes? 

(i) Yes, the email option is available for Instant Win Prizes.

(ii) Admin can enable Instant Win Prizes email for both admin and customers(who win the Instant Win Prize).

Q: We don’t want to allow the user to the competition who incorrectly answered the question. It is possible?

Yes, it is possible.

(i) Verify Answer Before Purchasing Lottery

– Using the Verify Answer Before Purchasing Lottery option, you can set an attempt limit for the user to answer the question.

– If the user selects the wrong answer and the attempt limit is exceeded then that user cannot be allowed to participate in the particular lottery.

(ii) Don’t Generate Ticket Number for Incorrectly Answered Question

We have another option(Don’t Generate Ticket Numbers for Incorrectly Answered Question) which allows the user to purchase lottery even if they select the incorrect answer. In this method, the ticket number will not be generated and an email will be sent to the user to inform them about the wrong answer selection.

Q: Is Lucky Dip option is available in User Chooses the Ticket Type?

Yes, it is available.

Q: Is there a way to run a contest without a start and end date but show a progress bar of how many tickets are left until the contest is ended?

1. Currently, it is not possible to run a lottery without assigning a Start and End date. Instead, you can set the end date to a longer duration and hide the countdown timer on the shop page and single product page.

(i) Lottery -> Settings -> General -> Shop page -> Hide Countdown Timer for Lottery Products on Shop and Category Pages.

(ii) Lottery -> Settings -> General -> Single Product Page -> Hide Countdown Timer for Single Product Page.

2. Also, the option is available to close the lottery when all the tickets have been sold.Lottery -> Settings -> General -> Close Lottery when All the Tickets have been sold.

Q: Is there any option available to set a preset value for the default quantity display in the Range slider for the quantity Selector?

Yes, an option is available to set a preset value(default quantity) in the Range slider for quantity Selector.

Settings

(i) Lottery -> Settings -> General -> Single product Page -> Quantity Selector Type -> Range Slider.

(ii) Lottery product Settings(Edit product page) -> Display Range Slider Based On -> Preset Tickets -> Set Preset TicketsmNote:Range slider for quantity Selector works only for Automatic Ticket Generation Type.

Q: How to select the winner when using Manually Pick Winners option?

i) If the admin selects the Winner Selection Method as Manual and the lottery time has ended after reaching the Minimum tickets value, then the lottery is moved to closed status. The Users will have to wait for the admin to manually pick the winner(s).

ii) Admin can Pick the winners manually in Lottery Post table Lottery -> Lottery -> Lottery product -> View Details

Q: How to Customize the “Lottery” word in Frontend?

(i) You can customize the messages and frontend display using Localization and Messages settings Lottery -> Settings -> Localization Lottery -> Settings -> Messages

(ii) Also, you can customize some messages and frontend display using Po file translation. For more information about Po file translation please refer to the “Translation” section on Lottery Documentation(https://woocommerce.com/document/lottery/).

Q: It is possible to set the ticket number as 00001 to 99999 in Automatic Ticket Generation type?

1. Yes, it is possible. If you set 5 in ticket length(Only number type) in Random type and set the maximum ticket as 99999, then it will generate the ticket numbers 00001 to 99999.Lottery -> Settings -> General -> Ticket Generation -> Automatic Random Ticket Generation Settings -> Ticket Length -> Set 5

2. Also, you can achieve this scenario using Shuffled or Sequential ticket type. If you set the Ticket Starting Number as 00001 and set the maximum ticket as 99999, then it will generate the ticket number 00001 to 99999.Shuffled and Sequential options are available in the lottery product settings(edit product page).

Q: Is Alphabet ticket number series(Example: A1, A2, B1, B2,………E1, E2) available in User Chooses the Ticket Type?

Yes, it is available.

Q: Can we give bulk tickets(based on ticket quantities) for a certain amount?

(i) Yes, it is possible.

(ii) We have a Predefined Buttons option to apply Fixed price or Percentage discounts based on lottery ticket quantities.

(iii) You can see the settings in Lottery product settings(Edit product page).

Q: Can Admin create the order for the user(Manual order) for lottery products?

– Yes, it is possible.
– Admin can create the manual order for both ticket generation type
(i) Automatic Ticket Generation Type
(ii) User Chooses the Ticket Type

Q: How to configure Cron for Lottery?

Lottery for WooCommerce Requires Server Cron or WP Cron in order for the plugin to work.

1. Server Cron

(i) Please follow the below steps to configure the server cron,

1. Login to the cPanel of your site.
2. Locate “Cron Jobs” within the cPanel
3. Under the “Add New Cron Job” section, fill in the following data,

a. Common Settings

In this section, you can set up how frequently the Cron should run. For Example, if the value is set as “Once Per Minute”, then the cron will run once every minute. Once the cron is triggered, the following activities will be updated,

– Starting Future Lotteries
– Ending Closed Lotteries

b. Lottery Plugin Server Cron Settings

Also, please select the Server Cron option in Lottery plugin Settings,

Lottery -> Settings -> Advanced -> Cron -> Cron Type -> Server Cron.

c. Update Cron Command

Please check by updating the server cron using below URL format,

Update Cron Command URL Format

Your site URL(http://www.your-domain.com/) with Update command(?lty_lottery_cron=update)

For Examplehttp://www.your-domain.com/?lty_lottery_cron=update

2. WP Cron

Lottery -> Settings -> Advanced -> Cron -> Cron Type -> WP Cron

– Set time for Cron Trigger Frequency
– Save the settings

For more information about WP Cron please refer to the documentation(https://woocommerce.com/document/lottery/)

Also, please follow the below steps to know about the last update of cron information in our plugin.

Lottery -> Settings -> Advanced -> Cron Information

Q: Can we re-use the old lottery products?

Yes, we have a Relist option to reset the previous lottery data and you can start the old lottery as a new lottery.

Q: Why is my lottery failing and how can I start the lottery again with the same purchase data?

Lottery products fail only if the end time has been reached without reaching the Minimum ticket value.We have the Extend option which is available in Lottery Product Settings(Edit product page). Using the extend option you can extend the lottery without losing the purchased ticket data. Extend option will be displayed only for the failed lottery.

Q: Can we Export the lottery tickets?

Yes, we have the Export CSV option which is available in the lottery post table.

Have a question before you buy? Please fill out this pre-sales form.

Already purchased and need some assistance? Get in touch with us via the Help Desk.