django-ckeditor使用

Posted monkey-code

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了django-ckeditor使用相关的知识,希望对你有一定的参考价值。

django-ckeditor

1 安装

pip install ckeditor

2 配置

  1. INSTALLED_APPS中添加

    ‘ckeditor‘,

    修改写入字段的格式

  2. 主题相关配置(settings)

    CKEDITOR_CONFIGS = {
        'default': {
            'toolbar': 'full',
            'height': 300,
            'width': 600,
            'tabSpaces': 4,
            'extraPlugins': 'codesnippet',   # 配置代码插件
        }
    }
  3. 静态文件相关配置(图片)

    1 INSTALLED_APPS 中添加
         'ckeditor_uploader',
    
    2 文件相关
    MEDIA_URL = '/media/'
    MEDIA_ROOT = os.path.join(BASE_DIR, 'media')
    
    CKEDITOR_UPLOAD_PATH = 'Article_media'
  4. URLconfig

    1. 引入包
    from django.conf.urls import url,include
    from django.views.static import serve
    1. urlpatterns
    urlpatterns = [
         ...
        url(r'^ckeditor/', include('ckeditor_uploader.urls'),),
        url(r'^media/(?P<path>.*)', serve, {"document_root": develop.MEDIA_ROOT}),
        ...
    ]
    
    或 
    
    urlpatterns = [
        ...
        url(r'^ckeditor/', include('ckeditor_uploader.urls'),),
        ...
    ] + static(settings.MEDIA_URL, documnets_root = settings.MEDIA_ROOT)

3 使用

1 通用的方式,可以用在前台页面也可以用在后台管理页面

# 重写admin/Xadmin表单,在form添加装饰,而不需要修改对象模型,需要重写clean 方法,将表单拿到的数据替换成需要模型中真正存在的字段。
from ckeditor_uploader.widgets import CKEditorUploadingWidget
    
class ArticleAdminForm(forms.ModelForm):

    # 模型中并不存在 content_ck 只是在表单中存在, 将在clean 中 提换,将页面数据和模型分离开 可以做一些其他操作
    content_ck = forms.CharField(widget=CKEditorUploadingWidget(), label='正文', required=False)
    
    # 模型中的真实字段
    content = forms.CharField(widget=forms.HiddenInput(), required=False)

    class Meta:
        model = Article
        fields = (
            'category', 'tag', 'desc', 'title',
            'editor_type', 'content', 'content_ck',
            'status'
        )

    def clean(self):
        content = self.cleaned_data.get('content_ck')
        if not content:
            self.add_error('content_ck', '必填项!')
            return
        self.cleaned_data['content'] = content
        return super().clean()

2 在Admin/Xadmin后台使用

直接修改模型字段将全部的事情交给admin 虽然省事,不灵活也不利于后期开发维护

from ckeditor.fields import RichTextField

class Article(models.Model):
    title = models.CharField(max_length=254, unique=True)
    body = RichTextField()
    
    def __str__(self):
        return self.title

以上是关于django-ckeditor使用的主要内容,如果未能解决你的问题,请参考以下文章

django-ckeditor:不包括ckeditor js文件

django-ckeditor 上传的图片的绝对路径

Django-CKEditor 图片上传

如何为使用 Django-CKEditor 上传的图像创建 uuid4 文件名?

django-ckeditor 上传图片以外的文件

Django-ckeditor 在 html 中无法正确显示