site.ini [MailSettings] #

The block [MailSettings] of settings/site.ini, with 23 setting(s).

If RedirectAfterPublish=uri, indicates to which URI user will be redirected
after publishing a node.
example : RedirectAfterPublishUri=/content/dashboard
if empty : will be redirected to parent node
RedirectAfterPublishUri=

Never edit settings/site.ini itself: an update replaces it. Put the settings you change in an override, which wins over the shipped file:

• settings/override/site.ini.append.php for every siteaccess,
• settings/siteaccess/<siteaccess>/site.ini.append.php for one siteaccess,
• extension/<extension>/settings/site.ini.append.php in an extension (read when the extension is active).

Transport #

The type of transport for emails, can be either: sendmail, SMTP or file
Window users should probably use SMTP
For debug purposes you can use file for sending mail to a log file

Default: sendmail.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[MailSettings]
Transport=sendmail
*/ ?>

TransportAlias #

A list of possible handlers for sending mails, use the setting Transport to specify which one to use

Default: a hash of 3: file=eZFileTransport, sendmail=eZSendmailTransport, smtp=eZSMTPTransport.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[MailSettings]
# an empty "TransportAlias[]" first replaces the shipped list; without it the items are added
TransportAlias[]
TransportAlias[file]=eZFileTransport
TransportAlias[sendmail]=eZSendmailTransport
TransportAlias[smtp]=eZSMTPTransport
*/ ?>

TransportServer #

Configuration for SMTP

Default: empty.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[MailSettings]
TransportServer=
*/ ?>

TransportConnectionType #

Connection type in SMTP: <empty>(no encryption)|ssl|sslv2|sslv3|tls

Default: empty.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[MailSettings]
TransportConnectionType=
*/ ?>

TransportPort #

Default SMTP port is 25, default Secure SMTP port(SSL,TLS) is 465

Default: 25.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[MailSettings]
TransportPort=25
*/ ?>

TransportUser #

Default: empty.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[MailSettings]
TransportUser=
*/ ?>

TransportPassword #

Default: empty.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[MailSettings]
TransportPassword=
*/ ?>

TransportAuthMethod #

SMTP authentication method: PLAIN, LOGIN, CRAM-MD5, DIGEST-MD5, NTLM or XOAUTH2.
Empty: the strongest method the server offers is tried (NTLM before LOGIN and
PLAIN; NTLM needs the mcrypt extension, gone since PHP 7.2, and then fails).
Set LOGIN or PLAIN for a server that offers NTLM. Credentials over an
unencrypted connection to a host other than localhost log a warning: use
TransportConnectionType=tls or ssl there.

Default: empty.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[MailSettings]
TransportAuthMethod=
*/ ?>

SenderHost #

The FQDN, used by extended HELO
See part "4.1.1.1 Extended HELLO (EHLO) or HELLO (HELO)" of http://www.faqs.org/rfcs/rfc2821.html

Default: localhost.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[MailSettings]
SenderHost=localhost
*/ ?>

AdminEmail #

Default: [email protected].

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[MailSettings]
AdminEmail=[email protected]
*/ ?>

EmailSender #

The address which will be set as the From header of the e-mail, unless
overridden by the template variable email_sender.

Default: empty.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[MailSettings]
EmailSender=
*/ ?>

EmailReplyTo #

The address which will be set as the Reply-To header of the e-mail, unless
overridden by the template variable email_reply_to. If not set, the senders
address will be used, either from the template, or the EmailSender setting.

Default: empty.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[MailSettings]
EmailReplyTo=
*/ ?>

UserAgent #

The User-Agent header of every mail sent through eZMail (sendmail, SMTP and file
transports), e.g. the name of the portal; ASCII only, it is not encoded.
Empty: "Exponential, Version <version>" (sendmail, file) and the default of the
mail library (SMTP), as before. eZMail::setUserAgent() still overrides it per mail.

Default: empty.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[MailSettings]
UserAgent=
*/ ?>

AllowedCharsets #

Which charset are allowed to send directly, those that do not match
is converted to OutputCharset before being sent.

Default: a list of 5: us-ascii, utf-8, iso-8859-1, iso-8859-15, cp1252.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[MailSettings]
# an empty "AllowedCharsets[]" first replaces the shipped list; without it the items are added
AllowedCharsets[]
AllowedCharsets[]=us-ascii
AllowedCharsets[]=utf-8
AllowedCharsets[]=iso-8859-1
AllowedCharsets[]=iso-8859-15
AllowedCharsets[]=cp1252
*/ ?>

OutputCharset #

Which charset to convert emails to if they are not in correct format

Default: utf-8.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[MailSettings]
OutputCharset=utf-8
*/ ?>

ContentType #

Content type of mails, for instance text/plain or text/html

Default: text/plain.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[MailSettings]
ContentType=text/plain
*/ ?>

HeaderLineEnding #

The line endings used for headers in mail messages. If you need to use
control characters like LF or CR you need to use it's urlencoded value, for
example %0A for LF and %0D for CR. The default setting is what RFC 2045
requires: CRLF
If it contains auto the system will try to determine the line-ending
based on the current operating system.

Default: auto.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[MailSettings]
HeaderLineEnding=auto
*/ ?>

SendmailOptions #

Set additional sendmail options here.
-f <sender> is default in PHP SafeMode.
Please use a line for every (sub)option. e.g.
SendmailOptions[]=-r
SendmailOptions[][email protected]

Default: an empty list.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[MailSettings]
# an empty "SendmailOptions[]" first replaces the shipped list; without it the items are added
SendmailOptions[]
*/ ?>

SendmailEnvelopeSender #

Whether sendmail is given the sender as envelope sender with -f <sender>.
disabled: no -f. A mail without a sender of its own (no sender address and no
From extra header) gets a From header with EmailSender, else AdminEmail, when one
of them is a valid address ("address" or "Name <address>"). Needed for msmtp with
--read-envelope-from, which refuses -f together with that option and reads the
envelope sender from the From header.

Default: enabled.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[MailSettings]
SendmailEnvelopeSender=enabled
*/ ?>

SendmailInsertUndisclosedRecipient #

Allows inserting undisclosed-recipients into the "TO:" of email headers.
As this is not a standard, some MTA might reject it, in that case you can set it to "disabled"

Default: enabled.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[MailSettings]
SendmailInsertUndisclosedRecipient=enabled
*/ ?>

DebugSending #

If enabled, all emails will be sent to DebugReceiverEmail instead of to their original recipient(s)

Default: disabled.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[MailSettings]
DebugSending=disabled
*/ ?>

DebugReceiverEmail #

Receiver email address to use when DebugSending is enabled

Default: empty.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[MailSettings]
DebugReceiverEmail=
*/ ?>

ExcludeHeaders #

Headers to exclude from the sent message, case insensitive, only relevant when using SMTP
You might want to add bcc here, if your mail server does not hide bcc recipients from each other

Default: an empty list.

<?php /* #?ini charset="utf-8"?
# settings/override/site.ini.append.php
[MailSettings]
# an empty "ExcludeHeaders[]" first replaces the shipped list; without it the items are added
ExcludeHeaders[]
*/ ?>

Related #

• All blocks of site.ini
• All INI files
• The settings page

Generated by ./console exp:help:examples from settings/site.ini. Do not edit this page: change the source and generate again (how). Free documentation: GFDL 1.3 or later.