（项目）在线教育平台（二）

四、xadmin后台管理系统

1、xadmin安装

　　首先在该网址下载xadmin的源码包：https://github.com/sshwsfc/xadmin/tree/django2

　　下载完成之后，将该安装包放在项目目录下进行安装：pip install xadmin-django2.zip

　　这时它会安装许多xadmin相关的依赖包，然后在项目根目录下新建包extra_apps，将下载好的xadmin源码解压，将里面的xadmin文件拷贝到该包下，我们是用源码安装的方式，需要将xadmin卸载：pip uninstall xadmin

　　我们使用的是源码的方式，需要将xadmin和crispy_forms配置进setting.py中的INSTALLED_APPS中：

INSTALLED_APPS = [
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'django.contrib.admin',
    'users',
    'course',
    'organization',
    'operation',
    'xadmin',
    'crispy_forms'
]

　　将extra_apps包Mark成Source Root，并在settings.py中进行配置：

import os
import sys

# Build paths inside the project like this: os.path.join(BASE_DIR, ...)
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
sys.path.insert(0, os.path.join(BASE_DIR, 'apps'))
sys.path.insert(0, os.path.join(BASE_DIR, 'extra_apps'))

　　然后配置xadmin的路由，在MxOnline/urls.py文件中配置路由：

import xadmin

urlpatterns = [
    path('xadmin/', xadmin.site.urls),
]

　　然后就可以进行迁移数据库，生成xadmin后台管理所需的表，注意，如果提示RuntimeError，需要在INSTALLED_APPS中配置django.contrib.admin。

　　现在就可以使用xadmin后台管理系统了，不过要先创建一个管理员用户，打开Run manage.py Task，运行createsuperuser创建管理员用户：

　　创建好之后就可以登录后台管理系统了：http://127.0.0.1:8000/xadmin/

　　右侧都是英文，我们需要设置成中文显示，在settings.py文件中进行配置：

LANGUAGE_CODE = 'zh-hans'

TIME_ZONE = 'Asia/Shanghai'

USE_I18N = True

USE_L10N = True

USE_TZ = False

2、models注册

　　现在需要将我们设计好的每个models中的表注册进后台管理系统中，以实现数据的增删改查。

2.1 user的model注册

　　在users下面创建adminx.py文件，在该文件下编写注册代码：

import xadmin

from users.models import EmailVerifyRecord, Banner


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)


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)

　　刷新页面之后，左侧导航栏出现了邮箱验证码和轮播图的选项，还有自己设置的显示列表选项，筛选选项，搜索选项，界面显示如下： 

2.2 course的model注册

　　在course下面创建adminx.py文件，在该文件下编写注册代码：

import xadmin

from .models import Course, Lesson, Video, CourseResourse

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']

xadmin.site.register(Course, CourseAdmin)


class LessonAdmin(object):
    list_display = ['course', 'name', 'add_time']
    search_fields = ['course', 'name']
    # course__name是根据课程名称进行过滤
    list_filter = ['course__name', 'name', 'add_time']

xadmin.site.register(Lesson, LessonAdmin)


class VideoAdmin(object):
    list_display = ['lesson', 'name', 'add_time']
    search_fields = ['lesson', 'name']
    list_filter = ['lesson', 'name', 'add_time']

xadmin.site.register(Video, VideoAdmin)


class CourseResourseAdmin(object):
    list_display = ['course', 'name', 'download', 'add_time']
    search_fields = ['course', 'name', 'download']
    list_filter = ['course__name', 'name', 'download', 'add_time']

xadmin.site.register(CourseResourse, CourseResourseAdmin)

2.3 organization的model注册

　　在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']

xadmin.site.register(CityDict, CityDictAdmin)


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']

xadmin.site.register(CourseOrg, CourseOrgAdmin)


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(Teacher, TeacherAdmin)

2.4 operation的model注册

　　在operation下面创建adminx.py文件，在该文件下编写注册代码：

import xadmin

from .models import UserAsk, UserMessage, CourseComments, UserCourse, 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']

xadmin.site.register(UserAsk, UserAskAdmin)


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']

xadmin.site.register(UserMessage, UserMessageAdmin)


class CourseCommentsAdmin(object):
    list_display = ['user', 'course', 'comments', 'add_time']
    search_fields = ['user', 'course', 'comments']
    list_filter = ['user', 'course', 'comments', 'add_time']

xadmin.site.register(CourseComments, CourseCommentsAdmin)


class UserCourseAdmin(object):
    list_display = ['user', 'course', 'add_time']
    search_fields = ['user', 'course']
    list_filter = ['user', 'course', 'add_time']

xadmin.site.register(UserCourse, UserCourseAdmin)


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']

xadmin.site.register(UserFavorite, UserFavoriteAdmin)

　　至此，后台管理中所有的model注册完毕，界面显示如下：

3、xadmin的全局配置

　　修改左上角的显示标题，还有最底部的我的公司，主题功能，app名称汉化、左侧菜单收叠，这些修改的配置都写进users/adminx.py文件中：

3.1 主题功能

from xadmin import views

class BaseSetting(object):
    """主题配置"""
    enable_themes = True
    use_bootswatch = True

xadmin.site.register(views.BaseAdminView, BaseSetting)

　　配置之后，后台管理界面的右上角出现了主题，可以进行主题更换：

3.2 logo、底部我的公司，菜单收叠

class GlobalSetting(object):
    """ logo、底部我的公司，菜单收叠配置"""
    # logo
    site_title = '知能网在线教育后台管理'
    # 我的公司
    site_footer = '知能网'
    # 菜单收叠
    menu_style = 'accordion'

xadmin.site.register(views.CommAdminView, GlobalSetting)

　　刷新页面之后，修改的地方如下：

3.3 app名称汉化

　　修改每个模块中的app.py文件，以users/apps.py为例，在文件中添加verbose_name = '用户'，修改内容如下：

from django.apps import AppConfig


class UsersConfig(AppConfig):
    name = 'users'
    verbose_name = '用户管理'

　　然后在__init__.py文件中引用app.py文件中的配置：

default_app_config = 'users.apps.UsersConfig'

　　然后依次修改其他模块中的内容，最后修改完，界面显示如下：