xadmin使用

Django admin介绍

后台管理系统特点:

• 权限管理
• 少前端样式(样式一般不是很看重)
• 快速开发

django的后台管理系统是一套智能的管理系统
django的杀手锏之一就是admin管理系统

admin在项目新建的时候已经为我们生成好了

 

访问:http://127.0.0.1:8000/admin/
可以看到admin登录窗口
Django是不会自动生成admin的用户的,需要我们使用命令去生成.

createsuperuser
进入 manage.py Task

createsuperuser

输入账号密码登录即可

 

xadmin 的使用

源码安装:

点我下载源码

• 新建extra_apps python包,并在settings中注册

使用该目录存放我们的第三方插件,将Xadmin移入
右键mark为SourceRoot,但是这个时候cmd下会报错

所以在settings.py中加入

sys.path.insert(0,os.path.join(BASE_DIR,'extra_apps'))

• 安装必要的包

pip install future
pip install six
pip install httplib2
pip install django-import-export

日志记录:后台管理人员的操作都会生成一条记录

源码安装的优点:

• xadmin新特性
• 对于源码进行自己的修改

将urls中默认的admin指向Xadmin

# 导入x admin，替换admin
import xadmin
urlpatterns = [
    url(r'^xadmin/', xadmin.site.urls),
]

注意:

配置完之后记得更新数据库表.makemigrations migrate

然后访问 http://127.0.0.1:8000/xadmin/

登录就可以得到如下界面

 

注意xadmin会自动的为我们添加UserProfile的管理,不用我们注册,而其他的需要在adminx中注册

日志记录:

后台管理人员做的操作会自动生成一条记录

源码安装的优点:

• xadmin的新特性
• 对于源码进行自己的修改

xadmin中对其他的数据模块进行注册管理

我们的UserProfile已经被注册进去了,我们从验证码开始注册.
我们需要新建一个adminx.py文件,Xadmin会自动搜索这种命名的文件

新建users/adminx.py:

# encoding:utf-8
__author__ = 'Fioman'
__date__ = '2018/11/15 16:37'

import xadmin

from .models import EmailVerifyRecord

# 创建admin的管理类,这里不再继承自admin,而是object
class EmailVerifyRecordAdmin(object):
    pass

xadmin.site.register(EmailVerifyRecord,EmailVerifyRecordAdmin)

在后台界面会显示如下的界面,添加完之后.

后台的显示列

这里是所有的这个表的列都会在这里显示,如果想要指定显示,可以在models.py中编写.

class EmailVerifyRecordAdmin(object):
    # 配置后台我们需要显示的列
    list_display = ['code', 'email','send_type', 'send_time']

list_display可以使用列表和元组,建议使用列表.否则元组只有一个元素,忘记加逗号就会报错.

• 类似于下面的这种选择框的生成,是因为我们使用了choices字段.

   

  

SEND_CHOICES = (
        ('register', '注册'),
        ('forget', '找回密码'),
        ('update_email', '修改邮箱'),

    )
    send_type = models.CharField(choices=SEND_CHOICES, max_length=20, verbose_name='验证码类型')

为后台增加搜索功能searchfields

users.py/adminx.py的管理器中EmailVerifyRecordAdmin添加

    search_fields = ['code', 'email', 'send_type'] # 时间不做搜索

后台添加一条数据,然后就可以实现搜索功能

给后台添加一个过滤功能,可以通过这个过滤器来筛选出要显示的数据

# 配置筛选字段
list_filter =   ['code','email','send_type','send_time']

可以看到如图所示

Django的admin,Xadmin和其他系统的区别

不像php等其他语言是一个功能模块一个功能设计的.
Django是对于每张表增删改查的管理器,我们可以在增删改查的基础上加上我们自己的后台逻辑
因此某种程度上可以说他是不依赖于具体业务的.不管啥系统后台都是由表组成.

不依赖于后台逻辑,又可以加上逻辑.

users/adminx.py中注册Banner的管理类,将Banner和管理类进行关联.

# 创建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']
# 将model与admin管理器进行关联注册
xadmin.site.register(Banner, BannerAdmin)

此时后台的页面

 

---

创建courses/adminx.py文件,注册相关的model类

# encoding:utf-8
__author__ = 'Fioman'
__date__ = '2018/11/15 19:35'

from .models import *
import xadmin


# Course的admin管理器
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']
    # __name代表使用外键中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']


xadmin.site.register(Course, CourseAdmin)
xadmin.site.register(Lesson, LessonAdmin)
xadmin.site.register(Video, VideoAdmin)
xadmin.site.register(ResourceCourse, CourseResourceAdmin)

界面如下:

注册机构的app的adminx

新建organization/adminx.py

# encoding:utf-8
__author__ = 'Fioman'
__date__ = '2018/11/15 19:54'

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


# org__name 表示的外键对象的名称.org是外键对象,取他的名字即可.
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)

注册operation app的xadmin

# encoding:utf-8
__author__ = 'Fioman'
__date__ = '2018/11/15 19:58'

import xadmin
from .models import *


# 用户表单我要学习后台管理器
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)

xadmin的全局配置

将全局配置修改:

• 左上角:django xadmin. 下面我的公司
• 主题修改,app汉化名称,菜单收叠

使用Xadmin的主题功能

把全站的配置放在user\admin.py中:

# X admin的全局配置信息设置
class BaseSetting(object):
    # 主题功能开启
    enable_themes = True
    use_bootswatch = True

# 将xadmin全局管理器与我们的view绑定注册
xadmin.site.register(views.BaseAdminView, BaseSetting)

这里的作用是配置主题功能,配置完之后后台页面上会多出如下功能:

通过这里可以更改后台的主题,改成自己喜欢的风格.

修改django admin 和下面的我的公司收起菜单

# x admin 全局配置参数信息设置
class GlobalSettings(object):
    site_title = '慕学网后台管理站'
    site_footer = 'fioman mooc'
    # 收起菜单
    menu_style = 'accordion'

# 将头部与脚部信息进行注册
xadmin.site.register(views.CommAdminView, GlobalSettings)

apps.py配置app的显示名称,目前后台显示的是英文.

每个app下执行同样的操作: 现在users/apps.py中添加如下代码

from django.apps import AppConfig


class UsersConfig(AppConfig):
    name = 'users'
    verbose_name = '用户' # users app 在后台展示的名称

注意自行跟其他的app添加中文名

新建app时并没有引用apps的配置

在对应的app下的init.py中添加

default_app_config = "users.apps.UsersConfig"

然后按照所有的方法替换掉之后,得到如下界面

自定义导航菜单顺序

class GlobalSetting(object):
     def get_site_menu(self):
        return (
            {'title': '课程管理', 'menus': (
                {'title': '课程信息', 'url': self.get_model_url(Course, 'changelist')},
                {'title': '章节信息', 'url': self.get_model_url(Lesson, 'changelist')},
                {'title': '视频信息', 'url': self.get_model_url(Video, 'changelist')},
                {'title': '课程资源', 'url': self.get_model_url(CourseResource, 'changelist')},
                {'title': '课程评论', 'url': self.get_model_url(CourseComments, 'changelist')},
            )},
            {'title': '机构管理', 'menus': (
                {'title': '所在城市', 'url': self.get_model_url(CityDict, 'changelist')},
                {'title': '机构讲师', 'url': self.get_model_url(Teacher, 'changelist')},
                {'title': '机构信息', 'url': self.get_model_url(CourseOrg, 'changelist')},
            )},
            {'title': '用户管理', 'menus': (
                {'title': '用户信息', 'url': self.get_model_url(UserProfile, 'changelist')},
                {'title': '用户验证', 'url': self.get_model_url(EmailVerifyRecord, 'changelist')},
                {'title': '用户课程', 'url': self.get_model_url(UserCourse, 'changelist')},
                {'title': '用户收藏', 'url': self.get_model_url(UserFavorite, 'changelist')},
                {'title': '用户消息', 'url': self.get_model_url(UserMessage, 'changelist')},
            )},


            {'title': '系统管理', 'menus': (
                {'title': '用户咨询', 'url': self.get_model_url(UserAsk, 'changelist')},
                {'title': '首页轮播', 'url': self.get_model_url(Banner, 'changelist')},
                {'title': '用户分组', 'url': self.get_model_url(Group, 'changelist')},
                {'title': '用户权限', 'url': self.get_model_url(Permission, 'changelist')},
                {'title': '日志记录', 'url': self.get_model_url(Log, 'changelist')},
            )},

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

作者：天涯明月笙
链接：https://www.jianshu.com/p/ca383f0cc933
來源：简书
简书著作权归作者所有，任何形式的转载都请联系作者获得授权并注明出处。

最后得到的界面如下:

写的很好，值得一看

作者：莫辜负自己的一世韶光
链接：https://www.jianshu.com/p/bcf33242477a
来源：简书
简书著作权归作者所有，任何形式的转载都请联系作者获得授权并注明出处。