Пошта

Сайт надсилає два листи: при реєстрації та при запиті нового пароля. Він надсилає їх за допомогою 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, а відвідувач бачить звичайне повідомлення. Команди для надсилання тестового листа не існує: після налаштування пошти зареєструйте тестового користувача або запросіть новий пароль і перевірте журнал.