利用Django内置的认证视图实现用户密码重置功能详解
作者:雷子-LL
前言
密码重置功能相信对大家来说都不陌生,本文主要给大家介绍了关于使用Django内置的认证视图实现简单的通过邮箱重置密码的功能,分享出来供大家参考学习,下面话不多说了,来一起来看看详细的介绍吧。
版本: django 1.11
实现方法
在django.contrib.auth.views中提供了四个类视图用于密码重置
class PasswordResetView
URL name: password_reset #要保持相同
通过给邮箱发送重置密码的链接进行密码重置.注意如果邮箱不存在,不会发送邮件但也不会有错误提示!
属性:
- template_name:指定重置密码页面的模板名称(输入邮箱页面),默认为'registration/password_reset_form.html'
- form_class:指定对邮箱进行验证的Form,默认为'PasswordResetForm',如果要实现'邮箱未注册'的提示,可以重写该Form的clean()方法.
- email_template_name:邮件内容的模板,默认为'registration/password_reset_email.html'.
- subject_template_name:邮件主题的模板,默认'registration/password_reset_subject.txt'.
- success_url:邮件发送成功(或邮箱未注册)后重定向的URL.
- form_email: 发送邮件的地址.默认使用DEFAULT_FORM_EMAIL.需要在settings.py文件中进行邮箱参数的配置.
- extra_context: 需要添加到模板中的额外上下文数据.
对PasswordResetView进行简单定制:
form django.contrib.auth.views import PasswordRestView from django.contrib.auth.forms import PasswordRestForm from django.contrib.auth.models import User from django import forms class CustomPasswordResetForm(PasswordRestForm): #实现'邮箱未注册'的提示 class clean_email(self): email = self.cleaned_date.get('email', '') if not User.objects.filter(email=email): raise forms.ValidationError('邮箱未注册') return email class CustomPasswordResetView(PasswordRestView): template_name = 'your_passd_reset.html' form_class = CustomPasswordResetForm #urls.py from myapp import views urlpatterns = [ # 除非重写了各视图的模板,否则name需要和指定的URL name一致 url(r'^password_reset/$', views.CustomPasswordResetView.as_view(), name='password_reset'), ]
class PasswordResetDoneView
URL name: password_reset_done
显示邮件成功发送的页面.该视图默认由PasswordResetView的success_url参数来调用.
注意:如果邮箱未注册,用户的is_active为False或者有不可用密码,仍然会重定向到该页面,但是不会发送邮件!
属性:
- template_name:指定模板文件,默认'registration/password_reset_done.html'
- extra_context: 添加额外的上下文数据
class PasswordResetConfirmView
URL name: password_reset_confirm
显示一个含有输入新密码的表单的页面
属性:
- template_name:指定模板文件,默认'registration/password_reset_confirm.html'
- post_reset_login: 一个布尔值,指定密码重置成功后是否自动登录,默认为False.
- post_reset_login_backend:当你重写了authentication_backend,并且设置post_reset_login为True,需要指定所使用的authentication_backend
- form_class: 用于验证密码的Form,默认为SetPasswordForm.
- success_url: 密码重置后重定向的url,默认'password_reset_complete'.
- extra_context: 额外的上下文
class PasswordResetCompleteView
URL name:password_reset_complete
显示一个视图,通知用户密码已重置成功
属性:
- template_name: 指定模板文件,默认'registration/password_reset_complete.html'
- extra_context: 额外的上下文
下面这三个视图的重写方法与PasswordResetView相同.
如果完全使用默认提供的功能和模板,可以直接在urls.py文件中引入
from django.conf.urls import url, include from django.contrib.auth import views as auth_views urlpatterns = [ url(r'^login/$', auth_views.LoginView.as_view(), name='login'), url(r'^logout/$', auth_views.logout_then_login, name='logout'), #注销后重定向到登录界面 url(r'^password_reset/$', auth_views.PasswordResetView.as_view(form_class=forms.CustomPasswordResetForm), name='password_reset'), #密码重置链接 url(r'^password_reset/done/$', auth_views.PasswordResetDoneView.as_view(), name='password_reset_done'), #密码重置邮件发送完成后的页面 url(r'^reset/(?P<uidb64>[0-9A-Za-z_\-]+)/(?P<token>[0-9A-Za-z]{1,13}-[0-9A-Za-z]{1,20})/$', auth_views.PasswordResetConfirmView.as_view(), name='password_reset_confirm'), #用户通过邮箱打开的重置密码页面 url(r'^reset/done/$', auth_views.PasswordResetCompleteView.as_view(), name='password_reset_complete'), #密码重置完成后跳转的页面 ]
参考:https://docs.djangoproject.com/en/1.11/topics/auth/default/#module-django.contrib.auth.views
总结
以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作具有一定的参考学习价值,如果有疑问大家可以留言交流,谢谢大家对脚本之家的支持。