Skip to the content
Documentation

[MailSettings]

No ratings yet
Setting Summary
EmailSender Defines the default sender e-mail address for mails sent from Exponential.

Changed in Exponential 6.0.15

Settings of this group in the settings files of Exponential 6.0.15 that this page does not describe:

Setting File Default Description
HTMLLayout settings/notification.ini enabled enabled: a notification written as text (the templates of notification/handler/*/view/) is sent as text and as HTML in the mail layout (design:mail/layout.tpl), the first address on a line of its own as the button. disabled: as text only. A template that sets content_type is sent as it says either way.
Transport settings/site.ini sendmail 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
TransportAlias settings/site.ini file=eZFileTransport; sendmail=eZSendmailTransport; smtp=eZSMTPTransport A list of possible handlers for sending mails, use the setting Transport to specify which one to use
TransportServer settings/site.ini (empty) Configuration for SMTP
TransportConnectionType settings/site.ini (empty) Connection type in SMTP: <empty>(no encryption)|ssl|sslv2|sslv3|tls
TransportPort settings/site.ini 25 Default SMTP port is 25, default Secure SMTP port(SSL,TLS) is 465
TransportUser settings/site.ini (empty)  
TransportPassword settings/site.ini (empty)  
TransportAuthMethod settings/site.ini (empty) 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.
SenderHost settings/site.ini localhost 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
AdminEmail settings/site.ini [email protected]  
EmailReplyTo settings/site.ini (empty) 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.
UserAgent settings/site.ini (empty) 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.
AllowedCharsets settings/site.ini us-ascii; utf-8; iso-8859-1; iso-8859-15; cp1252 Which charset are allowed to send directly, those that do not match is converted to OutputCharset before being sent.
OutputCharset settings/site.ini utf-8 Which charset to convert emails to if they are not in correct format
ContentType settings/site.ini text/plain Content type of mails, for instance text/plain or text/html
HeaderLineEnding settings/site.ini auto 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.
SendmailOptions settings/site.ini (empty) 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]
SendmailEnvelopeSender settings/site.ini enabled 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.
SendmailInsertUndisclosedRecipient settings/site.ini enabled 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"
DebugSending settings/site.ini disabled If enabled, all emails will be sent to DebugReceiverEmail instead of to their original recipient(s)
DebugReceiverEmail settings/site.ini (empty) Receiver email address to use when DebugSending is enabled
ExcludeHeaders settings/site.ini (empty) 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

In this section

Contributors

Comments

Add a comment

Comments are read by a moderator before they appear.