from_email

string

Default value for the 'From' or sender email address of direct mails. (Required)

Note: This email address appears as the originating address or sender address in the direct mails received by the recipients.

from_name

string

Default value for 'From' or sender name of direct mails. (Required)

Note: This name appears as the name of the author or sender in the direct mails received by the recipients.

replyto_email

string

Default value for 'Reply To' email address.

Note: This is the email address to which replies to direct mails are sent. If not specified, the 'From' email is used.

replyto_name

string

Default value for 'Reply To' name.

Note: This is the name of the 'Reply To' email address. If not specified, the 'From' name is used.

return_path

string

Default return path email address.

Note: This is the address to which non-deliverable mails will be returned to.

Note: If you put in the marker ###XID###, it'll be substituted with the unique id of the mail recipient.

Note: The return path email address cannot be set by the Direct Mail module  if PHP is running with safe_mode enabled.

organisation

string

Name of the organization sending the mail.

priority

int+

Default priority of direct mails.

Possible values are:

1 - High

3 - Normal

5 – Low

Default: 3

sendOptions

int+

Default value for the format of email content.

If in doubt, set it to 3 (Plain and HTML). The recipients are normally able to select their preferences anyway.

Possible values are:

1 - Plain text only

2 - HTML only

3 - Plain and HTML

Default: 3

includeMedia

boolean

Default value for this direct mail option: if set, images and other media are incorporated into the HTML mail content.

Note: When this option is set on a direct mail, images and other media are encoded and incorporated into the messages. Sent messages will be heavier to transport.

When the option is not set, images and media are included in HTML content by absolute reference (href) to their location on the site where they reside.

Default: 0

flowedFormat

boolean

Default value for this direct mail option: if set, text will flow normally in the plain text content of email messages.

Note: If the option is set, plain text mail content will still be broken in fixed length lines, as is standard for plain text email content, but so-called flowed format will be used. This will allow client agents that support this format to display the text as normally flowing text. The option is ignored if 'quoted-printable' is used.

Note: this setting will produce email headers with 'format=flowed'. See http://www.ietf.org/rfc/rfc3676.txt for more information.

Note: In order for plain text content to be correctly rendered for effective use of this option, the flowedFormat property should also be set in the TS template of the plain text rendering plugin.

HTMLParams

string

Default value for additional URL parameters used to fetch the HTML content from a TYPO3 page.

Note: The specified parameters will be added to the URL used to fetch the HTML content of the direct mail from a TYPO3 page. If in doubt, leave it blank.

plainParams

string

Default value for additional URL parameters used to fetch the plain text content from a TYPO3 page.

Note: The specified parameters will be added to the URL used to fetch the  plain text content of the direct mail from a TYPO3 page.

Note: If in doubt, set it either to '&type=99' or, when TemplaVoila is used, to '&print=1'.

Default: &type=99

use_domain

Int+

Uid of default sys_domain record of the domain that should be used for fetching content from internal TYPO3 pages.

Note: When a domain is specified on a direct mail, the domain will also be used in all internal links contained in mail content.

Note: When no domain is specified on a direct mail, the domain in use in the backend when the direct mail is compiled is used to fetch internal TYPO3 pages.

quick_mail_encoding

string

Content transfer encoding to use when sending quick mails.

Possible values:

quoted-printable

base64

8bit

Default: quoted-printable

direct_mail_encoding

string

Default value for the content transfer encoding of direct mails.

Possible values:

quoted-printable

base64

8bit

Default: quoted-printable

quick_mail_charset

string

Character set to use when sending quick mails.

Default: iso-8859-1

direct_mail_charset

string

Default character set for direct mails built from external pages.

Note: This is the character set used in direct mails when they are built from external pages and character set cannot be auto-detected.

Note: Direct mails based on internal TYPO3 pages will be sent with the character set in which they are rendered as determined by their TS template.

Default: iso-8859-1

use_rdct

boolean

If set, links longer than 76 characters found in plain text content will be redirected: long URL's will be substituted with ?RDCT=[md5hash] parameters.

Note: This configuration determines how Quick Mails are handled and further sets the default value for Direct Mails.

Default: 0

long_link_mode

boolean

If set and if use_rdct is set, all links in plain text content will be redirected, not only links longer than 76 characters.

Default: 0

enable_jump_url

boolean

If set, the use of jump URL's will be enabled so that click statistics can be produced.

Default: 0

authcode_fieldList

list

Default list of fields to be used in the computation of the authentication code included in unsubscribe links and in jump URL's in direct mails.

Default: uid

http_username

string

The username used to fetch the mail content, if mail content is protected by HTTP authentication.

Note: The username is NOT sent in the mail!

Note: If you do not specify a username and password and a newsletter page happens to be protected, an error will occur and no mail content will be fetched.

http_password

string

The password used to fetch the mail content, if mail content is protected by a HTTP authentication.

Note: The password is NOT sent in the mail!

Note: If you do not specify a username and password and a newsletter page happens to be protected, an error will occur and no mail content will be fetched.

userTable

string

Custom-defined table  that may be used to send direct mails in addition to fe_users and tt_address tables.

Note: The following columns must be defined in the custom-defined table: uid, name, title, email, phone, ww, address, company, city, zip, country, fax, module_sys_dmail_category, module_sys_dmail_html

test_tt_address_uids

list of UIDs

List of UID numbers of test recipients.

Before sending mails, you should test the mail content by sending test mails to one or more test recipients. The available recipients for testing are determined by this list of UID numbers. So first, find out the UID numbers of the recipients you wish to use for testing, then enter them here in a comma-separated list.

test_dmail_group_uids

list of UIDs

List of UID numbers of test recipient lists.

Alternatively to sending test-mails to individuals, you can choose to send to a whole list. This is the list of recipient list UID numbers available for this action.