Quick configuration

  1. 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:

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

    Read more about how to add your own recipient sources in the Site configuration reference.

  2. 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 Behaviour and select MAIL Module under Contains plugin.

    ../_images/MailPageModule.png

  3. Add static Page TSconfig files

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

    • MAIL: Remove not supported content element (mail)

    • MAIL: Add simple mail backend layout (mail)

    • MAIL: Default settings for mail pages (mail)

    ../_images/MailPageTSconfig.png

    Press the good old floppy disc icon to save.

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

  4. Select MAIL backend layout

    Choose it for this page and also for the subpages.

    ../_images/MailBackendLayouts.png

  5. Include TypoScript templates

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

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

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

    ../_images/MailRemoveConstantsSetup.png

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

    • Fluid Content Elements (fluid_styled_content)

    • MAIL (mail)

    ../_images/MailIncludeTypoScriptTemplates.png

    Read more about possible configurations via TypoScript in the Reference section.

  6. 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 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.

    ../_images/MailDefaultSettings.png

Further reading