Django+xadmin打造在線教育平臺（十）
Django+xadmin打造在線教育平臺（十）
代碼
github下載
十四、xadmin的進階開發
14.1.權限管理
（1）用戶權限
超級用戶擁有所有權限，其它添加的用戶默認沒有任何權限
進後臺添加一個用戶“Editor1”,勾上“職員狀態”後，這個用戶才可以登錄進後臺，默認沒添加權限的用戶登錄到後臺的情況如下：
接下來，為用戶Editor1添加查看課程和查看章節的權限
再刷新可以看到，有了查看課程和章節的權限了
（2）組的權限
添加一個組“編輯部門”，賦予如下權限 ：
把剛才的用戶“Editor1”加入到“編輯部門”這個組，然後看用戶現在的權限如下：
組裏面的成員不但擁有自己本身的權限外，還會擁有組的權限
14.2.自定義icon
xadmin的圖標采用的是第三方css樣式“font awesome”,我們可以進官網下載最新的樣式替代原本的，下載地址：http://www.fontawesome.com.cn/
下載完後把裏面的“css”和“fonts”兩個文件夾拷貝到xadmin的源碼（路徑：xadmin/static/vendor/font-awesome）裏面
使用方法：
以course為例
（1）進官網找到圖標的樣式
（2）course/adminx.py使用
# 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‘]
model_icon = ‘fa fa-book‘
再在後臺刷新（ctrl+F5），就可以看到圖標了
14.3.默認排序、只讀字段和不顯示的字段
課程：
- 按點擊數倒序排序
- 點擊數不能編輯
- 不顯示收藏人數
# 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‘] #過濾
model_icon = ‘fa fa-book‘ #圖標
ordering = [‘-click_nums‘] #排序
readonly_fields = [‘click_nums‘] #只讀字段，不能編輯
exclude = [‘fav_nums‘] #不顯示的字段
14.4.inlines添加數據
目前在添加課程的時候沒法添加章節和課程資源，我們可以用inlines去實現這一功能
class LessonInline(object):
model = Lesson
extra = 0
class CourseResourceInline(object):
model = CourseResource
extra = 0
#在CourseAdmin中使用inlines添加上面兩個的方法
class CourseAdmin(object):
inlines = [LessonInline,CourseResourceInline] #增加章節和課程資源
效果如下：
再添加課程的時候，可以直接添加章節和課程資源
14.5.一張表分兩個Model來管理
課程裏面分為輪播課程和不是輪播課程兩種類型，我們可以分開來管理
（1）在course/models.py裏面新建一個Model
class BannerCourse(Course):
‘‘‘顯示輪播課程‘‘‘
class Meta:
verbose_name = ‘輪播課程‘
verbose_name_plural = verbose_name
#這裏必須設置proxy=True，這樣就不會再生成一張表，同時還具有Model的功能
proxy = True
（2）course/adminx.py
from .models import BannerCourse
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‘] #過濾
model_icon = ‘fa fa-book‘ #圖標
ordering = [‘-click_nums‘] #排序
readonly_fields = [‘click_nums‘] #只讀字段
exclude = [‘fav_nums‘] #不顯示的字段
inlines = [LessonInline,CourseResourceInline] #增加章節和課程資源
def queryset(self):
# 重載queryset方法，來過濾出我們想要的數據的
qs = super(CourseAdmin, self).queryset()
# 只顯示is_banner=True的課程
qs = qs.filter(is_banner=False)
return qs
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‘]
model_icon = ‘fa fa-book‘
ordering = [‘-click_nums‘]
readonly_fields = [‘click_nums‘]
exclude = [‘fav_nums‘]
inlines = [LessonInline,CourseResourceInline]
def queryset(self):
#重載queryset方法，來過濾出我們想要的數據的
qs = super(BannerCourseAdmin, self).queryset()
#只顯示is_banner=True的課程
qs = qs.filter(is_banner=True)
return qs
# 將管理器與model進行註冊關聯
xadmin.site.register(Course, CourseAdmin)
xadmin.site.register(BannerCourse, BannerCourseAdmin)
後臺：可以看到多了一個輪播課程，來達到分類管理的一個功能
14.6.xadmin的其它常見功能
（1）list_editable
在列表頁可以直接編輯的
class CourseAdmin(object):
list_editable = [‘degree‘,‘desc‘]
（2）自定義函數作為列顯示
course/models.py中
class Course(models.Model):
‘
‘
‘
def get_zj_nums(self):
#獲取課程的章節數
return self.lesson_set.all().count()
get_zj_nums.short_description = ‘章節數‘ #在後臺顯示的名稱
course/adminx.py中
class CourseAdmin(object):
list_display = [‘get_zj_nums‘] #直接使用函數名作為字段顯示
效果：列表字段多了個“章節數”
（3）顯示自定義的html代碼
course/models.py中
class Course(models.Model):
.
.
.
def go_to(self):
from django.utils.safestring import mark_safe
#mark_safe後就不會轉義
return mark_safe("<a href=‘https://home.cnblogs.com/u/derek1184405959/‘>跳轉</a>")
go_to.short_description = "跳轉"
course/adminx.py中
class CourseAdmin(object):
list_display = [‘go_to‘]
效果：多了一個列表“跳轉”，點擊後跳轉到上面定義的地址
（4）refresh定時刷新工具
course/adminx.py中
class CourseAdmin(object):
refresh_times = [3,5] #自動刷新（裏面是秒數）
後臺效果：
可以選擇3s或者5s自動刷新頁面
（5）字段聯動
應用場景：當添加一門課程的時候，希望課程機構裏面的課程數 +1
重寫xadmin的save_models方法
class CourseAdmin(object):
.
.
.
def save_models(self):
# 在保存課程的時候統計課程機構的課程數
# obj實際是一個course對象
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()
course/adminx.py全部代碼
14.7.增加富文本編輯器Ueditor
（1）下載
地址：https://github.com/twz915/DjangoUeditor3/
解壓後，把DjangoUeditor文件夾拷貝到項目目錄下面
註意：直接pip install DjangoUeditor的方法會出問題
（2）settings中添加app
INSTALLED_APPS = [
‘DjangoUeditor‘,
]
（3）MxOnline/urls.py
# 富文本編輯器url
path(‘ueditor/‘,include(‘DjangoUeditor.urls‘ )),
（4）course/models.py中Course修改detail字段
class Course(models.Model):
# detail = models.TextField("課程詳情")
detail = UEditorField(verbose_name=u‘課程詳情‘, width=600, height=300, imagePath="courses/ueditor/",
filePath="courses/ueditor/", default=‘‘)
（5）xadmin/plugs目錄下新建ueditor.py文件，代碼如下
import xadmin
from xadmin.views import BaseAdminPlugin, CreateAdminView, ModelFormAdminView, UpdateAdminView
from DjangoUeditor.models import UEditorField
from DjangoUeditor.widgets import UEditorWidget
from django.conf import settings
class XadminUEditorWidget(UEditorWidget):
def __init__(self, **kwargs):
self.ueditor_options = kwargs
self.Media.js = None
super(XadminUEditorWidget,self).__init__(kwargs)
class UeditorPlugin(BaseAdminPlugin):
def get_field_style(self, attrs, db_field, style, **kwargs):
if style == ‘ueditor‘:
if isinstance(db_field, UEditorField):
widget = db_field.formfield().widget
param = {}
param.update(widget.ueditor_settings)
param.update(widget.attrs)
return {‘widget‘:XadminUEditorWidget(**param)}
return attrs
def block_extrahead(self, context, nodes):
js = ‘<script type="text/javascript" src="%s"></script>‘ %(settings.STATIC_URL + "ueditor/ueditor.config.js")
js += ‘<script type="text/javascript" src="%s"></script>‘ %(settings.STATIC_URL + "ueditor/ueditor.all.min.js")
nodes.append(js)
xadmin.site.register_plugin(UeditorPlugin, UpdateAdminView)
xadmin.site.register_plugin(UeditorPlugin, CreateAdminView)
（6）xadmin/plugs/__init__.py裏面添加ueditor插件
PLUGINS = ( ‘ueditor‘, )
（7）course/adminx.py中使用
class CourseAdmin(object):
#detail就是要顯示為富文本的字段名
style_fields = {"detail": "ueditor"}
（8）course-detail.html
在模板中必須關閉Django的自動轉義才能正常顯示
<div class="tab_cont tab_cont1">
{% autoescape off %}
{{ course.detail }}
{% endautoescape %}
</div>
最終效果：
後臺編輯頁面
前端顯示
Django+xadmin打造在線教育平臺（十）