[email protected]
[email protected]
Phone: 084.4.8585.4587
LUCKY DRAW
USER GUIDE
Version 1.1
Table of Contents
1. INTRODUCTION ............................................................................ 3
2. HOW TO USE .................................................................................. 4
2.1. Register for a Lucky Draw program (play Lucky Draw) ............................ 4
2.2. Refer program to friends ............................................................................. 9
2.3. Receive prize .............................................................................................. 17
2.4. Use failed code to check out ...................................................................... 19
3. HOW TO CONFIGURE ............................................................... 21
3.1. Manage Lucky Draw program .................................................................. 21
3.1.1. Add a new program ............................................................................. 21
3.1.2. Edit an existing program ..................................................................... 23
3.1.3. Delete a program ................................................................................. 24
3.1.4. Pause and resume a program ............................................................... 26
3.1.5. Process and complete a program ......................................................... 28
3.2. Manage Lucky Draw codes ....................................................................... 29
3.3. Manage Settings......................................................................................... 30
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
2
1. INTRODUCTION
Outstanding features:
Having a win of any amounts is always brings excitement to everyone, so entice
customers into a fortune game right in your store must be the great idea. Our Lucky
Draw extension helps you create lucky draw programs and reward customers who own
prize codes. As there’s no charge required to join in while failed codes can be
redeemed for credit toward purchases, you can easily inspire customers and drive more
traffic to your site.
For customers:
 Easy to join in lucky draw programs and receive lucky codes without
charging any amount
 Able to get reward if owing prize code
 Ability to refer friends through email or social channels and receive more
lucky codes if their friends join in program
 Failed codes can be redeemed for credit toward their purchases
For admin:
 Easy to create and manage lucky draw programs on your site
 Enable to set program name, prize, start time, end time, status… for each
program
 Ability to pause and resume, process and complete programs
 Easy to manage all lucky draw codes in the system
Others:
 100% Open source
 License Certificate valid for 1 live Magento installation and unlimited test
Magento installations (No license key required).
 Easy to install and configure
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
3
2. HOW TO USE
After creating a lucky draw program, you need to copy the program link to display on
frontend. For example, you can embed that link in CMS page, static block, banner link,
subscribe newsletter section… Then customer can click on it to go to the program
detail page.
In the program page, customer is able to view the description, the prize and the button
to play the drawing game.
2.1. Register for a Lucky Draw program (play Lucky Draw)
 If the program has not started, the system will show a countdown box of start time
on the program page and customer needs to wait for registering for the program.
 If the program has started already, the program page will show a button for
customer to register and receive lucky code from that program.
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
4
 In case customer has not logged in, a popup form will be displayed, requiring
customer to register (or log in) to play the lucky draw.
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
5
o Customer needs to fill in the register form then click on Submit button. After
that, customer will get a lucky code.
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
6
o He will also receive the confirmation email.
o He need click on the confirmation link in the email to active his code. After that,
his page is displayed:
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
7
o He will also receive the email notifying his lucky code as below:
 If customer has logged in, the register form is showed with customer information
(name, email…). After submit form, customer will receive his lucky code and a
similar email as above.
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
8
2.2. Refer program to friends
After registering for Lucky Draw program successfully, customer can refer their
friends through email or social channels (Facebook, Twitter, Google+). For each
friend registering for the program, customer will get an additional lucky code. To
refer friends, customer may click on Refer button.
Then a popup form will be displayed.
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
9
 To refer friends through email, customer can use the left side form.
 Customer may enter his friends’ email or import email contacts from Gmail,
Yahoo. For example, when clicking on Gmail button, a popup will be shown for
customer to log in to Gmail:
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
10
 After logging in and granting access for his account, customer will see a
Select contact form as below:
 When clicking on Select contacts button, the selected contacts will be
imported to the contact list of sending email.
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
11
 After that, customer can edit a message and click on Send email button to send
an email to his friends:
 An email that customer’s friends receive is similar to the followings:
 Customer can also use social channels such as Facebook, Twitter, or Google+ to
share links.
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
12
 To share links of lucky draw programs on Facebook, customer may edit status
and post it to his Facebook:
 When customer clicks on Post on Facebook button, a popup will be shown for
him to log in to his Facebook account. Customer can grant a permission to post
that status on their Wall.
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
13
 To share links on Twitter, customer may edit the message then click on Tweet
button:
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
14
 There will be a popup displayed for customer to log in to Twitter and edit his
status again.
 When customer clicks on Tweet button, the status will be posted on his Twitter
page.
 To share links on Google+, customer clicks on G+ Share button, then a popup
form will be shown for him to edit the status to post on Google+.
 After customer clicks on Share button, the link will be shared on Google+.
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
15
 And when customer’s friends register for Lucky Draw program, customer will
receive an additional lucky code.
 The code will be sent to customer email as below:
 Customer can view his codes by clicking in My draw codes link on the
program page:
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
16
2.3. Receive prize
 When the program is completed, the winner will receive an congratulation email
like this:
 In the program page, the prize code will be displayed as follows:
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
17
 The winner can contact the store owner to get the prize according to program’s
terms and conditions. Customer can view them by clicking on Terms and
Conditions link:
o Terms and conditions are shown in the popup:
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
18
2.4. Use failed code to check out
 Customer’s failed codes can be redeemed for credit toward his purchases
(depending on each program’s policy).
o To view codes, customer clicks on My draw codes link:
o And he can view the list of codes:
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
19
 When customer checks out, the failed codes will automatically spent on his order
as below:
 If an order is canceled, the credit will be refunded to the lucky codes, allowing
customer to use these codes for other checkout.
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
20
3. HOW TO CONFIGURE
3.1. Manage Lucky Draw program
 After installing the module, you can manage all programs in your system by
taking these steps:
 Log in Back-end
 Go to menu Lucky Draw → Manage Programs
 The system provides these functions to manage programs:
 List all programs in the system
 Add/Edit/Delete a program
 Process and complete, pause and resume a program
 Export programs to CSV/XML file
 Mass delete programs
3.1.1. Add a new program
 If you want to add a new program, please select Add Program button in
Manage Programs page:
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
21
 In this form, you will see two tabs:
 Program Detail: You need to fill in details of a program such as program
name, URL key, start time, end time, prize code…
Please note that Prize Code is used to define the winner of lucky draw
program. As the Prize Code can be set in the backend at your convenience, it
may bring to your customers thoughts of an unfair result or a trick. To avoid
this unexpected situation, we recommend that you should set the Prize Code
based on the result of other reputed organizations in your region. For
example, you can use the lottery result of the day that your lucky draw
program ends. Also, this result must be announced when the program
expires.
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
22
 Description: This tab allows you to upload award image, edit program’s
short description, terms and conditions.
 You have to insert all necessary information then click on Save (or Save and
Continue Edit) button to save your program.
3.1.2. Edit an existing program
 If you want to edit an existing program, you can click on Edit button or just
click on program row which you want to edit.
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
23
 And then, fill in all required information of Edit Program form, clicking on Save
(or Save and Continue Edit) button to save it.
 This form also has tab Lucky Draw Code(s) which can be hidden when you
add a new program. After clicking on this tab, you can view a grid of lucky
codes of this program.
 If the program is completed, you will see the tab Prize Code(s) and the winner
of your lucky draw program.
3.1.3. Delete a program
To delete the program, you can choose mass delete action in the grid view or delete
each program in the Edit program page. Please note that when you delete a
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
24
program, the system will delete all draw codes of customers who registered for this
program.
 To delete program by mass delete action, you need to log in to backend, go to
menu Lucky Draw → Manage Programs then:
o Select program(s) that you want to delete
o Select Delete in Actions drop box an click on Submit button
o Confirm your delete action
 To delete program in Edit program page, please click on the Delete button at the
top of that page.
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
25
o Then confirm your delete action
3.1.4. Pause and resume a program
Pause function helps you delay the program for the period of time and resume it
later.
 To pause a program, you need log in to Backend, go to menu Lucky Draw →
Manage Programs then click on a program to go to Edit program page.
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
26
 In the Edit program page, you can click on Pause button to pause your program.
 Then confirm your action
 In the frontend, the system will display as below:
 To resume the program, you can click on Resume button (this button is only
shown when program is paused) in the program edit page.
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
27
 Program will return to the last status and available for customers to play.
3.1.5. Process and complete a program
If a program not auto-draws after it ends, you will receive an email notifying that
the program needs to be completed.
 To complete program, you may log in to Backend, select menu Lucky Draw →
Manage Program and then click on program row that you want to complete. In
the program edit page, you can enter the Prize Code:
 The system will define the winner based on this code. The winner is the person
who owns the prize code or the code closest to this code (by subtracting the
draw code from the prize code). If there are two draw codes meeting the
requirement, the code that is registered earlier will win.
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
28
 Then please click on the Complete button to complete the program.
 After that, you may view the tab Prize Code(s) in Edit program page.
3.2. Manage Lucky Draw codes
 In order to manage lucky draw codes, you can take steps below:
 Log in to Backend
 Go to the menu Lucky Draw → Lucky Draw Codes
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
29
 The system allows you to change status for lucky code by selecting mass change
status action. To change status, you can select the code(s):
 Then select Change status in Actions drop box and new status in Status drop
box. After that, click on Submit button to complete.
3.3. Manage Settings
 In order to manage settings of this extension, please take the following steps:
 Log in to Backend
 Go to the menu Lucky Draw → Settings
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
30
 Then change all the parameters as you want.
No
Field
Sample
Description
General Configuration
1
2
Enable to use failed code Yes
Allow customers to use failed codes
to check out
to check out
Refund to lucky draw code Closed,
Allow the system to refund to lucky
when order status is
draw code when customer uses
Canceled
draw code to purchase but his order
is canceled
User
Register
Configuration
3
Verify
Register
Draw Yes
Code
4
Show National Identify
Require verify draw code before it
is used
Required
Show national identify in the
register form
5
Show Date of Birth
Optional
Show Date of Birth in the register
form
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
31
6
Show Tax/VAT Number
No
Show Tax/VAT Number in register
form
7
Show Gender
Optional
Show Gender in register form
8
Address Required
No
Require address when user register
to program
9
Enable to use captcha
Yes
Allow
using
captcha
when
registering for program
Refer
Friend
Configuration
10
Refer Friend Description
Description for customer to refer
friends
11
Default
Invite
Email
Default subject of invitation email
Invite
Email
Default content of invitation email
Subject
12
Default
Content
13
Yahoo Application ID
APP ID, Consumer Key, Consumer
14
Yahoo Consumer Key
Secret are provided by Yahoo when
15
Yahoo Consumer Secret
registering the domain with Yahoo
16
Google Consumer Key
Consumer Key, Consumer Secret
17
Google Consumer Secret
are supplied by Google when
registering the domain with Google
18
Default Shared Message
Default message that customers
post on Facebook, Twitter about
lucky draw program
19
Facebook Application ID
APP Id, APP Secret are provided
20
Facebook
by Facebook when registering the
Application
domain with Facebook
Secret
Email Configuration
21
22
Send lucky code email to Yes
Allow sending lucky code email to
user when he registers
user when he registers
Send lucky code email to Yes
Allow sending lucky code email to
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
32
user when referral registers
user when referral registers
23
Send email to winner
24
Send notification email to Yes
Allow sending notification email to
admin when program ends
admin when program ends (or
(or needs to be processed)
needs to be processed)
25
Admin’s name
Name of admin
26
Admin’s email
Email of admin
27
Sender
28
Lucky code confirmation
The
email template sent to user
template sent to user when he
when he registers
registers for a program
Lucky code email template
The lucky code email template sent
sent to user when he
to user when he registers for a
registers
program
Lucky code email template
The lucky code email template sent
sent to user when referral
to user when referral registers for a
registers
program
Email template sent to
The
winner
customer if he is the winner
Email template sent to
The email template sent to admin
admin when program ends
when program ends (or needs to be
(or needs to be processed)
processed)
Refer
The email template for customers to
29
30
31
32
33
Yes
General Contact
Friend
Email
Template
Allow sending email to winner
Set the sender to General Contact
code
email
confirmation
template
email
sent
to
refer friends
Finally, click on the Save Config button to complete.
-------------------------------------------------------END----------------------------------------------------
Copyright (c) 2009-2014 www.magestore.com
Lucky Draw v1.1 User Guide
33