第13章 xadmin的进阶开发

慕课网《强力django+杀手级xadmin 打造上线标准的在线教育平台》 学习笔记

---

本章主要内容：

• 介绍xadmin更进阶的开发， 加深对xadmin的理解， 让整个后台管理系统完成更加细节的定制， 包括：
  
  1. userprofile的注册、
  2. 导航栏icon的修改 、
  3. django ueditor富文本编辑器的集成、
  4. xadmin的插件制作
  5. 本章会介绍一款excel的导入插件开发

---

卸载原来的User，注册UserProfile代替

from xadmin.plugins.auth import UserAdmin
from django.contrib.auth.models import User

xadmin.site.unregister(User)
xadmin.site.register(UserProfile, UserProfileAdmin)

或者在 xadmin.plugins.auth 中加入：

from django.contrib.auth import get_user_model
User = get_user_model()

同时，由于我们用UserProfile 替换了原来的User，所以还有一些地方需要修改，在 xadmin.plugins.auth最下面，将

site.register_view(r'^auth/user/(.+)/password/$',
                   ChangePasswordView, name='user_change_password')

修改为：

site.register_view(r'^users/userprofile/(.+)/password/$',
                   ChangePasswordView, name='user_change_password')

布局，定制

class UserAdmin(object):
    change_user_password_template = None
    list_display = ('username', 'email', 'first_name', 'last_name', 'is_staff')
    list_filter = ('is_staff', 'is_superuser', 'is_active')
    search_fields = ('username', 'first_name', 'last_name', 'email')
    ordering = ('username',)
    style_fields = {'user_permissions': 'm2m_transfer'}
    model_icon = 'fa fa-user'

    def get_form_layout(self):
        if self.org_obj:
            self.form_layout = (
                Main(
                    Fieldset('',
                             'username', 'password',
                             css_class='unsort no_title'
                             ),
                    Fieldset(_('Personal info'),
                             Row('first_name', 'last_name'),
                             'email'
                             ),
                    Fieldset(_('Permissions'),
                             'groups', 'user_permissions'
                             ),
                    Fieldset(_('Important dates'),
                             'last_login', 'date_joined'
                             ),
                ),
                Side(
                    Fieldset(_('Status'),
                             'is_active', 'is_staff', 'is_superuser',
                             ),
                )
            )
        return super(UserAdmin, self).get_form_layout()

权限的使用

Django默认为每一张表生成四种权限：增删改查

• 用户拥有什么权限，就只能看到相应权限的界面

权限组

可以为组添加一些权限，然后再将用户加到组里
最终用户的权限为：所在组的所有权限 + 自己额外的权限

更改图标

图标是通过 model_icon 来配置的，可选的图标参考font awesome

font awesome : http://fontawesome.dashgame.com/

可以下载最新的awesome文件替换掉xadmin中的

　显示的排序

设置按照某些列进行排序显示
通过 ordering 来配置

• 同时， readonly_fields 配置的字段 为 只读，不可编辑
• exclude 的字段 则不会显示在编辑页面

• readonly_fields 和 exclude 是冲突的，配置了 readonly_fields ，则exclude 是无效的

• 外键可以设置为搜索的模式

inlineAdmin 嵌套编辑

class LessonInline(object):
    model = Lesson
    extra = 0

class CourseResourceInline(object):
    model = CourseResource
    extra = 0

class CourseAdmin(object):
    ……
    inlines = [LessonInline, CourseResourceInline]

这样就可以在编辑Course的时候同时对Lesson 和CourseResource 进行 增删查改

两个管理器管理一张数据表

在model.py中新增一个类，继承Course
proxy必须为True，这样Django就不会为BannerCourse新增一张数据表，而是和Course共用一张数据表

class BannerCourse(Course):
    class Meta:
        verbose_name = "轮播课程"
        verbose_name_plural = verbose_name
        proxy = True

为它新增一个管理器
这里需要重载 queryset 方法进行过滤，这样就可以显示过滤后的数据

class BannerCourseAdmin(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']
    ordering = ['-click_nums']
    readonly_fields = ['click_nums']
    exclude = ['fav_nums']
    inlines = [LessonInline, CourseResourceInline]

    def queryset(self):
        qs = super(BannerCourseAdmin, self).queryset()
        qs = qs.filter(is_banner=True) # 过滤
        return qs

而原来的Course的管理器也进行过滤

    def queryset(self):
        qs = super(CourseAdmin, self).queryset()
        qs = qs.filter(is_banner=False)
        return qs

这样就可以将一张数据表分别显示

list_editable 中的字段可以显示页面单独编辑

• 显示函数计算的结果，如显示章节数

    def get_zj_nums(self):
        #获取课程章节数
        return self.lesson_set.all().count()
    get_zj_nums.short_description = "章节数"

然后在list_display中加入get_zj_nums

• 显示页插入自定义的html

    def go_to(self):
        from django.utils.safestring import mark_safe
        return mark_safe("<a href='http://www.projectsedu.com'>跳转</>")
    go_to.short_description = "跳转"

通过再把go_to添加到list_display中

就得到了跳转的超链接

• refreshTime字段定义每几秒刷新页面一次

• 重载save_models方法，在保存课程的时候统计课程机构的课程数

    def save_models(self):
        #在保存课程的时候统计课程机构的课程数
        obj = self.new_obj
        obj.save()
        if obj.course_org is not None:
            course_org = obj.course_org
            course_org.course_nums = Course.objects.filter(course_org=course_org).count()
            course_org.save()

xadmin 的更多功能

根据自己需要，查看修改xadmin的源码

如插件：

开发自己的插件

xadmin插件开发：https://xadmin.readthedocs.io/en/latest/make_plugin.html
UEditor：http://ueditor.baidu.com/website/
Django-Ueditor：https://github.com/zhangfisher/DjangoUeditor

detail = UEditorField(verbose_name=u"课程详情",width=600, height=300, imagePath="courses/ueditor/", filePath="courses/ueditor/", default='')

总结使用富文本编辑器UEditor的步骤

前端显示，取消自动转义

<div class="tab_cont tab_cont1">
    {% autoescape off %}
    {{ course.detail }}
    {% endautoescape %}
</div>