.. ==================================================
.. FOR YOUR INFORMATION
.. --------------------------------------------------
.. -*- coding: utf-8 -*- with BOM.

.. ==================================================
.. DEFINE SOME TEXTROLES
.. --------------------------------------------------
.. role::   underline
.. role::   typoscript(code)
.. role::   ts(typoscript)
   :class:  typoscript
.. role::   php(code)

=================================
EXT: bw_powermail_mpdf
=================================

:Created:
      2010-12-18 19:57

:Changed:
      2016-02-18 15:48

:Classification:
      bw_powermail_mpdf

:Keywords:
      pdf, powermail, form, html2pdf, html, powermailpdf

:Author:
      Eike Starkmann, Browserwerk

:Email:
      starkmann@undkonsorten.com, typo3@browserwerk.de

:Language:
      en

:Description:
	bw_powermail_mpdf is a modification of the extension `powermailpdf <https://typo3.org/extensions/repository/view/powermailpdf/>`_ and can be used for automatic pdf generation with `mPDF <http://www.mpdf1.com/mpdf/index.php>`_ after a powermail form is submitted.


Introduction
-------------------------------------------------------------

This extension can insert powermail data to an html document and transform it to PDF.


Installation
-------------------------------------------------------------

- Download `mPDF <http://www.mpdf1.com/mpdf/index.php>`_ and unzip the files to Classes\mpdf
- Install this extension
- Add a valid TypoScript Setup Configuration to the page which uses the powermail form.
- Create a html template which should be rendered to pdf and set the filepath in TypoScript Setup.

TypoScript Configuration
"""""""""""""""""""""""""
This is an example configuration.
   ::

      plugin.tx_bwpowermailmpdf {
        settings {
          # Activate powermail pdf
          activate = 1

          # Show download link on success page
          showDownloadLink = 1

          # Send PDF via Email?
          email{
            attachFile = 0
          }

          # Link settings
          filelink {
            ATagParams = class="btn btn-default btn-primary"
            jumpurl = 0
            jumpurl.secure = 0
            jumpurl.secure.mimeTypes = pdf=application/pdf
            icon = 0
            icon_link = 0
            target = _blank
          }

          # PDF settings
          sourceFile = fileadmin/form.html
          fillPdf = 1
          fieldMap {
            # pdffield = powermailfield
            name = name
            email = email
            interests = interests
          }
        }
      }