django-allauth 教程（一）小试牛刀

前言：最近需要做毕业设计，搞一个基于Django的武汉选房网站，有点类似于安居客，链家之类，但是由于技术有限，搞不来大型网站。我第一次写博客，希望屏幕前的大佬多多指教！！

首先学习django-allauth, django-allauth是最受欢迎管理用户登录和注册的第三方安装包，GitHub地址：https://github.com/pennersr/django-allauth

1.创建一个Django项目：

新建一个数据库House_website_db，在setting.py输入

1DATABASES = {
2    'default': {
3        'ENGINE': 'django.db.backends.mysql', # 用的是Mysql数据库
4        'NAME': 'House_website_db',
5        'USER': '用户',
6        'PASSWORD': '密码噻',
7        'HOST': '127.0.0.1',
8    }
9}
10

2.django-allauth安装

在terminal中输入

1pip install django-allauth

安装好后在House_website/setting.py中，将allauth相关的APP加入到INSTALLED_APPS列表中，需要注意的是allauth对站点设置django.contrib.sites有依赖，必须也把它加入，同时设置SITE_ID=1,

1INSTALLED_APPS = [
2    'django.contrib.admin',
3    'django.contrib.auth',
4    'django.contrib.contenttypes',
5    'django.contrib.sessions',
6    'django.contrib.messages',
7    'django.contrib.staticfiles',
8    'django.contrib.sites',
9    'allauth',
10    'allauth.account',
11    'allauth.socialaccount',
12    'allauth.socialaccount.providers.github',
13]
14SITE_ID = 1

网站需要用户通过email或者用户名进行登录，因为我们需要进行邮箱验证和通过邮箱发送密码重置链接，所以很有必要设置电子邮箱。如果你没有邮件服务器，你可以设置成自己的QQ邮箱或者163邮箱，本地环境下一样可以使用，是不是很棒，我第一次做出来时就觉得diao。接下来我说说localhost环境下怎么配置QQ邮箱或163邮箱发送文件。首先在setting.py文件中输入

1# 基本设定
2ACCOUNT_AUTHENTICATION_METHOD = 'username_email'
3ACCOUNT_EMAIL_REQUIRED = True
4LOGIN_REDIRECT_URL = '/accounts/profile/'
5ACCOUNT_LOGOUT_REDIRECT_URL = "/accounts/login"  # 设置退出登录后跳转链接
6ACCOUNT_LOGIN_ON_EMAIL_CONFIRMATION = True  # 更改为True，用户一旦确认他们的电子邮件地址，就会自动登录
7ACCOUNT_LOGIN_ON_PASSWORD_RESET = True  # 更改为True，用户将在重置密码后自动登录
8ACCOUNT_USERNAME_BLACKLIST = []  # 用户不能使用的用户名列表
9
10AUTHENTICATION_BACKENDS = (
11    'django.contrib.auth.backends.ModelBackend',
12    'allauth.account.auth_backends.AuthenticationBackend',
13)
14
15# 邮箱设定
16EMAIL_HOST = 'smtp.163.com' # 如果你用的是QQ邮箱，就改成'smtp.qq.com'
17EMAIL_PORT = 25
18EMAIL_HOST_USER = 'xxxxx@163.com'  # 你的 qq邮箱或者163邮箱
19EMAIL_HOST_PASSWORD = 'xxxxxxxxxxxxx' # 你的授权码
20EMAIL_USE_TLS = True  # 这里必须是 True，否则发送不成功
21EMAIL_FROM = 'xxxxx@163.com'  # 你的 qq邮箱或者163邮箱
22DEFAULT_FROM_EMAIL = 'xxxx@163.com'  # 你的 qq邮箱或者163邮箱

当然基本设定还有好多：括号里的是默认设置

1ACCOUNT_AUTHENTICATION_METHOD (="username" | "email" | "username_email") 
2# 指定要使用的登录方法（用户名、电子邮件地址或两者之一）
3
4ACCOUNT_EMAIL_CONFIRMATION_EXPIRE_DAYS (=3)
5# 邮件确认邮件的截止日期(天数)
6
7ACCOUNT_EMAIL_VERIFICATION (="optional")
8# 注册中邮件验证方法:“强制（mandatory）”,“可选（optional）”或“否（none）”之一
9
10ACCOUNT_EMAIL_CONFIRMATION_COOLDOWN (=180)
11# 邮件发送后的冷却时间(以秒为单位)
12
13ACCOUNT_LOGIN_ATTEMPTS_LIMIT (=5) 
14# 登录尝试失败的次数
15
16ACCOUNT_LOGIN_ATTEMPTS_TIMEOUT (=300)
17# 从上次失败的登录尝试，用户被禁止尝试登录的持续时间
18
19ACCOUNT_LOGIN_ON_EMAIL_CONFIRMATION (=False)
20# 更改为True，用户一旦确认他们的电子邮件地址，就会自动登录
21
22ACCOUNT_LOGOUT_ON_PASSWORD_CHANGE (=False)
23# 更改或设置密码后是否自动退出
24
25ACCOUNT_LOGIN_ON_PASSWORD_RESET (=False)
26# 更改为True，用户将在重置密码后自动登录
27
28ACCOUNT_SESSION_REMEMBER (=None)
29# 控制会话的生命周期，可选项还有:False,True
30
31ACCOUNT_SIGNUP_EMAIL_ENTER_TWICE (=False)
32# 用户注册时是否需要输入邮箱两遍
33
34ACCOUNT_SIGNUP_PASSWORD_ENTER_TWICE (=True)
35# 用户注册时是否需要用户输入两遍密码
36
37ACCOUNT_USERNAME_BLACKLIST (=[])
38# 用户不能使用的用户名列表
39
40ACCOUNT_UNIQUE_EMAIL (=True)
41# 加强电子邮件地址的唯一性
42
43ACCOUNT_USERNAME_MIN_LENGTH (=1)
44# 用户名允许的最小长度的整数
45
46SOCIALACCOUNT_AUTO_SIGNUP (=True)
47# 使用从社会帐户提供者检索的字段(如用户名、邮件)来绕过注册表单
48
49LOGIN_REDIRECT_URL (="/") # 设置登录后跳转链接
50
51ACCOUNT_LOGOUT_REDIRECT_URL (="/") # 设置退出登录后跳转链接

3.接下来就是拿到授权码了

QQ邮箱授权码：

进入QQ邮箱网页，找到设置

163邮箱授权码：

进入网址：https://mail.163.com/ 找到设置，开启服务，拿到授权码之后将授权码写进setting.py里面。

4.查看效果

在House_website/urls.py配置url：

1from django.contrib import admin
2from django.urls import path, include
3
4urlpatterns = [
5    path('admin/', admin.site.urls),
6    path('accounts/', include('allauth.urls')),
7]

在Terminal输入以下命令：

1python manage.py makemigrations  # 生成映射文件
2# 这里会提示你需要安装mysqlclient库
3pip install mysqlclient
4python manage.py migrate  # 执行映射文件，创建数据表
5python manage.py runserver   # 运行服务

django-allauth的URLs及视图

下面是django_allauth所有内置的URLs，均可以访问的。

/accounts/login/（URL名account_login): 登录

/accounts/signup/ (URL名account_signup): 注册

/accounts/password/reset/(URL名: account_reset_password) ：重置密码

/accounts/logout/ (URL名account_logout): 退出登录

/accounts/password/set/ (URL名:account_set_password): 设置密码

/accounts/password/change/ (URL名: account_change_password): 改变密码（需登录）

/accounts/email/(URL名: account_email) 用户可以添加和移除email，并验证

/accounts/social/connections/（URL名:socialaccount_connections): 管理第三方账户

大伙有没有注意到没有/accounts/profile/ 这个url？如果我希望用户能提供更多信息怎么办？比如电话，QQ，年龄，性别，个性签名等等。那如果希望用户登陆后跳转到个人信息页面（UserProfile）,并允许用户修改个人信息怎么搞？因为每个开发者都有不同的需求，这就需要我们自己写了，django-allauth就没提供。

特别鸣谢：大江狗前辈 声明：我写博客只是记录自己的学习进度和总结并分享给大家，并不保证原创，如有引用您的博文，请您理解！