Django之xadmin中使用富文本编辑器

- 日理万妓 2021-11-11 10:02 489阅读 0赞

**1.下载富文本编辑器的第三方库 DjangoUeditor**  
git下载：  
[https://github.com/twz915/DjangoUeditor3][https_github.com_twz915_DjangoUeditor3]  
下载完成后，进入包文件夹,找到DjangoUeditor包拷贝到和xadmin同级目录下  
**2.在 settings.py的INSTALLED\_APPS里面增加DjangoUeditor app**

INSTALLED_APPS= [
     ...
     'DjangoUeditor'
    ]

**3.配置urls [在urls.py][urls.py] 里添加路由**

path('ueditor/', include('DjangoUeditor.urls')),

**4.找到app下的models,在需要使用富文本框的字段使用UEditorField**

# 引入 UEditorField
    from DjangoUeditor.models import UEditorField
    # 使用
    class Demo(models.Model):
     	detail = UEditorField(verbose_name='详情', width=700,height=400,imagePath='ueditor/images/',filePath='ueditor/files/',default='')

**5.xadmin中添加插件ueditor**  
在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)

**6.将ueditor插件添加到plugins中的\_\_init\_\_.py的PLUGINS中**

PLUGINS = (
    	...
    	'ueditor'
    )

**7.在app下的adminx.py中配置插件**

style_fields = {'detail':'ueditor'}

**8.迁移同步表**

根据模型类生成迁移文件
    python manage.py makemigrations
    执行迁移生成表
    python manage.py migrate

**问题一：**  
在配置style\_fields的时候可能会报下面的错误  
TypeError: render() got an unexpected keyword argument ‘renderer’  
**解决：**  
修改虚拟环境下的：boundfield.py文件  
虚拟目录/site-packages/django/forms/boundfield.py  
注释掉下面的代码

return widget.render(
      name=self.html_initial_name if only_initial else self.html_name,
        value=self.value(),
        attrs=attrs,
        #renderer=self.form.renderer,
    )

**结果展示：**  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk3MDk4Nw_size_16_color_FFFFFF_t_70]**问题二：**  
编辑完详情之后，去前端模板查看，效果没有展示，这是因为展示的东西被转义了，以代码显示  
**解决：**  
关闭转义，两种方法

#方法一：
     <p>{
       { org.detail | safe}}</p>
    #方法二：
    {%autoescape off%}
       <p>{
       { org.detail }}</p>
    {%endautoescape%}

[https_github.com_twz915_DjangoUeditor3]: https://github.com/twz915/DjangoUeditor3
[urls.py]: http://xn--urls-ft4g.py
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MDk3MDk4Nw_size_16_color_FFFFFF_t_70]: /images/20211109/3034b9782d684a8b9f3e1c03effb63ce.png