Плагин SparkPost Mail Transport for XF 2.3 3.1.1

В этом дополнении есть полная поддержка обработки возвращенных сообщений электронной почты и сообщений без подписки с использованием SparkPost Events API - почтовый ящик не требуется.

Установка:
Если вы еще этого не сделали, вам нужно будет настроить отправляющий домен для вашего форума в вашей учетной записи SparkPost. Настоятельно рекомендуется также настроить домен возврата по умолчанию.

Затем вам нужно будет создать ключ API со следующими разрешениями:

1. Поиск событий: только для чтения
2. Передачи: Чтение/запись

Как только у вас будет свой API-ключ, измените способ передачи электронной почты на странице параметров электронной почты на "SparkPost" и вставьте свой API-ключ в прилагаемое поле.



Конфигурация

Как показано на скриншоте выше, вы можете настроить некоторые параметры переноса при настройке SparkPost.

• Отслеживание кликов включает отслеживание кликов по всем ссылкам в отправленных электронных письмах
• Отслеживание открытия добавляет изображение отслеживания ко всем отправленным электронным письмам, чтобы отслеживать открытие
• В тестовом режиме ко всем адресам электронной почты получателей будет добавлено ".sink.sparkpostmail.com Чтобы мы могли протестировать взаимодействие с SparkPost, не отправляя никаких электронных писем получателям.

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

Под заголовком параметра SparkPostMail находится дополнительная страница настройки:

• Размер пакета сообщений о событиях позволяет вам настроить, сколько событий система будет пытаться получить в каждом пакете. В целом, вам не нужно изменять это значение по умолчанию.

Тестирование:
Вы можете протестировать функциональность дополнения с помощью встроенной системы тестирования электронной почты XenForo - перейдите в пользовательский интерфейс администратора > Инструменты > Протестировать исходящую электронную почту


Обратите внимание, что класс передачи электронной почты должен быть \Hampel\Symfony\Mailer\SparkPost\Transport\SparkPost Api Transport - если это не так, значит, вы неправильно установили или активировали дополнение.

Существует также второй тестовый инструмент, который позволяет вам указать, отправлять ли электронные письма с транзакциями или без них. Перейдите в пользовательский интерфейс администратора > Инструменты > Протестировать SparkPost


Установите флажок для отправки транзакционных сообщений электронной почты и отключите его для отправки нетранзакционных сообщений.

Во всех случаях вам следует проверять заголовки получаемых вами электронных писем, чтобы убедиться, что они действительно были отправлены через SparkPost, и проверить наличие/отсутствие заголовка "Отписаться от рассылки" (заголовок должен присутствовать для электронных писем, не связанных с транзакциями, и отсутствовать для электронных писем, связанных с транзакциями).

Транзакционные и нетранзакционные электронные письма
Электронные письма о транзакциях - это автоматизированные электронные письма, отправляемые системой для передачи клиенту или пользователю сайта информации, относящейся к их учетной записи или использованию вашего сайта. Как правило, они предназначены для конкретного пользователя и, как правило, важны для постоянного использования вашего сайта.

Примерами электронных писем, связанных с транзакциями, являются: электронные письма о

1. создании и активации учетной записи
2. сброс пароля и двухфакторная аутентификация
3. оповещения о безопасности и учетной
4. записи, уведомления о подписках или параметрах оповещения, выбранных пользователем
5. квитанции о покупке и уведомления о доставке
6. юридические и важные уведомления на сайте

Электронные письма, не связанные с транзакциями (также называемые коммерческими электронными письмами), как правило, рассылаются группе пользователей массово (хотя они также могут быть персонализированными), содержащие рекламные или маркетинговые материалы. Обычно такие материалы получают только те пользователи, которые зарегистрировались для получения таких материалов от вас.

Примерами электронных писем, не связанных с транзакциями, являются:

1. информационные бюллетени
2. предложения о продаже
3. обновления новых продуктов
4. электронные письма, предназначенные для повышения вовлеченности пользователей и их адаптации и т.д

На веб-сайте SparkPost есть более подробная информация о транзакционных и коммерческих электронных письмах.

По умолчанию SparkPost помечает все электронные письма, отправленные через их API, как "нетранзакционные". Это дополнение изменяет это поведение и делает транзакционными все электронные письма на форуме, за исключением:

1. Электронных писем, отправленных через интерфейс администратора - Общение > Электронная почта пользователей
2. Приветственные электронные письма

Между транзакционными и нетранзакционными электронными письмами, отправляемыми через SparkPost, есть два существенных различия:

1. в некоторых почтовых клиентах для запросов на отмену подписки в один клик добавлен заголовок List-Unsubscribe (заменяющий заголовок, добавленный XenForo). Электронные письма с транзакциями не содержат этого заголовка.
2. существуют отдельные списки рассылки для электронных писем, связанных и не связанных с транзакциями. Если кто-то отпишется от рассылки электронных писем, не связанных с транзакциями, вы все равно сможете отправлять им важные электронные письма, связанные с транзакциями, такие как подписка на форум и сброс пароля. Однако, если кто-то откажется от подписки на вас или заблокирует доступ к электронным письмам о транзакциях, вам следует отключить его учетную запись, поскольку вы больше не сможете отправлять ему по электронной почте важную информацию о форуме.

Подробнее о списках запрещенных рассылок смотрите ниже.