README

With this package you can sell shop articles as vouchers. Customer can buy two types of voucher. Voucher cards or email vouchers. If the customer buys a voucher the system generates dynamically unique voucher codes and add the codes to order notification. E-mail vouchers will be directly send to customer mail or customer can set a different mail.

For each voucher the system generates a html page the customer can be use to print the voucher. The Link to print voucher was be added to separate email voucher notification

Installation

• if you use old php view templates
  • Look at the installation directory, the most files are includes you can include directly in the same named view in your customer project
• if you use a them with twig templates
  • copy or link /installation/snippets/pkgShopBuyableVoucher to your theme and add include them in you theme templates
    • basket-product-email-voucher.html.twig to you items in checkout basket step. You have to add the mapper BasketArticleVariantMailVoucherMapper to chain.
    • basket-product-email-voucher-show.html.twig to your items in checkout confirm step. You have to add mapper BasketArticleVariantMailVoucherMapper to chain.
    • order-items-voucher-codes.html.twig to your items in the order history. You have to add mapper OrderItemVoucherDataMapper to chain.
• Create new voucher series sponsor if you don't have one.
• Create new voucher series in cms and connect it with you voucher series sponsor.
• Create new voucher article
  • Connect this article with your voucher series
  • On the variant selection in you article choose variant set "Gutschein Post/E-Mail"
  • Then create the variant you need for email voucher and card voucher
• configure the new mail templates (Geschenkgutschein-E-Mail an Kunde, Geschenkgutschein-E-Mail an alternative E-Mailadresse)
• if you want that the customer can print their voucher
  • create new page in the system tree
  • add module "Kaufgutschein drucken" to page
  • go to routing configuration in cms (Kaufgutschein Druckansicht) and set your created page
  • add a sytem page in your portal with system name "buyable_voucher_print" and link it with you print page
  • copy the snippets directory in the installation directory to your theme (twig for print voucher)
  • style your twig template
    • you can add an voucher background in cms -> Portale/Webseiten -> Druckansicht Kaufgutschein (Hintergrund)
    • add your custom less in /assets/pkgshopbuyablevoucher-assets/voucherPrint.less