Extension Configuration

Some general settings can be configured in the Extension Configuration.

Go to Admin Tools > Settings > Extension Configuration
Choose mail

The settings are divided into several tabs and described here in detail:

Properties

Mail

defaultRecipientFields

type: string
Default: uid, salutation, name, title, email, phone, www, address, company, city, zip, country, fax, firstname, first_name, last_name

Comma separated list of default recipient fields. Will be available by markers in a mail message. e.g. name as ###USER_name### or ###USER_NAME### filled with (uppercase) value of the user.

additionalRecipientFields

type: string
Default

Comma separated list of additional fields that may be substituted in the mail messages.

allowedFetchHosts

type: string
Default

Comma separated list of trusted hosts, e.g. intranet.example.org,*.example.org (*. matches all sub domains).

To protect against server side request forgery (SSRF), the server only fetches urls (content of external url mails, their stylesheets and images to embed) whose host resolves to public ip addresses. Hosts of the TYPO3 sites are always trusted. Add hosts here, which resolve to an internal network address but may be fetched nevertheless.

Credentials for password secured pages (httpUsername, httpPassword) are only sent to the site hosts and the hosts configured here.

mailPageTypeNumber

type: int
Default: 24

MAIL page type number. Change this number only if another extension use the same.

mailModulePosition

type: string
Default: after:web

MAIL modules position in the side navigation. If set to empty, the module will move to the end of all other modules

mailModulePageId

type: int
Default

MAIL module page id. If set, page tree navigation will be hidden in MAIL module. Here you can add the uid of the MAIL sys-folder if you only have one.

mailModulePageIds

type: string
Default: auto

MAIL module page id. Reduces the page tree of the mail modules to a comma separated list of page uids. If set to "auto" (default), the list will be automatically taken from the pages database table, based on the selected module. This value can be overwritten via userTS.

Feature

hideNavigation

type: bool
Default

Hide navigation: If set, page tree navigation will be hidden in mail module. User tsconfig parameter tx_mail.mailModulePageId has to be set!

deleteUnusedMarkers

type: bool
Default: 1

Delete unused markers in personalized mails. All markers/placeholder without corresponding recipient data will remove from personalized mails.

notificationJob

type: bool
Default: 1

Enable notification mail. Allow MAIL to send notification about start and end of a mailing job.

deactivateCategories

type: bool
Default

Deactivate categories. Attention: If set, ALL category fields inside tt_content,fe_users,tt_address,tx_mail_domain_model_group will be disabled!

useHttpToFetch

type: bool
Default

Use http connection for fetching Newsletter-Content. Even if your TYPO3 Backend is in SSL-Mode, the URL for fetching the newsletter contents will be http

Direct Mail Migration

directMailCategorySysCategoryMapping

type: string
Default

Mapping sys_dmail_category -> sys_category. Used by update wizard to migrate Direct Mail records to MAIL records. Format: 1:2,2:3,3:4 maps Direct mail category 1 to sys_category 2 and Direct mail category 2 to sys_category 3 and so on. If categories not found or set, new categories will be added.

directMailCategorySysCategoryParentCategory

type: int
Default

Parent sys_category used by sys_dmail_category -> sys_category migration. If the migrated categories should be attached to a parent sys_category.