如何正确更改密码重置电子邮件的模板 Django

Question

这行代码负责发送包含密码重置链接的电子邮件。

path('accounts/password-reset/', auth_views.PasswordResetView.as_view(), name='password_reset'),

但是邮件看起来很枯燥，阅读时很难区分重要部分。

为了吸引用户的注意力并更好地引导他们，我想为这封电子邮件添加样式。

可以通过以下几行将自定义模板添加到电子邮件中：

...
path('accounts/', include('django.contrib.auth.urls')),
path('accounts/password-reset/', auth_views.PasswordResetView.as_view(html_email_template_name='registration/password_reset_email.html'), name='password_reset'),
...

问题是邮件里面的reset-link由一个uidb64值和一个token组成，比如：

localhost:8000/password-reset/calculated_uidb64/calculated_token

将这些值传递给password_reset_email.html 的自定义模板的正确方法是什么？

Answer 1

在 django PasswordResetView 中使用自定义电子邮件模板之前，您需要了解以下几点。

1. django 使用registration/password_reset_email.html 作为密码重置电子邮件内容的默认文件，除非您在PasswordResetView 的html_email_template_name 参数值中明确定义/提供它。

2. Django 允许电子邮件模板中的 jinja 模板根据您的要求对其进行修改。

3. PasswordResetView 提供开箱即用的密码重置视图所需的即用型上下文。如用户实例填写任何用户详细信息、site_name、token等。

这是通过 django 模板使用上下文的电子邮件模板示例。

{% autoescape off %}
You're receiving this e-mail because you requested a password reset for your user account at {{ site_name }}.

Please go to the following page and choose a new password:
{% block reset_link %}
{{ protocol }}://{{ domain }}{% url django.contrib.auth.views.password_reset_confirm uidb36=uid, token=token %}
{% endblock %}

Your username, in case you've forgotten: {{ user.username }}

Thanks for using our site!

The {{ site_name }} team.

{% endautoescape %}

上述模板中使用（或可以使用）的上下文如下：

email: An alias for user.email
user: The current User, according to the email form field. Only active users are able to reset their passwords (User.is_active is True).
site_name: An alias for site.name. If you don’t have the site framework installed, this will be set to the value of request.META['SERVER_NAME']. For more on sites, see The “sites” framework.
domain: An alias for site.domain. If you don’t have the site framework installed, this will be set to the value of request.get_host().
protocol: http or https
uid: The user’s primary key encoded in base 64.
token: Token to check that the reset link is valid.

注意：由于user是一个用户模型实例，其他值如user.id，user.contact_number也可以在email模板中使用。

有用的资源：

1. 我强烈推荐这个article 地址Django: Resetting Passwords (with internal tools)
2. Official django documentation 描述有用的选项和上下文。
3. Code in django repository 深入了解PasswordResetVieww 的工作原理。