The Raffle Ticket Generator (RTG) plugin is an add-on to WooCommerce. You need to first install WooCommerce and have it configured. We also highly recommend a good backup system. For those are who are web developers with experience in shopping carts and eCommerce, things do happen. With having built thousands of eCommerce sites, and supported thousands more that got hacked, a broken or hacked site can be a disaster without regular offsite backups.
RTG uses the WooCommerce product categories to control the options for each raffle. To create a raffle these are the most basic steps:
- Create a WooCommerce Product Category and designate it as a Raffle Category
- Set the options for the raffle in the Raffle Ticket Generator
- Make products for each Ticket Package. We use a seperate product for each number of tickets. The Raffle Ticket Generator Plugin is designed for use with a SIMPLE woocommerce product. It WILL NOT SUPPORT VARIABLE product. For example, if you want 1 ticket for $10 and 3 tickets for $25. You will make 2 products and assign the $10 product to give 1 ticket, and the $25 product to give 3 tickets. Assign the raffle product to a SINGLE CATEGORY and it MUST BE A RAFFLE CATEGORY.
- Raffle Tickets are generated when an order for that designated product is PAID per WooCommerce Order Status.
NOTE: Please do a full test of your settings PRIOR to going live with your raffle. ONCE YOUR RAFFLE IS LIVE – DO NOT CHANGE SETTINGS!!! Some configuration settings like Random or max tickets set other variables and changing them during a raffle can reset those and cause duplicate numbers or undesired results.
Setting Up Raffle Categories:
With WooCommerce installed and configured and RTG installed and activated, you need to create a WooCommerce Product Category and make it a raffle category. From WooCommerce, Products, Categories, add new. Give the category a name and assign a parent if needed. You will see the option to “Make this Category as Raffle Category”, check that box. This will tell the RTG plugin that this category will have raffle options.
Setting up the Raffle Options:
When you have added a Raffle Category, you can now see that category as an option in the Raffle Ticket Generator settings. As with any development project, you should work from simple to complicated. The Raffle Ticket Generator plugin is designed to be used by Web Developers. There are many options and some of these require indepth server admin skills if your web server is not configured properly. So, to get started – we recommend that you setup the first raffle as a test and to simple set the starting number, add orderid or prefix and do not use ticket images. Test to make sure things are generating, then add the other options you need and want. If you add all the features and options from the start and you are not generating tickets, you have a longer path to troubleshoot. Each raffle can only be assigned to a SINGLE CATEGORY.
From the top or side menu in the dashboard, select the Raffle Ticket Generator and you will have a list of WooCommerce Product Categories that have been checked as being raffle categories. It will look like this:
To access the settings and options for each raffle just click on the Category name to display.
Later on we will discuss each option and what it does, but for the quickstart there are only a few things you need to know.
- Starting Ticket Number – This it the beginning ticket number – most people use something like 1001 or 1501.
- Prefix for the raffle ticket – Something to be specific for your raffle.
That is all you need for now.
Setting the WooCommerce SIMPLE Product:
The final setup is to create the WooCommerce Product. From WooCommerce, Products, Add New. DO NOT MAKE A VARIABLE PRODUCT.
Give the product a title and description and image. Check the raffle product indicator and assign it to a SINGLE raffle category. The product will get it’s setting from the raffle category is it assigned to. Setting multiple categories will confuse the plugin and not assign any tickets.
Down the product info area – click on the raffle tab to display the options for this product. Depending on Gold or Silver, you might see different options there. For now, you only need to be concerned with the Number of Tickets. This is the number of tickets to be given when 1 of these products is purchased. For our 1 ticket for $10 example – that will be a 1 for that box.
Click save or update and save your product.
Testing the Ticket Generation:
At this point you have a raffle setup and products. This is a good time to test out the plugin and make sure it is working. Add COD to WooCommerce Payment Options.
We recommend not using Ticket Images to start out with until you have your settings configured how you want them. The Ticket Images need the gdImage Libraries on your server and that is the number one problem people have. Many of the budget shared hosting plans do not support that. When you purchase a ticket and the status is “processing” which in WooCommerce means the order is paid, then it should display the tickets you setup in the order confirmation page and the email like above.