More Info

New product type lottery:

Lottery edit product screenshot (with Pick Number Mod addon for WooCommerce Lottery):

Settings are mostly self explainable, please see screenshot below. You can enable or disable showing past and future lotteries, another useful setting is whether to mix regular products with lotteries or just show lotteries on separate page (defined via WC Lottery Base Page dropdown option, see screenshot).

Screenshot above includes available settings for Pick Number Mod addon for WooCommerce Lottery (options listed under title “Lottery pick number and answer” are related to Pick Number Mod addon).

On screenshot below you can see how product list with lotteries looks like. Lottery status icon colors: red – active lottery, orange – finished, red – failed. Column “product type” (with icons) on the products admin screen in WooCommerce was removed in version 3.4.0 and in order to see icons you need to install WooCommerce Product Type Column plugin. See FAQ item no 30.

If lottery has failed, in product / lottery details you will see option to “Refund” or buttons to “Relist” or “Extend” lottery. “Refund” enables you to refund all tickets to participants if your lottery rules require that and your payment gateway supports refunds. “Extend” allows extension of end date keeping all current participants (and their orders) while “Relist” resets lottery and it starts with 0 participants. Only failed lotteries can be extended (or refunded) while all finished lotteries can be relisted. See FAQ item no 32.

Once lottery is finished you can view winners on single lottery page or in wp-admin edit product page. Below are screenshots.Beside that you can create my lotteries page for users where you can use this shortcode: show user’s lotteries (active lotteries in which user participates and list of user’s won lotteries) –

In lottery details block with lottery history entries enables you to view and delete ticket orders, export them to CSV or Excel and view history prior relisting. Check screenshot below. Failed lotteries can be relisted (restarted – meaning participants will be lost) or extended (end date will be changed) keeping all current participants.

How does Lottery plugin pick winners (or winning numbers if you use Pick Number addon)?

Winner(s) is / are picked randomly once lottery is finished or you can manually enter winning numbers in case you have Pick Number Mod addon. Plugin uses mt_rand PHP function to randomly pick winners. PHP function mt_rand() which provides solid randomization for this purpose.

If you use WooCommerce Lottery (also with Pick Number Mod addon) and for example you have setup lottery with max 100 tickets and min 50 tickets, then if you sell 55 tickets winner(s) will be choosen between those 55 tickets not all 100 tickets.

With Pick Number Mod addon you can get also different behaviour with enabled checkbox option called “Manual winner picking”, meaning that when lottery ends and after you generate randomly winning numbers (or use national lottery numbers or random.org) you will enter numbers in text input field. It is then possible that your lottery could end without winners (if none of participants picked right number(s)).

With Pick Number Mod and question / answers feature enabled winners will be choosen among those with correct answer only. In case you are manually entering winning numbers you will need to be sure that winning number has correct answer – this can be seen in lottery history table block (which you can export to Excel or CSV for easier management).

Here is a list of all available plugin shortcodes. Some shortcodes accept optional orderby and order attributes. Shortcode

implements paging and attributes like shortcode in WooCommerce – see list of all available options here. Other shortcodes do not implement those attributes.

• show lottery winners – [lotteries_winners], [lotteries_winners paginate="true" limit="12" order="desc"]
• show featured lotteries –[featured_lotteries], [featured_lotteries paginate="true" limit="12" columns="4" orderby="date" order="desc"]
• show ending soon lotteries – [ending_soon_lotteries], [ending_soon_lotteries paginate="true" limit="12" columns="4" order="desc" future="no" lottery_status="active"]
• show recent lotteries, lottery_status=”active” attribute filters out finished lotteries – [recent_lotteries], [recent_lotteries paginate="true" limit="12" columns="4" orderby="date" order="desc" lottery_status="active"]
• show future lotteries – [future_lotteries], [future_lotteries paginate="true" limit="12" columns="4" orderby="date" order="desc"]
• show lotteries (with specific product ID) – [lotteries ids="1,2,3,4,5"] this shortcode supports attributes (pagination and sort) similar to WooCommerce shortcode complete list of options is here
• show user’s lotteries (active lotteries in which user participates and list of user’s won lotteries) – [my_lotteries], [my_lotteries paginate="true" limit="5"]
• show past / ended lotteries – [finished_lotteries], [finished_lotteries paginate="true" limit="12" columns="4" order="desc"]
• shortcode for lucky dip with quantity example (Pick Number Mod addon only) – [lottery_lucky_dip_buton qty="5" label="buy 5 tickets"]
• shortcode to display all instant wins (Pick Number Mod addon only) – [lottery_all_instant_wins paginate="true" limit="5" orderby="title"]
• shortcode to display all instant winners (Pick Number Mod addon only) – [lottery_all_instant_winners limit="5"]
• shortcode to display all instant winners tab (Pick Number Mod addon only), if you use this shortcode you can disable instant wins TAB in Woo Settings > Lottery settings – [lottery_instant_winners_tab]

Reference for each shortcode we have can be found in public\class-wc-lottery-shortcodes.php and public\class-wc-shortcode-lotteries.php