其他内建视图
除了login()视图外,认证系统还有其他一些有用的内建视图。这些 视图都在中:
logout(request[,next_page,template_name,redirect_field_name])
登出用户。
可选参数:
next_page: 登出后转向的 URL 。
template_name: 登出后要显示的模板的全名。如果没有提供这个参数, 缺省为registration/logged_out.html。
redirect_field_name: 包含登出后转向的 URL 的GET字段的名称。 如果给出则覆盖next_page。
模板语境:
title: 本地化的 "Logged out" 字符串。
logout_then_login(request[,login_url])
登出用户,并重定向到登录页面。
可选参数:
login_url: 要重定向到的登录页面的 URL 。如果没有给出这个参数,则 缺省为。
password_change(request[,template_name,post_change_redirect,password_change_form])
允许一个用户更改自己的密码。
可选参数:
template_name: 显示用户更改页面的模板全名。如果没有给出,则缺省为registration/password_change_form.html。
post_change_redirect: 成功更改密码后要转向到的 URL 。
New in Django 1.2:
password_change_form: 一个自定义的“更改密码”的表单,必须接受一个user关键字参数。这个表单负责改变用户密码。
模板语境:
form: 密码变更表单。
password_change_done(request[,template_name])
用户变更密码后要显示的页面。
可选参数:
template_name: 模板的全名。缺省为registration/password_change_done.html。
password_reset(request[,is_admin_site,template_name,email_template_name,password_reset_form,token_generator,post_reset_redirect,from_email])
生成一个用于用户重置密码的一次性链接,并通过电子邮件发送这个链接。
Changed in Django Development version:增加了from_email参数。
可选参数:
template_name: 用于显示密码重置页面的模板全名。如果没有给出,则 缺省为registration/password_reset_form.html。
email_template_name: 用于生成包含新密码的电子邮件的页面的模板 全名。如果没有给出,则缺省为registration/password_reset_email.html。
password_reset_form: 用于设置密码的表单。缺省为。
token_generator: 检查密码的类的实例。缺省为default_token_generator,它是一个django.contrib.auth.tokens.PasswordResetTokenGenerator的实例。
post_reset_redirect: 成功变更密码后要转向的 URL 。
from_email: 一个可用的电子邮件地址。缺省情况下 Django 使用。
模板语境:
form: 用于重置密码的表单。
password_reset_done(request[,template_name])
重置密码显示的页面。
可选参数:
template_name: 模板的全名。缺省为registration/password_reset_done.html。
redirect_to_login(next[,login_url,redirect_field_name])
重定向到登录页面,成功登录后回到另一个 URL 。
必选参数:
next: 成功登录后到转向的 URL 。
可选参数:
login_url: 登录页面的 URL 。缺省为。
redirect_field_name: 包含登录后要转向的 URL 的GET字段的 名称。如果给出则覆盖next。
password_reset_confirm(request[,uidb36,token,template_name,token_generator,set_password_form,post_reset_redirect])
给出一个输入新密码的表单。
可选参数:
uidb36: 用户的 id 以 base 36 方式编码。缺省为None。
token: 检查密码是否有效的标志。缺省为None.
template_name: 显示确认密码视图的模板的全名。缺省为registration/password_reset_confirm.html。
token_generator: 检查密码的类的实例。缺省为default_token_generator,它是一个django.contrib.auth.tokens.PasswordResetTokenGenerator的实例。
set_password_form: 用于设置密码的表单。缺省为SetPasswordForm。
post_reset_redirect: 重置密码的要转向的 URL 。缺省为None。
password_reset_complete(request[,template_name])
展现一个通知用户密码已成功变更的视图。
可选参数:
template_name: 显示视图的模板的全名。缺省为registration/password_reset_complete.html。