.. include:: /Includes.rst.txt

.. _quick-configuration:

===================
Quick configuration
===================

..  rst-class:: bignums

.. _import-recipient-sources:

#. Add recipient sources

   MAIL needs a yaml configuration for recipient sources. It comes with a ready
   configuration for frontend user groups (fe_groups), frontend user (fe_users)
   and addresses (tt_address).

   To add them all, just import the included yaml into your site configuration:

   .. code-block:: yaml

       imports:
          - { resource: "EXT:mail/Configuration/Site/RecipientSources.yaml" }

   Read more about how to add your own recipient sources in the
   :ref:`Site configuration reference <site-configuration-recipient-sources>`.

   .. _add-mail-sysfolder:

#. Add a new sys-folder inside (!) of your page tree (not on page 0!)

   This folder will be used to store the MAIL pages later. Remember the uid of
   this new sys-folder page, you may need it in a later step.

   Open the settings of the new created sys-folder page, go to tab :guilabel:`Behaviour`
   and select :guilabel:`MAIL Module` under :guilabel:`Contains plugin`.

   .. include:: /Images/MailPageModule.rst.txt

   .. _add-static-page-ts-config-files:

#. Add static Page TSconfig files

   Switch to tab :guilabel:`Resources` and add this three static :guilabel:`Page TSconfig` entries:

   *  :guilabel:`MAIL: Remove not supported content element (mail)`
   *  :guilabel:`MAIL: Add simple mail backend layout (mail)`
   *  :guilabel:`MAIL: Default settings for mail pages (mail)`

   .. include:: /Images/MailPageTSconfig.rst.txt


   Press the good old floppy disc icon to save.

   After saving, a new backend layout :guilabel:`MAIL` should be available under the :guilabel:`Appearance` tab.

   .. _select-mail-backend-layout:

#. Select MAIL backend layout

   Choose it for this page and also for the subpages.

   .. include:: /Images/MailBackendLayouts.rst.txt


   .. _include-typoscript-templates:

#. Include TypoScript templates

   To use the included table based content elements, a corresponding TypoScript
   is provided by this extension.

   Go module :guilabel:`Web > Template` and chose your MAIL sys-folder. If not
   already done, create an extension template. Switch to view :guilabel:`Info/Modify`
   and click on :guilabel:`Edit the whole template record`.

   Switch to tab :guilabel:`Option` and check :guilabel:`Constants` and :guilabel:`Setup`
   to remove TypoScript settings from TypoScript records up in root-line.

   .. include:: /Images/MailRemoveConstantsSetup.rst.txt

   Switch to tab :guilabel:`Includes` and add the following templates from the list
   to the right:

   *  :guilabel:`Fluid Content Elements (fluid_styled_content)`
   *  :guilabel:`MAIL (mail)`

   .. include:: /Images/MailIncludeTypoScriptTemplates.rst.txt

   Read more about possible configurations via TypoScript in the
   :ref:`Reference <typoscript-settings>` section.

   .. _configure-default-settings:

#. Configure default settings

   MAIL brings – like EXT:direct_mail – an own backend module to adjust some default
   settings, used e.g. by the MAIL wizard to create new mailings.

   To use it, click on the blue cog icon (Configuration) on the left side at the bottom of
   all other MAIL modules.

   Here you have to choose the previous created mail sys-folder first, because the configuration will be
   stored in its :guilabel:`Page TSconfig` field.

   The input fields are divided into several groups, which can be reached by clicking on their titles.

   After filling all fields with your data, press SAVE to store.

   .. include:: /Images/MailDefaultSettings.rst.txt

Further reading
===============

*  :ref:`Global extension configuration <extension-configuration>`
*  :ref:`Site configuration <site-configuration>` (Recipient sources and mail transport settings)
*  :ref:`TypoScript configuration <typoscript-page-view-settings>`
*  :ref:`Page TSconfig configuration <page-ts-config>`