第13章 xadmin的进阶开发

偏执的太偏执、 2022-06-15 12:18 191阅读 0赞

> 慕课网《[强力django+杀手级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()

![这里写图片描述][SouthEast]

![这里写图片描述][SouthEast 1]

## 权限的使用 ##

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

![这里写图片描述][SouthEast 2]

![这里写图片描述][SouthEast 3]

![这里写图片描述][SouthEast 4]

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

### 权限组 ###

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

![这里写图片描述][SouthEast 5]

## 更改图标 ##

![这里写图片描述][SouthEast 6]

![这里写图片描述][SouthEast 7]

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

> font awesome : [http://fontawesome.dashgame.com/][http_fontawesome.dashgame.com]

![这里写图片描述][SouthEast 8]

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

## 　显示的排序 ##

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

![这里写图片描述][SouthEast 9]

![这里写图片描述][SouthEast 10]

*  同时， 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

![这里写图片描述][SouthEast 11]

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

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

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

![这里写图片描述][SouthEast 12]

list\_editable 中的字段可以显示页面单独编辑

![这里写图片描述][SouthEast 13]

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

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

然后在list\_display中加入get\_zj\_nums  
![这里写图片描述][SouthEast 14]

*  显示页插入自定义的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 的更多功能 ##

![这里写图片描述][SouthEast 15]

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

如插件：

![这里写图片描述][SouthEast 16]

## 开发自己的插件 ##

> xadmin插件开发：[https://xadmin.readthedocs.io/en/latest/make\_plugin.html][https_xadmin.readthedocs.io_en_latest_make_plugin.html]  
> UEditor：[http://ueditor.baidu.com/website/][http_ueditor.baidu.com_website]  
> Django-Ueditor：[https://github.com/zhangfisher/DjangoUeditor][https_github.com_zhangfisher_DjangoUeditor]

![这里写图片描述][SouthEast 17]

![这里写图片描述][SouthEast 18]

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

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

![这里写图片描述][SouthEast 19]

前端显示，取消自动转义

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

[django_xadmin]: http://coding.imooc.com/class/78.html
[SouthEast]: /images/20220615/da2753851e684003a81b0bddc3075eb7.png
[SouthEast 1]: /images/20220615/57d7be8744b54764b556321a00e5bd67.png
[SouthEast 2]: /images/20220615/daaf460892e14d058a35711d25f7d313.png
[SouthEast 3]: /images/20220615/e2e7a38f6f74456d863f3598944bde7d.png
[SouthEast 4]: /images/20220615/5a54a190116e43c69b54872d21745c41.png
[SouthEast 5]: /images/20220615/be639c577d944214b8e4e1313e97d04b.png
[SouthEast 6]: /images/20220615/c0d017e12408455e97784a732232b1c6.png
[SouthEast 7]: /images/20220615/f92c0dffe39e4a21a796610b92523a26.png
[http_fontawesome.dashgame.com]: http://fontawesome.dashgame.com/
[SouthEast 8]: /images/20220615/f4f19b31a6c242e8a5979f091b513c81.png
[SouthEast 9]: /images/20220615/4b7482ebb92846ee858295e0402fb5da.png
[SouthEast 10]: /images/20220615/cec3dd7ad2fa4688923a4a927e8a8272.png
[SouthEast 11]: /images/20220615/ec842007691142fe904e34540e40487f.png
[SouthEast 12]: /images/20220615/7e1b3f54284a49d8bd50657c376780c3.png
[SouthEast 13]: /images/20220615/18ec167f6e6549ebbc8fc470731b329e.png
[SouthEast 14]: /images/20220615/a6ef8a274b2d472c9a9f5b8f0d7bbf8e.png
[SouthEast 15]: /images/20220615/1fe76bd5afa24cf8a8d8bc2b71e5f389.png
[SouthEast 16]: /images/20220615/0b49574326524c5f8a3eb518d7fc013d.png
[https_xadmin.readthedocs.io_en_latest_make_plugin.html]: https://xadmin.readthedocs.io/en/latest/make_plugin.html
[http_ueditor.baidu.com_website]: http://ueditor.baidu.com/website/
[https_github.com_zhangfisher_DjangoUeditor]: https://github.com/zhangfisher/DjangoUeditor
[SouthEast 17]: /images/20220615/28982c23a24f45c9b505da621109a29e.png
[SouthEast 18]: /images/20220615/d7d4b8925ecb4ebbb6b7ed1c09bdd8a7.png
[SouthEast 19]: /images/20220615/cb0526b4f5e243aa9ab3e6397cfd7743.png