Как настроить почтовые уведомления в OpenCart

Что получится в конце

За 15–30 минут вы настроите отправку писем из OpenCart 3.0.x через SMTP и проверите уведомления о заказах, регистрации и возвратах. Покажем настройки на примере внешнего почтового сервиса: конкретные имена серверов, порты и требования к паролю зависят от вашего провайдера.

Что подготовить до начала

• OpenCart 3.0.x с доступом администратора. В OpenCart 4 названия разделов могут отличаться, поэтому не переносите настройки вслепую.
• Адрес отправителя, например shop@example.com. Желательно, чтобы он находился на вашем домене.
• SMTP-сервер, порт, тип шифрования, имя пользователя и пароль приложения, если почтовый сервис его требует.
• Доступ к почтовому ящику для проверки входящих и папки «Спам».
• Резервную копию базы данных и файлов сайта перед изменением настроек.

SMTP¹ — протокол, через который сайт передаёт письмо почтовому серверу. OpenCart не доставляет сообщение напрямую получателю: он подключается к SMTP-серверу, проходит авторизацию и передаёт ему письмо.

Если письма не уходят, сначала проверяйте SMTP-подключение и журнал ошибок, а не шаблон письма. Красивое письмо бесполезно, если сервер магазина не может авторизоваться у почтового провайдера.

Пошаговая настройка SMTP

1. Откройте настройки магазина. В административной панели OpenCart перейдите в System → Settings, найдите нужный магазин и нажмите Edit. Если магазинов несколько, выберите тот, с которого должны уходить уведомления.

   Откройте вкладку Store и найдите поле E-Mail. Укажите основной адрес магазина. Он используется как адрес для ответов и служебных уведомлений, но фактический адрес отправителя также зависит от настроек почтового класса и версии OpenCart.

   Проверка: после сохранения снова откройте настройки магазина и убедитесь, что адрес сохранился без пробелов и опечаток.

2. Выберите почтовый механизм. Перейдите на вкладку Mail. В поле Mail Engine выберите SMTP, а не Mail. Вариант Mail передаёт сообщение локальному почтовому сервису сервера, который на виртуальном хостинге может быть отключён или ограничен.

   Проверка: после выбора SMTP на странице должны появиться поля для адреса сервера, логина, пароля, порта и тайм-аута.

3. Заполните адрес SMTP-сервера. В поле SMTP Hostname укажите имя сервера, которое выдал почтовый провайдер. Не подставляйте адрес сайта, домен магазина или адрес панели хостинга, если провайдер указал другое значение.

   В OpenCart 3 формат поля может зависеть от почтового класса и версии сборки. Если провайдер отдельно указывает тип шифрования, следуйте его инструкции. Не добавляйте вручную префиксы вроде ssl://, пока это прямо не требуется документацией вашего хостинга.

   Проверка: сверяйте значение с официальной справкой почтового провайдера, а не с настройками почтовой программы наугад.

4. Укажите логин и пароль. В поле SMTP Username обычно указывают полный адрес ящика, например shop@example.com. В поле SMTP Password введите пароль от SMTP или отдельный пароль приложения.

   Пароль приложения — это отдельный ключ для подключения программы к ящику при включённой двухфакторной аутентификации. Его нельзя заменять кодом из SMS или одноразовым кодом из приложения.

   Проверка: убедитесь, что в логине нет пробела в начале или конце, а пароль не вставился с лишним переносом строки. Не сохраняйте реальные пароли в скриншотах, тикетах и файлах темы.

5. Настройте порт и тайм-аут. В SMTP Port укажите порт из документации провайдера. Для защищённых соединений часто используются 465 или 587, но считать любой из них универсально правильным нельзя: порт и режим шифрования должны соответствовать друг другу.

   В поле SMTP Timeout оставьте значение, рекомендованное хостингом, если оно уже заполнено. Слишком маленький тайм-аут вызывает обрывы на медленном соединении, а слишком большой заставляет пользователя долго ждать завершения действия.

   Проверка: ещё раз сопоставьте пару «порт — шифрование» с инструкцией почтового сервиса. Если провайдер требует STARTTLS, не заменяйте его портом для SSL только потому, что тот выглядит знакомо.

6. Настройте служебные уведомления. В поле Additional Alert E-Mails можно указать дополнительные адреса через запятую, если такая возможность есть в вашей сборке. В списке Alert Mail включите нужные события: новый заказ, регистрацию аккаунта, отзыв, возврат или партнёрскую заявку.

   Не включайте все события без проверки: отзывы и регистрация могут создать большой поток писем, а несколько администраторов получат дубликаты.

   Проверка: сохраните настройки и убедитесь, что событие нового заказа включено хотя бы для одного рабочего адреса.

7. Сохраните настройки и сделайте тестовый заказ. Нажмите Save, откройте витрину в режиме инкогнито и оформите заказ с отдельным тестовым адресом. Проверьте письмо покупателя, письмо администратора и карточку заказа в панели OpenCart.

   Тестируйте не только кнопку «Отправить письмо». Заказ проходит цепочку событий, поэтому именно тестовая покупка показывает, работает ли уведомление на практике.

   Проверка: письмо должно появиться во входящих в течение нескольких минут. Если его нет, проверьте «Спам», папку отправленных сообщений и журнал ошибок магазина.

Если письмо не пришло

«Connection timed out» или долгое ожидание

OpenCart не смог установить соединение с SMTP-сервером. Проверьте имя хоста и порт, а затем уточните у хостинга, разрешены ли исходящие SMTP-подключения. На некоторых тарифах такие подключения ограничены, чтобы сервер нельзя было использовать для массовой рассылки.

«Connection refused»

Сервер отклонил подключение на указанном порту. Чаще всего выбран неверный порт, отключён нужный режим шифрования или провайдер блокирует соединение с вашего IP-адреса. Сверьте параметры с официальной документацией и запросите у хостинга проверку исходящего соединения.

«Authentication failed» или «535 Authentication failed»

SMTP-сервер не принял логин и пароль. Проверьте полный адрес ящика, пароль приложения и отсутствие пробелов. Если вы недавно меняли пароль, сохраните настройки OpenCart заново и убедитесь, что почтовый сервис не требует отдельного разрешения для SMTP.

Письмо ушло в спам

SMTP-подключение работает, но домен отправителя не подтверждён или содержание письма вызывает подозрения у принимающего сервера. Настройте SPF и DKIM по инструкции вашего почтового провайдера, используйте адрес отправителя на домене магазина и не подменяйте его случайным публичным ящиком.

В журнале нет ошибки, но письма нет

Проверьте правильность адреса получателя и папку «Спам». Затем посмотрите журнал OpenCart в разделе System → Maintenance → Logs или в разделе логов, который предусмотрен вашей сборкой. Если запись отсутствует, событие могло не вызвать отправку: проверьте статус заказа и включённые типы уведомлений.

Где ещё проверить проблему

Не отправляйте десятки тестовых заказов подряд. Сначала сделайте один тест, запишите точное время и попросите хостинг проверить журнал исходящих соединений. Так можно отделить ошибку OpenCart от ограничений сервера или отказа почтового провайдера.

Если письма приходят только администратору, но не покупателю, сравните адреса и событие, которое запускает отправку. Если не приходят оба типа сообщений, проблема обычно находится в SMTP-настройках, доступности сервера или почтовой очереди.

Настройка почты не исправляет уже отправленные уведомления и не гарантирует доставку в основной ящик. Успешная SMTP-авторизация означает только, что провайдер принял письмо от магазина.

Что сделать дальше

После тестового заказа проверьте письма для всех ключевых статусов: новый заказ, оплата, отправка, отмена и возврат. Затем настройте SPF и DKIM домена, если их требует почтовый сервис, и сохраните параметры SMTP в менеджере паролей, а не в заметках на сервере.

В продакшене раз в месяц проверяйте тестовым заказом три показателя: письмо создано OpenCart, SMTP-сервис его принял, а получатель видит его не в спаме. Если меняете хостинг, домен или пароль ящика, повторите эту проверку до запуска рекламы.