union_auto_test/mail_vanger/README.md

45 lines
3.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Модуль для отправки данных с форм на электронную почту
Этот модуль предназначен для отправки данных, полученных с форм, на электронную почту через настроенный 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 ключу и сертификату, если необходимо.
### Использование
После настройки вы сможете отправлять данные с форм на указанный в настройках адрес электронной почты.
В проекте реализована возможность повторной отправки данных на электронную почту через админку, что позволяет управлять статусом отправленных писем.
Если письмо не было успешно отправлено, в админке появляется кнопка "Отправить повторно".
При нажатии на кнопку "Отправить повторно" будет произведена попытка повторной отправки письма. Если отправка не удалась, в поле с ошибкой будет указано сообщение с описанием проблемы. Если отправка успешно выполнена, статус записи обновится на "Успешно".