- Головна
- Документація
- Пошта
Пошта
Сайт надсилає два листи: при реєстрації та при запиті нового пароля. Він надсилає їх за допомогою 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— відправник кожного листа, з іменем або без. Листи надсилаються у форматах text і 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] |
«Шаблоны писем» (Mail templates) — /admin/mail-templates/ — дозволяє редагувати кожен шаблон окремо для кожної мови: «Тема письма» (Subject), текстова і HTML-версія листа; «Подсказки» (Hints) містить перелік плейсхолдерів. Шаблон не можна видалити, лише вимкнути — вимкнений шаблон зупиняє надсилання відповідного листа з повідомленням «Не найден активный шаблон письма» (No active mail template). Плейсхолдери підставляються мовою сторінки; у HTML вони екрануються.
[site_name] береться з різних місць: лист реєстрації використовує рядок інтерфейсу TXT_SITE_NAME, лист відновлення пароля — назву сайту з «Настройки сайта» (Site settings). Встановіть обидва.
Коли лист не надсилається
Сайт записує Mail: <reason> до журналу помилок PHP, а відвідувач бачить звичайне повідомлення. Команди для надсилання тестового листа не існує: після налаштування пошти зареєструйте тестового користувача або запросіть новий пароль і перевірте журнал.