xadmin中集成富文本編輯器ueditor

xadmin為django后台管理系統admin的升級版

https://github.com/twz915/django-minicms

因此建議將源碼包下載下來，並直接放在項目下的extra_apps中，如下所示：

本文的開發環境如下：

python 3.6 diango 1.11.7 pycharm windows 7

1、將djangoueditor添加到setting.py中

INSTALLED_APPS = [
    ...
    'DjangoUeditor',
]

 

2、添加url

將URL添加到urlpatterns中去：

    #富文本編輯器
    url(r'^ueditor/',include('DjangoUeditor.urls' )),

3、修改model

將模型中需要改為富文本添加的字段，一般為TextField，改為如下：

from DjangoUeditor.models import UEditorField

class Course(models.Model):
    name = models.CharField(max_length=20, verbose_name='課程名稱')
    desc = models.TextField(verbose_name='課程描述')
    detail = UEditorField(verbose_name='課程詳情',width=600, height=300, toolbars="full", imagePath="course/ueditor/", filePath="course/ueditor/", upload_settings={"imageMaxSize":1204000},default='')

關於UEditorField字段中的具體參數詳情，可以參考文檔

4、xadmin中添加插件ueditor

由於已經將xadmin源文件拷貝到了項目下，本文為extra_apps/xadmin，在xadmin下的plugin中新建一個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)

 

5、將ueditor添加到plugin下的_init_中

PLUGINS = (
    ...
    'ueditor',
)

 

6、將ueditor添加到adminx.py中

class CourseAdmin(object):
    ...
    style_fields = {"detail": "ueditor"}

 

關於style_fields，如下：style_fields = {} 
指定 Field 的 Style， Style一般用來實現同一種類型的字段的不同效果，例如同樣是 radio button，有普通及inline兩種 Style。通常 xadmin 針對表單的插件會實現更多的 Field Style。您使用這些插件后，只要方便的將想要使用插件效果的字段設置成插件實現的 Style 即可。

7、在前端顯示的話，需要對html頁面修改如下

{% autoescape off %}
{{ course.detail }}
{% endautoescape %}

 

目的是為了阻止字符的轉義

通過以上設置就可以登錄后台xadmin中，對內容進行富文本編輯，並顯示在前端頁面了，效果如下：