Associate gift card product with engine to generate gift cards

So now it is time to define the association between gift card product you created in previous step - with engine that will generate the gift card code. This means that if someone will order previously created "gift product" - association that you can define here - will generate the gift card.

Create new association

On module configuartion page please open section "define vouchers". There you can see the list of created associations between your "gift card" product and engine to generate gift cards. Click on "add new" button - you will be redirected to page where you can create such association.

Settings of new gift card

Below you can find explanation related to available fields that you have to fill out during association process. Please fill out them carefully. Module will generate gift cards only if you will define association. It is not enough to just create gift card product. So, the fields are:

1. How to get voucher code
   This option defines how module will get gift card code (voucher code) that customer will receive. Module has two types of workflow:
   
   1. Automatically generate gift cards (voucher codes) - these voucher codes are automatically added to shop system and customers will have possibility to use this voucher code during checkout
   2. Get gift card (voucher code) from predefined list of voucher codes - you can create group of voucher codes and add there list of gift codes. When customer will order "gift card" product - module will get random code from this list and send as a voucher code. IMPORTANT: this option does not add a voucher code to the shop system automatically. This feature is for retail store purposes (not online shop)
2. Name
   this is internal name of the association. It is visible for your eye only for distinction purposes.
3. Product
   Here you can search for product. Selected product will be treated as a "gift card". So if someone will order it - module will generate gift card.
   It is possible that this search tool will not work properly in some specific environments (depends on shop settings, host settings etc.). So - If you are not able to search for product:

   1. Please make sure that you connected to your back office with proper url (address with www is not the same as address without, address with http is not the same as address with https). Url just must be exactly the same as url of your shop.
   2. The other thing that can affect the search tool is maintenance mode - so if your shop is under maintenance mode - please make sure that your ip address is added to accepted ip addresses list.
   3. Permissions (chmods) to files - if they are wrong, there is a chance that these files will not be accessible from browser. Please make sure that /modules/ directory has 755 chmod, /modules/giftcertificate/ directory has 755  chmod, /modules/giftcertificate/ajax_giftcertificate.php has 644 chmod
4. Product ID
   This field is helpful if your search tool does not want to work. Just put here the id number of your product, so you will not have to search for it.
5. Mail template (gift owner)
   Module will use this email template when someone will order this gift. This is an email template for the customer of 'gift card' product.
6. Mail template (mail to friend)
   Module will use this email template when someone will send gift to friend. This is an email template that module will send to friend of your customer.
7. Email title
   Here you can define the title of the message that module will send with gift card to customer that will order the 'gift card' product, or to friend (if customer of 'gift card' will decide to send the gift card to friend).
8. Downloadable PDF template
   Module will use this template file to build a downloadable pdf file with gift certificate. You can create own templates and each instance of gift card can use different pdf template. Link to pdf file can be added to email with variable {pdf_link}

When you will fill out fields - you can hit save button. Module will create an instance of association between:

• Gift card product you created previously
• Voucher code that you can configure in the next step