Django+xadmin打造在线教育平台(二)
代码
三、xadmin后台管理
3.1.xadmin的安装
django2.0的安装(源码安装方式):
https://github.com/sshwsfc/xadmin/tree/django2
把zip文件放到pip目录下,运行下面命令安装:
pip install xadmin-django2
其它版本如果上面安装提示错误:
更换安装源(使用豆瓣源)
安装xadmin的命令如下:
pip install -i https://pypi.douban.com/simple xadmin-django2
安装成功后,同时也安装了很多依赖的包,后面也需要用到。
3.2.xadmin的设置
(1)新建Python Package "extra_apps",把源码xadmin文件夹放到extra_apps文件夹下面,此时目录结构如下:

(2)把extra_apps右键mark为Source Root并在settings中加入
sys.path.insert(0,os.path.join(BASE_DIR, ‘extra_apps‘))

(3)因为我们用源码的xadmin,所以要卸载之前安装的
pip uinstall xadmin
(4)配置路由
把admin改成xadmin
# urls.py
from django.urls import path
import xadmin
urlpatterns = [
path(‘xadmin/‘, xadmin.site.urls),
]
(5)注册app
把下面两个app注册到settings.py的INSTALLED_APPS中
‘xadmin‘, ‘crispy_forms‘
(6)重新生成数据库
python manage.py makemigrations python manage.py migrate
(7)设置成中文
LANGUAGE_CODE = ‘zh-hans‘ TIME_ZONE = ‘Asia/Shanghai‘ USE_I18N = True USE_L10N = True USE_TZ = False
(8)创建一个管理员用户
python manage.py createsuperuser
现在就可以运行了
python manage.py runserver
访问后台:http://127.0.0.1:8000/xadmin
可以看到成功进入管理界面

datetimefield报错问题解决:
当我们点增加用户信息,会报错

可以看到报的是xadmin/widgets中第80行
def render(self, name, value, attrs=None):
input_html = [ht for ht in super(AdminSplitDateTime, self).render(name, value, attrs).split(‘\n‘) if ht != ‘‘]
# return input_html
return mark_safe(‘<div class="datetime clearfix"><div class="input-group date bootstrap-datepicker"><span class="input-group-addon"><i class="fa fa-calendar"></i></span>%s‘
‘<span class="input-group-btn"><button class="btn btn-default" type="button">%s</button></span></div>‘
‘<div class="input-group time bootstrap-clockpicker"><span class="input-group-addon"><i class="fa fa-clock-o">‘
‘</i></span>%s<span class="input-group-btn"><button class="btn btn-default" type="button">%s</button></span></div></div>‘ % (input_html[0], _(u‘Today‘), input_html[1], _(u‘Now‘)))
上面贴出来的最后一行代码就是widgets.py的第80行代码。
可以看出这句代码是希望用“\n”把input_html里的两个标签拆开,但两个标签之间没有换行,所以没能拆分,导致报错。
input_html[1]就是报错的代码,因为input_html里只有一个元素。
解决办法:
既然“\n”不能拆分标签,那么就换一种拆分方式,使用“/><”拆分。
原代码:
input_html = [ht for ht in super(AdminSplitDateTime, self).render(name, value, attrs).split(‘\n‘) if ht != ‘‘]
修改后代码:
input_html = [ht for ht in super(AdminSplitDateTime, self).render(name, value, attrs).split(‘/><‘) if ht != ‘‘] input_html[0] = input_html[0] + "/>" input_html[1] = "<" + input_html[1]
再运行就正常了
3.3.users app的models注册
(1)在users下面创建adminx.py,代码如下:
# users/adminx.py
import xadmin
from .models import EmailVerifyRecord
#xadmin中这里是继承object,不再是继承admin
class EmailVerifyRecordAdmin(object):
pass
xadmin.site.register(EmailVerifyRecord,EmailVerifyRecordAdmin)
(2)完善功能,增加显示字段,搜索和过滤
修改users/adminx.py,代码如下:
# users/adminx.py
import xadmin
from .models import EmailVerifyRecord
#xadmin中这里是继承object,不再是继承admin
class EmailVerifyRecordAdmin(object):
# 显示的列
list_display = [‘code‘, ‘email‘, ‘send_type‘, ‘send_time‘]
# 搜索的字段,不要添加时间搜索
search_fields = [‘code‘, ‘email‘, ‘send_type‘]
# 过滤
list_filter = [‘code‘, ‘email‘, ‘send_type‘, ‘send_time‘]
xadmin.site.register(EmailVerifyRecord,EmailVerifyRecordAdmin)
刷新后的界面:

users中Banner也注册进去
class BannerAdmin(object):
list_display = [‘title‘, ‘image‘, ‘url‘,‘index‘, ‘add_time‘]
search_fields = [‘title‘, ‘image‘, ‘url‘,‘index‘]
list_filter = [‘title‘, ‘image‘, ‘url‘,‘index‘, ‘add_time‘]
xadmin.site.register(Banner,BannerAdmin)
1.4.剩余app model注册
(1)course
代码如下: 注意外键
# course/adminx.py import xadmin from .models import Course, Lesson, Video, CourseResource
class CourseAdmin(object): ‘‘‘课程‘‘‘ list_display = [ ‘name‘,‘desc‘,‘detail‘,‘degree‘,‘learn_times‘,‘students‘] search_fields = [‘name‘, ‘desc‘, ‘detail‘, ‘degree‘, ‘students‘] list_filter = [ ‘name‘,‘desc‘,‘detail‘,‘degree‘,‘learn_times‘,‘students‘] class LessonAdmin(object): ‘‘‘章节‘‘‘ list_display = [‘course‘, ‘name‘, ‘add_time‘] search_fields = [‘course‘, ‘name‘] #这里course__name是根据课程名称过滤 list_filter = [‘course__name‘, ‘name‘, ‘add_time‘] class VideoAdmin(object): ‘‘‘视频‘‘‘ list_display = [‘lesson‘, ‘name‘, ‘add_time‘] search_fields = [‘lesson‘, ‘name‘] list_filter = [‘lesson‘, ‘name‘, ‘add_time‘] class CourseResourceAdmin(object): ‘‘‘课程资源‘‘‘ list_display = [‘course‘, ‘name‘, ‘download‘, ‘add_time‘] search_fields = [‘course‘, ‘name‘, ‘download‘] list_filter = [‘course__name‘, ‘name‘, ‘download‘, ‘add_time‘] # 将管理器与model进行注册关联 xadmin.site.register(Course, CourseAdmin) xadmin.site.register(Lesson, LessonAdmin) xadmin.site.register(Video, VideoAdmin) xadmin.site.register(CourseResource, CourseResourceAdmin)
(2)organizations
代码如下:
# organization/adminx.py
import xadmin
from .models import CityDict, CourseOrg, Teacher
class CityDictAdmin(object):
‘‘‘城市‘‘‘
list_display = [‘name‘, ‘desc‘, ‘add_time‘]
search_fields = [‘name‘, ‘desc‘]
list_filter = [‘name‘, ‘desc‘, ‘add_time‘]
class CourseOrgAdmin(object):
‘‘‘机构‘‘‘
list_display = [‘name‘, ‘desc‘, ‘click_nums‘, ‘fav_nums‘,‘add_time‘ ]
search_fields = [‘name‘, ‘desc‘, ‘click_nums‘, ‘fav_nums‘]
list_filter = [‘name‘, ‘desc‘, ‘click_nums‘, ‘fav_nums‘,‘city__name‘,‘address‘,‘add_time‘]
class TeacherAdmin(object):
‘‘‘老师‘‘‘
list_display = [ ‘name‘,‘org‘, ‘work_years‘, ‘work_company‘,‘add_time‘]
search_fields = [‘org‘, ‘name‘, ‘work_years‘, ‘work_company‘]
list_filter = [‘org__name‘, ‘name‘, ‘work_years‘, ‘work_company‘,‘click_nums‘, ‘fav_nums‘, ‘add_time‘]
xadmin.site.register(CityDict, CityDictAdmin)
xadmin.site.register(CourseOrg, CourseOrgAdmin)
xadmin.site.register(Teacher, TeacherAdmin)
(3)operation
代码如下:
# operation/adminx.py
import xadmin
from .models import UserAsk, UserCourse, UserMessage, CourseComments, UserFavorite
class UserAskAdmin(object):
‘‘‘用户表单我要学习‘‘‘
list_display = [‘name‘, ‘mobile‘, ‘course_name‘, ‘add_time‘]
search_fields = [‘name‘, ‘mobile‘, ‘course_name‘]
list_filter = [‘name‘, ‘mobile‘, ‘course_name‘, ‘add_time‘]
#
class UserCourseAdmin(object):
‘‘‘用户课程学习‘‘‘
list_display = [‘user‘, ‘course‘, ‘add_time‘]
search_fields = [‘user‘, ‘course‘]
list_filter = [‘user‘, ‘course‘, ‘add_time‘]
class UserMessageAdmin(object):
‘‘‘用户消息后台‘‘‘
list_display = [‘user‘, ‘message‘, ‘has_read‘, ‘add_time‘]
search_fields = [‘user‘, ‘message‘, ‘has_read‘]
list_filter = [‘user‘, ‘message‘, ‘has_read‘, ‘add_time‘]
class CourseCommentsAdmin(object):
‘‘‘用户评论后台‘‘‘
list_display = [‘user‘, ‘course‘, ‘comments‘, ‘add_time‘]
search_fields = [‘user‘, ‘course‘, ‘comments‘]
list_filter = [‘user‘, ‘course‘, ‘comments‘, ‘add_time‘]
class UserFavoriteAdmin(object):
‘‘‘用户收藏后台‘‘‘
list_display = [‘user‘, ‘fav_id‘, ‘fav_type‘, ‘add_time‘]
search_fields = [‘user‘, ‘fav_id‘, ‘fav_type‘]
list_filter = [‘user‘, ‘fav_id‘, ‘fav_type‘, ‘add_time‘]
# 将后台管理器与models进行关联注册。
xadmin.site.register(UserAsk, UserAskAdmin)
xadmin.site.register(UserCourse, UserCourseAdmin)
xadmin.site.register(UserMessage, UserMessageAdmin)
xadmin.site.register(CourseComments, CourseCommentsAdmin)
xadmin.site.register(UserFavorite, UserFavoriteAdmin)
全部代码:
users/adminx.py
course/adminx.py
organization/adminx.py
operation/adminx.py此时项目目录结构:

运行项目,进后台管理界面如下:

1.5.xadmin的全局配置
将全局配置修改:
- 如左上角:django Xadmin。下面的我的公司
- 主题修改,app名称汉化,菜单收叠。
使用Xadmin的主题功能。
把全站的配置放在users\adminx.py中:
(1)添加主题功能
from xadmin import views
# 创建xadmin的最基本管理器配置,并与view绑定
class BaseSetting(object):
# 开启主题功能
enable_themes = True
use_bootswatch = True
# 将基本配置管理与view绑定
xadmin.site.register(views.BaseAdminView,BaseSetting)
没添加主题前,右上角界面

添加主题后,可以选择自己喜欢的主题

(2)全局配置
修改django admin 和下面的我的公司收起菜单
# 全局修改,固定写法
class GlobalSettings(object):
# 修改title
site_title = ‘NBA后台管理界面‘
# 修改footer
site_footer = ‘科比的公司‘
# 收起菜单
menu_style = ‘accordion‘
# 将title和footer信息进行注册
xadmin.site.register(views.CommAdminView,GlobalSettings)
users/adminx.py全部代码再进后台的界面,如下:

(3)修改app的名字
在apps.py里面配置app的显示名称
以users/apps.py为例,其它三个同样操作
默认apps.py里面的代码
from django.apps import AppConfig
class UsersConfig(AppConfig):
name = ‘users‘
修改后:
from django.apps import AppConfig
class UsersConfig(AppConfig):
name = ‘users‘
还要在users/__init__.py中引用apps.py的配置
添加代码如下:
# users/__init__.py default_app_config = ‘users.apps.UsersConfig‘
其它三个app也同样方法改成显示中文
大功告成

四、完成登录功能
4.1.首页和登录页面的配置
(1)把html文件中index.html拷贝到templates文件夹内
(2)新建static目录用来存放静态文件
在settings.py中设置路径
STATICFILES_DIRS = (
os.path.join(BASE_DIR,‘static‘),
)

(3)引用静态文件
使用ctrl+f查找出所有“../”, 然后ctrl+r 全部替换为“/static/”

(4)配置静态文件的url
MxOnline/urls.py中
# MxOnline/urls.py
import xadmin
from django.urls import path
from django.views.generic import TemplateView
urlpatterns = [
path(‘xadmin/‘, xadmin.site.urls),
path(‘‘, TemplateView.as_view(template_name=‘index.html‘),name=‘index‘),
]
(5)登录页面
把login.html拷贝到templates文件夹下
使用ctrl+f查找出所有“../”, 然后ctrl+r 全部替换为“/static/”
配置login的url
# MxOnline/urls.py
urlpatterns = [
path(‘xadmin/‘, xadmin.site.urls),
path(‘‘, TemplateView.as_view(template_name=‘index.html‘),name=‘index‘),
path(‘login/‘, TemplateView.as_view(template_name=‘login.html‘),name=‘login‘),
]
更改index.html里面跳转到登录界面的url
原始样子
<!-- <a style="color:white" class="fr registerbtn" href="register.html">注册</a> -->
<!-- <a style="color:white" class="fr loginbtn" href="login.html">登录</a> -->
取消注释,将login.html改为“login/”
<a style="color:white" class="fr registerbtn" href="register.html">注册</a> <a style="color:white" class="fr loginbtn" href="/login/">登录</a>
现在可以访问index页面,然后点‘’登录”,跳转到登录页面了
4.2.用户登录
(1)修改login的路由
from django.views.generic import TemplateView
from users import views
urlpatterns = [
path(‘xadmin/‘, xadmin.site.urls),
path(‘‘, TemplateView.as_view(template_name=‘index.html‘),name=‘index‘),
path(‘login/‘,views.user_login,name = ‘login‘), #修改login路由
]
(2)写login的视图
from django.shortcuts import render
from django.contrib.auth import authenticate,login
def user_login(request):
if request.method == ‘POST‘:
# 获取用户提交的用户名和密码
user_name = request.POST.get(‘username‘,None)
pass_word = request.POST.get(‘password‘,None)
# 成功返回user对象,失败None
user = authenticate(username=user_name,password=pass_word)
# 如果不是null说明验证成功
if user is not None:
# 登录
login(request,user)
return render(request,‘index.html‘)
else:
return render(request,‘login.html‘,{‘msg‘:‘用户名或密码错误‘})
elif request.method == ‘GET‘:
return render(request,‘login.html‘)
(3)更改login.html
login.html
如果用户登录错误,应该有提示错误信息,下面代码:
<div class="error btns login-form-tips" id="jsLoginTips">{{ msg }}</div>

(4)修改index.html
原始index.html的代码
<div class=" header">
<div class="top">
<div class="wp">
<div class="fl"><p>服务电话:<b>33333333</b></p></div>
<!--登录后跳转-->
<a style="color:white" class="fr registerbtn" href="register.html">注册</a>
<a style="color:white" class="fr loginbtn" href="/login/">登录</a>
<div class="personal">
<dl class="user fr">
<dd>bobby<img class="down fr" src="/static/images/top_down.png"/></dd>
<dt><img width="20" height="20" src="/static/media/image/2016/12/default_big_14.png"/></dt>
</dl>
<div class="userdetail">
<dl>
<dt><img width="80" height="80" src="/static/media/image/2016/12/default_big_14.png"/></dt>
<dd>
<h2>django</h2>
<p>bobby</p>
</dd>
</dl>
<div class="btn">
<a class="personcenter fl" href="usercenter-info.html">进入个人中心</a>
<a class="fr" href="/logout/">退出</a>
</div>
</div>
</div>
</div>
</div>
我们应该做个验证,当用户已登录状态的时候,显示用户姓名和图像及其个人中心信息
如果没有登录,则显示登录和注册
更改代码如下:

index.html(5)增加邮箱登录
让用户可以通过邮箱或者用户名都可以登录,用自定义authenticate方法
这里是继承ModelBackend类来做的验证
ModelBackend源码from django.contrib.auth.backends import ModelBackend
from .models import UserProfile
from django.db.models import Q
#邮箱和用户名都可以登录
# 基础ModelBackend类,因为它有authenticate方法
class CustomBackend(ModelBackend):
def authenticate(self, request, username=None, password=None, **kwargs):
try:
# 不希望用户存在两个,get只能有一个。两个是get失败的一种原因 Q为使用并集查询
user = UserProfile.objects.get(Q(username=username)|Q(email=username))
# django的后台中密码加密:所以不能password==password
# UserProfile继承的AbstractUser中有def check_password(self, raw_password):
if user.check_password(password):
return user
except Exception as e:
return None
users/views.pyMxOnline/settings.py添加如下代码:
AUTHENTICATION_BACKENDS = (
‘users.views.CustomBackend‘,
)
然后通过邮箱也可以实现登录了
4.3.用form实现登录
(1)把前面views中的user_login()函数改成基于类的形式
from django.views.generic.base import View
class LoginView(View):
def get(self,request):
return render(request, ‘login.html‘)
def post(self,request):
# 获取用户提交的用户名和密码
user_name = request.POST.get(‘username‘, None)
pass_word = request.POST.get(‘password‘, None)
# 成功返回user对象,失败None
user = authenticate(username=user_name, password=pass_word)
# 如果不是null说明验证成功
if user is not None:
# 登录
login(request, user)
return render(request, ‘index.html‘)
else:
return render(request, ‘login.html‘, {‘msg‘: ‘用户名或密码错误‘})
继承的View类
View类源码参考基于类的urls配置
from users.views import LoginView path(‘login/‘,LoginView.as_view(),name = ‘login‘),
(2)users下新建form.py文件
代码如下:
# users/forms.py
from django import forms
# 登录表单验证
class LoginForm(forms.Form):
# 用户名密码不能为空
username = forms.CharField(required=True)
password = forms.CharField(required=True,min_length=5)
(3)定义好forms后利用它来做验证,并完善错误提示信息
from .forms import LoginForm
class LoginView(View):
def get(self,request):
return render(request, ‘login.html‘)
def post(self,request):
# 实例化
login_form = LoginForm(request.POST)
if login_form.is_valid():
# 获取用户提交的用户名和密码
user_name = request.POST.get(‘username‘, None)
pass_word = request.POST.get(‘password‘, None)
# 成功返回user对象,失败None
user = authenticate(username=user_name, password=pass_word)
# 如果不是null说明验证成功
if user is not None:
# 登录
login(request, user)
return render(request, ‘index.html‘)
# 只有当用户名或密码不存在时,才返回错误信息到前端
else:
return render(request, ‘login.html‘, {‘msg‘: ‘用户名或密码错误‘,‘login_form‘:login_form})
# form.is_valid()已经判断不合法了,所以这里不需要再返回错误信息到前端了
else:
return render(request,‘login.html‘,{‘login_form‘:login_form})
views.py(4)完善login.html的错误提示信息
<div class="form-group marb20 {% if login_form.errors.username %}errorput{% endif %}">
<label>用 户 名</label>
<input name="username" id="account_l" type="text" placeholder="手机号/邮箱" />
</div>
<div class="form-group marb8 {% if login_form.errors.username %}errorput{% endif %}">
<label>密 码</label>
<input name="password" id="password_l" type="password" placeholder="请输入您的密码" />
</div>
<div class="error btns login-form-tips" id="jsLoginTips">
{% for key,error in login_form.errors.items %}
{{ error }}
{% endfor %}
{{ msg }}
</div>
主要修改两处

login.html显示效果,当不输入用户名,密码小与五位数的时候的提示信息如下:

