创建一个社交网站
重点:
- 使用认证(authentication)框架
- 创建用户注册视图(views)
- 通过一个定制的profile模型(model)扩展User模型(model)
- 使用python-social-auth添加社交认证
开始社交网站项目
django-admin startproject bookmarks#创建项目文件夹
cd bookmarks
django-admin startapp account
#settings文件installed_apps中添加account应用
注意!!! 要把INSTALLED_APPS 的‘account’,放在'django.contrib.admin'前面,否则会优先寻找内置admin应用的account。
使用认证框架
Django拥有一个内置的认证(authentication)框架用来操作用户认证(authentication),会话(sessions),权限(permissions)以及用户组。这个认证(authentication)系统包含了一些普通用户的操作视图(views),例如:登录,登出,修改密码以及重置密码。
这个认证(authentication)框架位于django.contrib.auth,被其他Django的contrib包调用。
当你使用startproject命令创建一个新的Django项目,认证(authentication)框架已经在你的项目设置中默认包含。它是由django.contrib.auth应用和你的项目设置中的MIDDLEWARE_CLASSES中的两个中间件类组成,如下:
AuthenticationMiddleware:使用会话(sessions)将用户和请求(requests)进行关联
SessionMiddleware:通过请求(requests)操作当前会话(sessions)
中间件就是一个在请求和响应阶段带有全局执行方法的类。
这个认证(authentication)系统还包含了以下模型(models):
- User:一个包含了基础字段的用户模型(model);这个模型(model)的主要字段有:username, password, email, first_name, last_name, is_active。
- Group:一个组模型(model)用来分类用户
- Permission:执行特定操作的标识
这个框架还包含默认的认证(authentication)视图(views)和表单(forms)
创建一个log-in视图(view)
1.通过提交的表单(form)获取username和password
2.通过存储在数据库中的数据对用户进行认证
3.检查用户是否可用
4.登录用户到网站中并且开始一个认证(authentication)会话(session)
先创建一个表单
from django import forms #导入表单文件夹
class LoginForm(forms.Form):#继承表单类
username = forms.CharField(max_length=200)#username为字符串字段
password = forms.CharField(widget=forms.PasswordInput)# password为字符串字段,控件为PasswordInput
#这个表单(form)被用来通过数据库认证用户。请注意,我们使用PasswordInput控件来渲染HTMLinput元素,包含type="password"属性
创建视图
from django.contrib.auth import authenticate, login
from django.http import HttpResponse
from django.shortcuts import render
from .forms import LoginForm
def user_login(request):
if request.method == "POST":
form = LoginForm(request.POST)
if form.is_valid():
cd = form.cleaned_data
username = cd['username']
password = cd['password']
user = authenticate(username=username, password=password) # 对过数据库对这个用户进行认证,成功返回user对象,失败返回None
if user is not None:
if user.is_active: # 用is_active属性来检查用户是否可用
login(request, user) # login()将用户设置到当前的会话(session)中。
return HttpResponse("登陆成功")
else:
return HttpResponse("用户被禁止登陆")
else:
return HttpResponse("用户不存在")
else:
form = LoginForm()
return render(request, 'account/login.html', {'form': form})
创建url模式
from django.conf.urls import url
from . import views
urlpatterns = [
url('^login$', views.user_login, name="login"),
]
from django.conf.urls import url,include
from django.contrib import admin
urlpatterns = [
url(r'^admin/', admin.site.urls),
url(r'^account/',include('account.urls')),
]
创建html文件
结构
templates/
account/
login.html
base.html
base.html文件
{% load staticfiles %}
<!DOCTYPE html>
<html>
<head>
<title>{% block title %}{% endblock %}</title>
<link href="{% static "css/base.css" %}" rel="stylesheet">
</head>
<body>
<div id="header">
<span class="logo">Bookmarks</span>
</div>
<div id="content">
{% block content %}
{% endblock %}
</div>
</body>
</html>
login.html文件
{% extends "base.html" %}
{% block title %}Log-in{% endblock %}
{% block content %}
<h1>Log-in</h1>
<p>Please, use the following form to log-in:</p>
<form action="." method="post">
{{ form.as_p }}
{% csrf_token %}
<p><input type="submit" value="Log-in"></p>
</form>
{% endblock %}
使用Django认证(authentication)视图(views)
Django在认证(authentication)框架中包含了一些开箱即用的表单(forms)和视图(views)。你之前创建的登录视图(view)是一个非常好的练习用来理解Django中的用户认证(authentication)过程。无论如何,你可以在大部分的案例中使用默认的Django认证(authentication)视图(views)。
Django提供以下视图(views)来处理认证(authentication):
-
login:操作表单(form)中的登录然后登录一个用户
-
logout:登出一个用户
-
logout_then_login:登出一个用户然后重定向这个用户到登录页面
-
Django提供以下视图(views)来操作密码修改:
-
password_change:操作一个表单(form)来修改用户密码
-
password_change_done:当用户成功修改他的密码后提供一个成功提示页面
Django还包含了以下视图(views)允许用户重置他们的密码: -
password_reset:允许用户重置他的密码。它会生成一条带有一个token的一次性使用链接然后发送到用户的邮箱中。
-
password_reset_done:告知用户已经发送了一封可以用来重置密码的邮件到他的邮箱中。
-
password_reset_complete:当用户重置完成他的密码后提供一个成功提示页面。
当你创建一个带有用户账号的网站时,以上的视图(views)可以帮你节省很多时间。你可以覆盖这些视图(views)使用的默认值,例如需要渲染的模板位置或者视图(view)需要使用到的表单(form)。
更多信息
(https://docs.djangoproject.com/en/1.8/topics/auth/default/#module-django.contrib.auth.views)
登录和登出视图(views)
from django.conf.urls import url
from . import views
from django.contrib.auth.views import login,logout,logout_then_login # 导入django自带的视图函数
urlpatterns = [
# url('^login/$', views.user_login, name="login"),
url('^login/$',login,name='login'),
url('^logout/$', logout, name='logout'),
url('^logout_then_login/$', logout_then_login, name='logout_then_login'),
]
在account应用中的template目录下创建一个新的目录命名为registration。这个路径是Django认证(authentication)视图(view)期望你的认证(authentication)模块(template)默认的存放路径。在这个新目录中创建一个新的文件,命名为login.htm
{% extends "base.html" %}
{% block title %}Log-in{% endblock %}
{% block content %}
<h1>Log-in</h1>
{% if form.errors %}
<p>
Your username and password didn't match.
Please try again.
</p>
{% else %}
<p>Please, use the following form to log-in:</p>
{% endif %}
<div class="login-form">
<form action="{% url 'login' %}" method="post">
{{ form.as_p }}
{% csrf_token %}
<input type="hidden" name="next" value="{{ next }}" />#隐藏标签,参数next
<p><input type="submit" value="Log-in"></p>
</form>
</div>
{% endblock %}
备注:在任何页面中,只要有登陆的<a>标签,比如<a href="{% url 'login' %}?next={{request.path}}",此时,url符合login urls匹配,交由login视图函数处理,同时传给视图函数next参数,login视图函数中,通过 redirect_to = request.POST.get('next', request.GET.get('next', ''))从get中或者post中获得next参数值。
一开始是GET方式,渲染表单,同时在form中添加了一个隐藏的input标签提供next参数,之后提供POST方式,同样交由login视图函数来处理,此时,从post中获得next参数,然后redirect(redirect_to)重定向到next这个页面!!!
我们添加了一个隐藏的HTML<input>元素来提交叫做next的变量值。当你在请求(request)中传递一个next参数(举个例子:http://127.0.0.1:8000/account/login/?next=/account/),这个变量是登录视图(view)首个设置的参数。
next参数必须是一个URL。当这个参数被给予的时候,Django登录视图(view)将会在用户登录完成后重定向到给予的URL。
logged_out.html
{% extends "base.html" %}
{% block title %}Logged out{% endblock %}
{% block content %}
<h1>Logged out</h1>
<p>You have been successfully logged out. You can <a href="{% url "login" %}">log-in again</a>.</p>
{% endblock %}
设置主页dashboard.html及base.html
<div id="header">
<span class="logo">Bookmarks</span>
{% if request.user.is_authenticated %}
<ul class="menu">
<li {% if section == "dashboard" %}class="selected"{% endif %}>
<a href="{% url "dashboard" %}">My dashboard</a>
</li>
<li {% if section == "images" %}class="selected"{% endif %}>
<a href="#">Images</a>
</li>
<li {% if section == "people" %}class="selected"{% endif %}>
<a href="#">People</a>
</li>
</ul>
{% endif %}
<span class="user">
{% if request.user.is_authenticated %}#如果已经登陆
Hello {{ request.user.first_name }},#显示登陆名
<a href="{% url "logout" %}">Logout</a>#显示登出连接
{% else %}#用户未登陆
<a href="{% url "login" %}">Log-in</a>#显示登陆连接
{% endif %}
</span>
</div>
{% extends "base.html" %}
{% block title %}Dashboard{% endblock %}
{% block content %}
<h1>Dashboard</h1>
<p>Welcome to your dashboard.</p>
{% endblock %}
urlpatterns = [
# ...
url(r'^$', views.dashboard, name='dashboard'),
]
settings中设置
from django.core.urlresolvers import reverse_lazy
LOGIN_REDIRECT_URL = reverse_lazy('dashboard')#告诉Django用户登录成功后如果contrib.auth.views.login视图(view)没有获取到next参数将会默认重定向到哪个UR
LOGIN_URL = reverse_lazy('login')#重定向用户登录的URL(例如:使用login_required装饰器(decorator))
LOGOUT_URL = reverse_lazy('logout')#重定向用户登出的URL。
我们使用reverse_lazy()来通过它们的名字动态构建URL。reverse_lazy()方法就像reverse()所做的一样reverses URLs,但是你可以通过使用这种方式在你项目的URL配置被读取之前进行reverse URLs。
修改密码视图(views)
urlpatterns设置
# change password urls
url(r'^password-change/$',
'django.contrib.auth.views.password_change',
name='password_change'),
url(r'^password-change/done/$',
'django.contrib.auth.views.password_change_done',
name='password_change_done'),
password_change_form.html是django自带的视图使用的html文件名
{% extends "base.html" %}
{% block title %}Change you password{% endblock %}
{% block content %}
<h1>Change you password</h1>
<p>Use the form below to change your password.</p>
<form action="." method="post">
{{ form.as_p }}
<p><input type="submit" value="Change"></p>
{% csrf_token %}
</form>
{% endblock %}
password_change_done.html
{% extends "base.html" %}
{% block title %}Password changed{% endblock %}
{% block content %}
<h1>Password changed</h1>
<p>Your password has been successfully changed.</p>
{% endblock %}
重置密码视图(views)
使用django.contrib.auth.views中的
password_reset,
password_reset_done,
password_reset_confirm,
password_reset_complete
# restore password urls
url(r'^password-reset/$',
'django.contrib.auth.views.password_reset',
name='password_reset'),
url(r'^password-reset/done/$',
'django.contrib.auth.views.password_reset_done',
name='password_reset_done'),
url(r'^password-reset/confirm/(?P<uidb64>[-\w]+)/(?P<token>[-\w]+)/$',
'django.contrib.auth.views.password_reset_confirm',
name='password_reset_confirm'),
url(r'^password-reset/complete/$',
'django.contrib.auth.views.password_reset_complete',
name='password_reset_complete'),
先编辑password_reset默认的2个html文件,template_name='registration/password_reset_form.html', email_template_name='registration/password_reset_email.html'
password_reset_form.html(视图函数会处理此html,同时,发送邮件以及reverse生成password_reset_done的url,生成url后由password_reset_done函数来处理)
{% extends "base.html" %}
{% block title %}Reset your password{% endblock %}
{% block content %}
<h1>Forgotten your password?</h1>
<p>Enter your e-mail address to obtain a new password.</p>
<form action="." method="post">
{{ form.as_p }} #邮件输入表单
<p><input type="submit" value="Send e-mail"></p>
{% csrf_token %}
</form>
{% endblock %}
password_reset_email.html
Someone asked for password reset for email {{ email }}. Follow the link below:
{{ protocol }}://{{ domain }}{% url "password_reset_confirm" uidb64=uid token=token %}
Your username, in case you've forgotten: {{ user.get_username }}
password_reset_done.html
{% extends "base.html" %}
{% block title %}Reset your password{% endblock %}
{% block content %}
<h1>Reset your password</h1>
<p>We've emailed you instructions for setting your password.</p>
<p>If you don't receive an email, please make sure you've entered the address you registered with.</p>
{% endblock %}
从收到邮件的连接url进入password_reset_confirm的html
{% extends "base.html" %}
{% block title %}Reset your password{% endblock %}
{% block content %}
<h1>Reset your password</h1>
{% if validlink %}
<p>Please enter your new password twice:</p>
<form action="." method="post">
{{ form.as_p }}
{% csrf_token %}
<p><input type="submit" value="Change my password" /></p>
</form>
{% else %}
<p>The password reset link was invalid, possibly because it has already been used. Please request a new password reset.</p>
{% endif %}
{% endblock %}
修改完密码后的password_reset_complete.html
{% extends "base.html" %}
{% block title %}Password reset{% endblock %}
{% block content %}
<h1>Password set</h1>
<p>Your password has been set. You can <a href="{% url "login" %}">log in now</a></p>
{% endblock %}
以上完成了重置密码的过程,别忘了在login中添加连接以及settings中设置发送邮件相关配置(第二章中记录)
学习源于夜夜月翻译的django by example
网友评论