union_auto_test/mail_vanger/README.md

45 lines
3.2 KiB
Markdown
Raw Permalink Normal View History

2026-01-10 09:45:10 +00:00
# Модуль для отправки данных с форм на электронную почту
Этот модуль предназначен для отправки данных, полученных с форм, на электронную почту через настроенный SMTP-сервер.
## Установка и настройка
### 1. Добавьте приложение в `INSTALLED_APPS`
В файле настроек проекта (`settings.py`) добавьте приложение `mail_vanger` в список `INSTALLED_APPS`:
```python
INSTALLED_APPS = (
...
'mail_vanger',
)
```
### 2. Укажите кастомный бекенд для отправки почты
В файле настроек проекта укажите кастомный бекенд для отправки почты:
```python
EMAIL_BACKEND = 'mail_vanger.backends.CustomMailBackend'
```
### 3. Запустите миграции
Для создания необходимых таблиц в базе данных выполните миграции:
```bash
python manage.py migrate mail_vanger
```
### 4. Настройте подключение к email-серверу
В админке Django найдите таблицу "Настройки подключения к email-серверу" и заполните её своими данными:
* Хост: Адрес SMTP-сервера.
* Порт: Порт для подключения (например, 587 для TLS).
* Имя пользователя: В качестве адреса отправителя будет использоваться почта, указанная в этом поле.
* Пароль: Пароль от почтового ящика.
* Использование TLS/SSL: Укажите, нужно ли использовать шифрование TLS или SSL (это зависит от настроек вашего SMTP-сервера).
* SSL ключ и сертификат: Если используется SSL, укажите пути к SSL ключу и сертификату, если необходимо.
### Использование
После настройки вы сможете отправлять данные с форм на указанный в настройках адрес электронной почты.
В проекте реализована возможность повторной отправки данных на электронную почту через админку, что позволяет управлять статусом отправленных писем.
Если письмо не было успешно отправлено, в админке появляется кнопка "Отправить повторно".
При нажатии на кнопку "Отправить повторно" будет произведена попытка повторной отправки письма. Если отправка не удалась, в поле с ошибкой будет указано сообщение с описанием проблемы. Если отправка успешно выполнена, статус записи обновится на "Успешно".