在 django rest_auth 密码重置中,默认电子邮件内容如下所示:-
您收到这封电子邮件是因为您请求在 localhost:8000 为您的用户帐户重置密码。
请转到以下页面并选择一个新密码:
http://localhost:8000/api/reset/Kih/89a-23809182347689312b123/
你的用户名,以防你忘记了:test
感谢您使用我们的网站!
本地主机:8000 团队
如何自定义此电子邮件的内容?
在 django rest_auth 密码重置中,默认电子邮件内容如下所示:-
您收到这封电子邮件是因为您请求在 localhost:8000 为您的用户帐户重置密码。
请转到以下页面并选择一个新密码:
http://localhost:8000/api/reset/Kih/89a-23809182347689312b123/
你的用户名,以防你忘记了:test
感谢您使用我们的网站!
本地主机:8000 团队
如何自定义此电子邮件的内容?
我最近需要在我的一个项目中实施同样的事情,但在任何地方都找不到彻底的答案。
因此,我将我的解决方案留给将来需要它的任何人。
扩展 mariodev 的建议:
1.子类PasswordResetSerializer
和覆盖save
方法。
yourproject_app/serializers.py
from django.conf import settings
from rest_auth.serializers import PasswordResetSerializer as _PasswordResetSerializer
class PasswordResetSerializer(_PasswordResetSerializer):
def save(self):
request = self.context.get('request')
opts = {
'use_https': request.is_secure(),
'from_email': getattr(settings, 'DEFAULT_FROM_EMAIL'),
###### USE YOUR TEXT FILE ######
'email_template_name': 'example_message.txt',
'request': request,
}
self.reset_form.save(**opts)
2.配置AUTH_USER_MODEL
yourproject/settings.py
###### USE YOUR USER MODEL ######
AUTH_USER_MODEL = 'yourproject_app.ExampleUser'
3.连接自定义PasswordResetSerializer
覆盖默认
yourproject/settings.py
REST_AUTH_SERIALIZERS = {
'PASSWORD_RESET_SERIALIZER':
'yourproject_app.serializers.PasswordResetSerializer',
}
4.将路径添加到您的自定义电子邮件文本文件所在的目录TEMPLATES
yourproject/settings.py
TEMPLATES = [
{
...
'DIRS': [os.path.join(BASE_DIR, 'yourproject/templates')],
...
}
]
5. 编写自定义电子邮件消息(默认从 Django 复制)
yourproject/templates/example_message.txt
{% load i18n %}{% autoescape off %}
{% blocktrans %}You're receiving this email because you requested a password reset
for your user account at {{ site_name }}.{% endblocktrans %}
{% trans "Please go to the following page and choose a new password:" %}
{% block reset_link %}
{{ protocol }}://{{ domain }}{% url 'password_reset_confirm' uidb64=uid token=token %}
{% endblock %}
{% trans "Your username, in case you've forgotten:" %} {{ user.get_username }}
{% trans "Thanks for using our site!" %}
{% blocktrans %}The {{ site_name }} team{% endblocktrans %}
{% endautoescape %}
更新:这个解决方案是为旧版本的 django-rest-auth (v0.6.0) 编写的。正如我从评论中得知的那样,似乎对源包进行了一些更新,可以更轻松地处理开箱即用的自定义电子邮件模板。使用包中定义的方法总是比在我的解决方案中覆盖它们更好。虽然曾经是必需品,但可能不再如此。
您可以继承PasswordResetSerializer
和覆盖该get_email_options
方法。例如:
from rest_auth.serializers import PasswordResetSerializer
class CustomPasswordResetSerializer(PasswordResetSerializer):
def get_email_options(self):
return {
'subject_template_name': 'registration/password_reset_subject.txt',
'email_template_name': 'registration/password_reset_message.txt',
'html_email_template_name': 'registration/'
'password_reset_message.html',
'extra_email_context': {
'pass_reset_obj': self.your_extra_reset_obj
}
}
您需要使用自定义方法连接您自己的重置密码序列化程序 ( PASSWORD_RESET_SERIALIZER
) 。save
(参考:https ://github.com/Tivix/django-rest-auth/blob/v0.6.0/rest_auth/serializers.py#L123 )
不幸的是,由于电子邮件选项的使用方式,您需要覆盖整个保存方法。我们将在下一个版本 (0.7.0) 中使其更加灵活
一个简单的解决方案是通过模板目录创建:
-templates
-registration
password_reset_email.html
有你想要的内容。Django rest-auth 使用 django.contrib.auth 模板。
如果您想使用 html 电子邮件模板,Brian 的答案的更新将是添加
'html_email_template_name': 'account/email/example_message.html',
略低于
###### USE YOUR TEXT FILE ######
'email_template_name': 'account/email/example_message.txt',
这样您就可以使用 html 模板发送电子邮件
send_mail
您可以通过检查PasswordResetForm 类的方法来了解为什么会发生这种情况
class PasswordResetForm(forms.Form):
email = forms.EmailField(label=_("Email"), max_length=254)
def send_mail(self, subject_template_name, email_template_name,
context, from_email, to_email, html_email_template_name=None):
"""
Send a django.core.mail.EmailMultiAlternatives to `to_email`.
"""
subject = loader.render_to_string(subject_template_name, context)
# Email subject *must not* contain newlines
subject = ''.join(subject.splitlines())
body = loader.render_to_string(email_template_name, context)
email_message = EmailMultiAlternatives(subject, body, from_email, [to_email])
if html_email_template_name is not None:
html_email = loader.render_to_string(html_email_template_name, context)
email_message.attach_alternative(html_email, 'text/html')
email_message.send()```
所以对于dj-rest-auth
,这就是我的做法:
from django.contrib.auth.tokens import default_token_generator
from django.contrib.sites.shortcuts import get_current_site
from django.urls.base import reverse
from allauth.account import app_settings
from allauth.account.adapter import get_adapter
from allauth.account.utils import user_pk_to_url_str, user_username
from allauth.utils import build_absolute_uri
from dj_rest_auth.forms import AllAuthPasswordResetForm
from dj_rest_auth.serializers import PasswordResetSerializer
class CustomAllAuthPasswordResetForm(AllAuthPasswordResetForm):
def save(self, request, **kwargs):
current_site = get_current_site(request)
email = self.cleaned_data['email']
token_generator = kwargs.get('token_generator',
default_token_generator)
for user in self.users:
temp_key = token_generator.make_token(user)
# save it to the password reset model
# password_reset = PasswordReset(user=user, temp_key=temp_key)
# password_reset.save()
# send the password reset email
path = reverse(
'password_reset_confirm',
args=[user_pk_to_url_str(user), temp_key],
)
url = build_absolute_uri(None, path) # PASS NONE INSTEAD OF REQUEST
context = {
'current_site': current_site,
'user': user,
'password_reset_url': url,
'request': request,
}
if app_settings.AUTHENTICATION_METHOD != app_settings.AuthenticationMethod.EMAIL:
context['username'] = user_username(user)
get_adapter(request).send_mail('account/email/password_reset_key',
email, context)
return self.cleaned_data['email']
class CustomPasswordResetSerializer(PasswordResetSerializer):
@property
def password_reset_form_class(self):
return CustomAllAuthPasswordResetForm
# settings.py
REST_AUTH_SERIALIZERS = {
'PASSWORD_RESET_SERIALIZER':
'api.users.api.serializers.CustomPasswordResetSerializer',
}
通过传递None
tobuild_absolute_uri
而不是原来的request
,它将采用您在django.contrib.sites
模块中的值 with SITE_ID=1
。因此,您在 Django 管理员中定义为域的任何内容现在都将成为重置 URL 中的域。如果你想让密码重置 URL 指向你的前端,这是有道理的,这可能是在不同域上运行的 React 应用程序。
编辑:我关于此问题的 PR 已合并,下一个版本将可以在您的设置中进行设置。查看文档dj-rest-auth
以查看您需要设置的设置。
在您的模板文件夹中创建具有以下路径的目录
模板/管理员/注册/
现在将 django/contrib/admin/templates/registration/ 中的所有文件复制到您刚刚创建的目录中。您可以在安装 django 的位置找到此目录。在linux中,可以在这里找到
/usr/local/lib/python2.7/dist-packages/django/contrib/admin/templates/registration
您将需要 root 权限才能访问它。
现在,当您发送电子邮件时,将使用您刚刚复制到项目中的模板。
此链接可能会有所帮助。有了它,我能够找到电子邮件模板的位置以及如何自定义它们。
您可以在页面底部的 自定义电子邮件消息 http://www.sarahhagstrom.com/2013/09/the-missing-django-allauth-tutorial/#Customize_the_email_message下找到信息