Почта

Сайт отправляет два письма: при регистрации и по запросу нового пароля. Он отправляет их с помощью функции PHP mail() или через SMTP-сервер собственным клиентом, без сторонних библиотек.

SMTP

Укажите mail.smtp в конфигурации; без host сайт использует mail():

'mail' => array(
    'from' => 'Site <[email protected]>',
    'smtp' => array(
        'host' => 'smtp.example.org',
        'port' => 587,
        'encryption' => 'tls',
        'username' => '[email protected]',
        'password' => '…',
        // 'cafile' => '/path/to/ca.pem',
        'timeout' => 15,
    ),
),
  • encryption: tls или starttls — STARTTLS, при этом письмо не отправляется, если сервер его не предлагает; ssl — TLS с самого начала (порт 465); пустая строка — без шифрования, и тогда пароль передаётся в открытом виде. Без этого параметра: порт 25, без шифрования, 15 секунд.
  • Клиент авторизуется с помощью AUTH PLAIN или LOGIN (в зависимости от того, что предлагает сервер) и сверяет сертификат сервера с его именем; cafile добавляет собственный доверенный центр сертификации.
  • from — отправитель каждого письма, с именем или без. Письма отправляются в виде текста и HTML в кодировке UTF-8, при этом отправитель указывается в качестве Reply-To и Return-Path.

В шаблоне конфигурации этот блок закомментирован, а предустановленный from — [email protected]: измените его. php index.php setup check предупреждает об обоих случаях.

Шаблоны писем

Шаблон Когда Плейсхолдеры
user_registration регистрация [user_name], [user_login], [password_link], [site_name], [site_url]
user_restore_password запрос нового пароля [sex_suffix_hello], [user_name], [user_login], [restore_link], [site_name], [site_url]

«Шаблоны писем» — /admin/mail-templates/ — позволяет редактировать каждый шаблон для каждого языка: «Тема письма», текст и HTML письма; в разделе «Подсказки» перечислены плейсхолдеры. Шаблон нельзя удалить, можно только отключить — а отключённый шаблон останавливает отправку своего письма с сообщением «Не найден активный шаблон письма». Плейсхолдеры подставляются на языке страницы; в HTML они экранируются.

[site_name] берётся из разных мест: в письме о регистрации подставляется строка интерфейса TXT_SITE_NAME, в письме о смене пароля — название сайта из раздела «Настройки сайта». Задайте оба значения.

Если письмо не отправляется

Сайт записывает Mail: <reason> в журнал ошибок PHP, при этом посетитель всё равно видит обычное сообщение. Команды для отправки тестового письма нет: настроив почту, зарегистрируйте тестового пользователя или запросите новый пароль и проверьте журнал.