Метод email_user

Метод email_user применяется к объекту модели User и отправляет электронное письмо на адрес пользователя. Этот метод является удобной обёрткой над функцией send_mail и автоматически использует настройки электронной почты из конфигурации Django. Метод принимает обязательные параметры - тему и сообщение, а также дополнительные параметры для настройки отправки.

Синтаксис

pythonuser.email_user(subject, message, from_email=None, **kwargs)

Параметры метода:

• subject - тема письма (строка);
• message - тело письма (строка);
• from_email - адрес отправителя (необязательный параметр, по умолчанию используется DEFAULT_FROM_EMAIL);
• **kwargs - дополнительные параметры, которые передаются в функцию send_mail (например, fail_silently, html_message и другие).

Пример

Отправим простое текстовое письмо пользователю с уведомлением о регистрации:

pythonfrom django.contrib.auth.models import User

# Получаем пользователя
user = User.objects.get(username='john_doe')

# Отправляем письмо
user.email_user(
  subject='Welcome to our site!',
  message='Thank you for registering on our platform.'
)

Результат выполнения кода:

python"Email sent successfully"

Пример

Отправим письмо с указанием адреса отправителя и с поддержкой HTML-формата:

pythonfrom django.contrib.auth.models import User

# Получаем пользователя
user = User.objects.get(email='user@example.com')

# Отправляем HTML-письмо
user.email_user(
  subject='Password reset',
  message='Plain text message',
  from_email='admin@mysite.com',
  html_message='<strong>Click here</strong> to reset your password'
)

Результат выполнения кода:

python"HTML email sent successfully"

Пример

Отправим письмо с использованием дополнительного параметра для подавления исключений:

pythonfrom django.contrib.auth.models import User

# Получаем пользователя
user = User.objects.get(username='jane_smith')

# Отправляем письмо с подавлением исключений
user.email_user(
  subject='Important notification',
  message='Your account has been updated.',
  fail_silently=True
)

Результат выполнения кода:

python"Email sent or failed silently"

Смотрите также