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

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

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

1.创建一个Django项目：

django-allauth 教程（一）小试牛刀新建一个数据库House_website_db，在setting.py输入

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql', # 用的是Mysql数据库
        'NAME': 'House_website_db',
        'USER': '用户',
        'PASSWORD': '密码噻',
        'HOST': '127.0.0.1',
    }
}

2.django-allauth安装

在terminal中输入

pip install django-allauth

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

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'django.contrib.sites',
    'allauth',
    'allauth.account',
    'allauth.socialaccount',
    'allauth.socialaccount.providers.github',
]
SITE_ID = 1

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

# 基本设定
ACCOUNT_AUTHENTICATION_METHOD = 'username_email'
ACCOUNT_EMAIL_REQUIRED = True
LOGIN_REDIRECT_URL = '/accounts/profile/'
ACCOUNT_LOGOUT_REDIRECT_URL = "/accounts/login"  # 设置退出登录后跳转链接
ACCOUNT_LOGIN_ON_EMAIL_CONFIRMATION = True  # 更改为True，用户一旦确认他们的电子邮件地址，就会自动登录
ACCOUNT_LOGIN_ON_PASSWORD_RESET = True  # 更改为True，用户将在重置密码后自动登录
ACCOUNT_USERNAME_BLACKLIST = []  # 用户不能使用的用户名列表

AUTHENTICATION_BACKENDS = (
    'django.contrib.auth.backends.ModelBackend',
    'allauth.account.auth_backends.AuthenticationBackend',
)

# 邮箱设定
EMAIL_HOST = 'smtp.163.com' # 如果你用的是QQ邮箱，就改成'smtp.qq.com'
EMAIL_PORT = 25
EMAIL_HOST_USER = 'xxxxx@163.com'  # 你的 qq邮箱或者163邮箱
EMAIL_HOST_PASSWORD = 'xxxxxxxxxxxxx' # 你的授权码
EMAIL_USE_TLS = True  # 这里必须是 True，否则发送不成功
EMAIL_FROM = 'xxxxx@163.com'  # 你的 qq邮箱或者163邮箱
DEFAULT_FROM_EMAIL = 'xxxx@163.com'  # 你的 qq邮箱或者163邮箱

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

ACCOUNT_AUTHENTICATION_METHOD (="username" | "email" | "username_email") 
# 指定要使用的登录方法（用户名、电子邮件地址或两者之一）

ACCOUNT_EMAIL_CONFIRMATION_EXPIRE_DAYS (=3)
# 邮件确认邮件的截止日期(天数)

ACCOUNT_EMAIL_VERIFICATION (="optional")
# 注册中邮件验证方法:“强制（mandatory）”,“可选（optional）”或“否（none）”之一

ACCOUNT_EMAIL_CONFIRMATION_COOLDOWN (=180)
# 邮件发送后的冷却时间(以秒为单位)

ACCOUNT_LOGIN_ATTEMPTS_LIMIT (=5) 
# 登录尝试失败的次数

ACCOUNT_LOGIN_ATTEMPTS_TIMEOUT (=300)
# 从上次失败的登录尝试，用户被禁止尝试登录的持续时间

ACCOUNT_LOGIN_ON_EMAIL_CONFIRMATION (=False)
# 更改为True，用户一旦确认他们的电子邮件地址，就会自动登录

ACCOUNT_LOGOUT_ON_PASSWORD_CHANGE (=False)
# 更改或设置密码后是否自动退出

ACCOUNT_LOGIN_ON_PASSWORD_RESET (=False)
# 更改为True，用户将在重置密码后自动登录

ACCOUNT_SESSION_REMEMBER (=None)
# 控制会话的生命周期，可选项还有:False,True

ACCOUNT_SIGNUP_EMAIL_ENTER_TWICE (=False)
# 用户注册时是否需要输入邮箱两遍

ACCOUNT_SIGNUP_PASSWORD_ENTER_TWICE (=True)
# 用户注册时是否需要用户输入两遍密码

ACCOUNT_USERNAME_BLACKLIST (=[])
# 用户不能使用的用户名列表

ACCOUNT_UNIQUE_EMAIL (=True)
# 加强电子邮件地址的唯一性

ACCOUNT_USERNAME_MIN_LENGTH (=1)
# 用户名允许的最小长度的整数

SOCIALACCOUNT_AUTO_SIGNUP (=True)
# 使用从社会帐户提供者检索的字段(如用户名、邮件)来绕过注册表单

LOGIN_REDIRECT_URL (="/") # 设置登录后跳转链接

ACCOUNT_LOGOUT_REDIRECT_URL (="/") # 设置退出登录后跳转链接

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

QQ邮箱授权码：

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

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

163邮箱授权码：

进入网址：https://mail.163.com/ 找到设置， django-allauth 教程（一）小试牛刀开启服务，拿到授权码之后将授权码写进setting.py里面。

4.查看效果

在House_website/urls.py配置url：

from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('accounts/', include('allauth.urls')),
]

在Terminal输入以下命令：

python manage.py makemigrations  # 生成映射文件
# 这里会提示你需要安装mysqlclient库
pip install mysqlclient
python manage.py migrate  # 执行映射文件，创建数据表
python 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就没提供。

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