.. include:: /Includes.rst.txt .. _quick-configuration: =================== Quick configuration =================== .. contents:: :local: :depth: 1 .. _configuration-classic-way .. rst-class:: bignums Classic Way: TYPO3 11/12/(13) ----------------------------- .. _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" } .. note:: If no entries with the key prefix mail.recipientSources found in your site configuration, the default configuration from the upper path will be used. Read more about how to add your own recipient sources in the :ref:`Site configuration reference `. .. _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 **Contains plugin**. .. include:: /Images/MailPageModule.rst.txt .. _add-static-page-ts-config-files: #. Add static Page TSconfig files Switch to tab :guilabel:`Resources` and include this three **static 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 that, 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 the :guilabel:`Advanced Options` tab and check :guilabel:`Constants` and :guilabel:`Setup` to **Clear** every TypoScript settings from TypoScript records up in root-line. Additional **Include** the following **TypoScript sets**: * :guilabel:`Fluid Content Elements (fluid_styled_content)` * :guilabel:`MAIL (mail)` .. include:: /Images/MailRemoveConstantsSetup.rst.txt Read more about possible configurations via TypoScript in the :ref:`Reference ` section. .. _configure-default-settings: #. Configure default settings MAIL brings – similar to EXT:direct_mail – an easy way to adjust some default settings, used by the mail creation wizard. You find it by clicking on the cog button (Configuration) on the upper right corner of the MAIL wizard module. .. include:: /Images/MailDefaultSettingsButton.rst.txt The input fields are divided into several groups, which can be reached by clicking on their titles. .. include:: /Images/MailDefaultSettings.rst.txt After filling all fields with your data, press SAVE to store. .. tip:: All configurations done here will be stored in the :guilabel:`Page TSconfig` field of the currently selected page. This way, it is possible to override settings in a deeper page tree level. Further reading ~~~~~~~~~~~~~~~ * :ref:`Global extension configuration ` * :ref:`Site configuration ` (Recipient sources and mail transport settings) * :ref:`TypoScript configuration ` * :ref:`Page TSconfig configuration ` .. _configuration-site-sets-way: Site Sets Way: TYPO3 13 ----------------------- .. _add-new-site-root: #. Add a new site root in your page tree This site will be used to store the MAIL pages later. Remember the uid of this new page, you may need it in a later step. Open the settings of the new created page, go to tab :guilabel:`Behaviour` and switch on **Use as Root Page**. Additional select :guilabel:`MAIL Module` under **Contains plugin**. Also check **Hide child pages in page tree**, if you like to activate a usefull feature that helps you to keep track of an extensive page tree. .. include:: /Images/MailSiteRootBehaviour.rst.txt .. _site-configuration-mail-root: #. Open the site configuration of the just created page .. include:: /Images/MailSiteConfiguration.rst.txt .. _site-settings-mail-root-select-site-set: #. Add Site Set Under the :guilabel:`General` Tab you can find all relevant settings. First of all you have to enter a **Site Identifier** (eg. newsletter). Second, add an **Entry Point**. This **must** be a full domain! Relative domains like "/" will **not** work! Same for optionaly added **Variants**. At **Sets for this Site** add the :guilabel:`MAIL Fluid Styled Content Elements` Set, which depends on the :guilabel:`MAIL Settings` Set, so that these do not need to be added separately. If you do not want to use the included content elements, which are currently based on fluid style content, you can also just add the :guilabel:`MAIL Settings` Set and then add your own set of content elements, which are based on content blocks, for example. .. include:: /Images/MailRootSiteConfigurationExample.rst.txt .. _site-settings-mail-root-select-backend-layout: #. Set Backend Layout Back in the TYPO3 :guilabel:`Page` Module, open the Settings of your MAIL Root Page. In here, click on the :guilabel:`Appearance` tab, select :guilabel:`MAIL` in both **Backend Layout** boxes and press :guilabel:`Save`. .. include:: /Images/MailBackendLayouts.rst.txt :ref:`Now you are ready to add mail pages ` .. _site-settings-mail-root-configure-style: #. Styling To change the styles of the generated mails, go to the :guilabel:`Settings` Module and click on :guilabel:`Edit Settings` of your MAIL Site. .. include:: /Images/SiteManagementSettings.rst.txt E.g. change colors under **Styles** .. include:: /Images/MailSiteSetSettings.rst.txt .. attention:: If you want to switch from the classic way to site sets way, aware that the root page of MAIL has be changed to a "real" site root. Additional do not forget to remove old TypoScript or TsConfig settings! And a classic: Clear **ALL** Caches after a change. Further reading ~~~~~~~~~~~~~~~ * :ref:`TYPO3 Site Sets `_ * :ref:`MAIL Site Sets Settings ` * :ref:`Global extension configuration ` * :ref:`Site configuration ` (Recipient sources and mail transport settings)