1.下载富文本编辑器的第三方库 DjangoUeditor
git下载:
https://github.com/twz915/DjangoUeditor3
下载完成后,进入包文件夹,找到DjangoUeditor包拷贝到和xadmin同级目录下
2.在 settings.py的INSTALLED_APPS里面增加DjangoUeditor app
INSTALLED_APPS= [
...
'DjangoUeditor'
]
3.配置urls 在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,
)
结果展示:
问题二:
编辑完详情之后,去前端模板查看,效果没有展示,这是因为展示的东西被转义了,以代码显示
解决:
关闭转义,两种方法
#方法一:
<p>{{ org.detail | safe}}</p>
#方法二:
{%autoescape off%}
<p>{{ org.detail }}</p>
{%endautoescape%}