Настройки, cron и возвраты

Системные настройки

Все настройки лежат в пространстве имён postcraft.

Ключ	По умолчанию	Назначение
postcraft_timezone	пусто	часовой пояс дня и окна отправки, например Europe/Moscow. Пусто: пояс PHP
postcraft_sites	создаётся при установке	JSON со списком сайтов, см. Несколько сайтов
postcraft_unsub_pages	{}	тексты страниц отписки. Правьте их на вкладке «Страница отписки»
postcraft_role	hub	hub или edge
postcraft_hub_url	пусто	для edge: адрес hub
postcraft_edge_secret	создаётся при установке	общий ключ hub и edge
postcraft_bounce_imap_host	пусто	IMAP-сервер ящика для возвратов. Пусто: разбор выключен
postcraft_bounce_imap_port	993	порт IMAP, соединение по SSL
postcraft_bounce_imap_user	пусто	логин IMAP
postcraft_bounce_imap_pass	пусто	пароль IMAP
postcraft_bounce_imap_mailbox	INBOX	папка

Обновление пакета не меняет значения, которые вы уже поставили.

Cron

* * * * * php /path/to/site/core/components/postcraft/cron.php

Каждый запуск отправляет письма, время которых наступило, пачками по 100 в течение 40 секунд. Если настроен IMAP, после очереди разбираются до 20 новых возвратов. Отдельная задача bounce разбирает до 50 за запуск:

*/10 * * * * php /path/to/site/core/components/postcraft/cron.php bounce

Скрипт печатает итог в одну строку, например queue {"ok":2,"fail":0,"skipped":0,"processed":2}. Его удобно писать в лог.

Возвраты

Недоставленные письма почтовые серверы возвращают отправителю. PostCraft читает такие письма по IMAP и отмечает их в статистике:

• hard bounce (адреса нет, ящик удалён): адрес попадает в blacklist, письмо получает статус «Bounce»;
• soft bounce (ящик переполнен, временная ошибка): событие пишется в статистику, адрес остаётся в рассылках.

Письмо возврата PostCraft связывает с рассылкой по адресу bounce+токен@домен или по полю Final-Recipient.

Ящики Local ставят в письмо Return-Path: bounce+токен@домен-отправителя. Чтобы возвраты доходили, на домене нужен ящик или алиас, который принимает адреса вида bounce+…. У ящиков SMTP обратный адрес выставляет SMTP-сервер, обычно это сам ящик отправителя. Укажите его в настройках IMAP.

Требуется PHP-расширение imap. Обработанные письма помечаются прочитанными.