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

.. include:: ../../Includes.txt

Set up Newsletter
=================

.. _setup-newsletter:

**Setup** for `multiple newsletters` in **2** easy steps!
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. figure:: ../../Images/Components/Newsletter/nlsample.png
   :alt: Sample newsletter template


.. _nlincludestatics:

1. Include **static template** for newsletter pages
"""""""""""""""""""""""""""""""""""""""""""""""""""

**Newsletter Page (simplegrids)** will create a standalone newsletter pagetype for a page and its children. It also adds the grid element *Newsletter grid*.

.. figure:: ../../Images/Components/Newsletter/nlstatic1.png
   :alt: Newsletter Root - Static Templates

We recommend to include the `direct_mail` statics too, to simplify your newsletter process.


.. _nlpreparations:

2. Include the Newsletter **PageTS** for TYPO3 Content elements
"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

.. important:: In TYPO3 CMS Version 6.x, you have to include the PageTS Config in the page settings by the **old way**


.. figure:: ../../Images/Components/Newsletter/nlpagets_v6.png
  :alt: PageTS Config TYPO3 CMS v6


.. tip:: In TYPO3 CMS Version 7.x, you can include the PageTS Config in the page settings by the **new way**


.. figure:: ../../Images/Components/Newsletter/nlpagets_v7.png
  :alt: PageTS Config TYPO3 CMS v7


If you include our PageTS on newsletter pages, the html output of the used content elements is optimizes for Newsletter. It will also hide content elements with no relevanve for Newsletter and it adds extra Gridelements for Newsletter.


The following grid elements will be added
"""""""""""""""""""""""""""""""""""""""""

.. figure:: ../../Images/Components/Newsletter/nl2.png
   :alt: content wizard

newsletter grid
"""""""""""""""

.. figure:: ../../Images/Components/Newsletter/nlgrids.png
   :alt: newsletter grid


**That's it!** Now you can start creating newsletter pages.


The following part will show you how to **customize** the newsletter templates
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. _nlgridconfiguration:


.. figure:: ../../Images/Components/Newsletter/tnl1.png
   :alt: plugin configuration text newsletter


.. _textnewsletter:

Text-Newsletter
"""""""""""""""

	**?type=99** is the default pagetype number for direct_mail text newsletters.

.. figure:: ../../Images/Components/Newsletter/tnl2.png
   :alt: output example text newsletter

.. _customize:

Customizing
^^^^^^^^^^^

Easily change the newsletter template file in **constant editor**
""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

.. figure:: ../../Images/Components/Newsletter/nl3.png
   :alt: template path in constant editor


Configuration of the newsletter grid
""""""""""""""""""""""""""""""""""""

.. figure:: ../../Images/Components/Newsletter/nl1.png
   :alt: grid configuration


.. _template-variables:

Template Variables
^^^^^^^^^^^^^^^^^^

.. container:: ts-properties

	======================================= ======================================================== =================== ===============
	Variable                                Title                                                    Container-Variable       Type
	======================================= ======================================================== =================== ===============
	tx_gridelements_view_column_101_        Header Image (optional)                                  data.                string
	tx_gridelements_view_column_201_        Content box                                              data.                string
	tx_gridelements_view_column_301_        Content below box (optional)                             data.                string
	flexform_backgroundColor_               Background Color (Default: #f0f0f0)                      data.                string
	flexform_includeTemplateStyle_          Use given styles from template                           data.                boolean
	flexform_ownStyle_                      Add your own CSS.                                        data.                string
	flexform_textcontent_                   Text newsletter content                                  data.                string
	======================================= ======================================================== =================== ===============


.. _tx_gridelements_view_column_101:

tx_gridelements_view_column_101
"""""""""""""""""""""""""""""""
.. container:: table-row

   Property
         tx_gridelements_view_column_101
   Data type
         string
   Description
         Contains the content of the header-image-column. Example usage is: {data.tx_gridelements_view_column_101 -> f:format.raw()}

.. _tx_gridelements_view_column_201:

tx_gridelements_view_column_201
"""""""""""""""""""""""""""""""
.. container:: table-row

   Property
         tx_gridelements_view_column_201
   Data type
         string
   Description
         Contains the main content of the content-box-column. Example usage is: {data.tx_gridelements_view_column_201 -> f:format.raw()}

.. _tx_gridelements_view_column_301:

tx_gridelements_view_column_301
"""""""""""""""""""""""""""""""
.. container:: table-row

   Property
         tx_gridelements_view_column_301
   Data type
         string
   Description
         Contains the main content of the content-below-box-column. Example usage is: {data.tx_gridelements_view_column_301 -> f:format.raw()}

.. _flexform_backgroundColor:

flexform_backgroundColor
""""""""""""""""""""""""
.. container:: table-row

   Property
         flexform_backgroundColor
   Data type
         string
   Description
         This variable contains the color code from each newsletter-grid flexform. Example usage is: {data.flexform_backgroundColor}. You can use the variable {bgcolor} as fallback color code: {f:if(condition:'{data.flexform_backgroundColor}',then:data.flexform_backgroundColor,else:bgcolor)}

.. _bgcolor:

bgcolor
"""""""
.. container:: table-row

   Property
         bgcolor
   Data type
         string
   Description
         This variable contains the color code, what is defined in the contant editor. Example usage: {bgcolor}

.. _flexform_includeTemplateStyle:

flexform_includeTemplateStyle
"""""""""""""""""""""""""""""
.. container:: table-row

   Property
         flexform_includeTemplateStyle
   Data type
         boolean
   Description
         This variable can include/exclude the template defined CSS styles. Example usage is: {f:if(condition:'{data.flexform_includeTemplateStyle}',then:'body {margin: 0;padding: 0;}')}

.. _flexform_ownStyle:

flexform_ownStyle
"""""""""""""""""
.. container:: table-row

   Property
         flexform_ownStyle
   Data type
         string
   Description
         Contains the CSS styles you have entered in newsletter-grid flexform. Example usage is: {f:if(condition:'{data.flexform_ownStyle}',then:data.flexform_ownStyle)}

.. _flexform_textcontent:

flexform_textcontent
""""""""""""""""""""
.. container:: table-row

   Property
         flexform_textcontent
   Data type
         string
   Description
         Contains the text-content for text-newsletter. Example usage is: <f:if condition="{textcontent}"><f:then>{data.flexform_textcontent}</f:then><f:else><!DOCTYPE html newsletter goes here>...