- Главная
- Документация
- Почта
Почта
Сайт отправляет два письма: при регистрации и по запросу нового пароля. Он отправляет их с помощью функции 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, при этом посетитель всё равно видит обычное сообщение. Команды для отправки тестового письма нет: настроив почту, зарегистрируйте тестового пользователя или запросите новый пароль и проверьте журнал.