django-allauth 教程(一)小试牛刀

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

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

1.创建一个Django项目:

image 新建一个数据库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邮箱网页,找到设置

image

image

image

163邮箱授权码:

进入网址:https://mail.163.com/ 找到设置, image 开启服务, image 拿到授权码 之后将授权码写进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就没提供。

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

预览图
收藏
评论区
守株待兔
最新文章

导读