Skip to main content

A django-filer based CKEditor filebrowser

Project description

https://badge.fury.io/py/django-ckeditor-filebrowser-filer.png

A django-filer based CKEditor filebrowser

Documentation

Original code is taken from django-ckeditor-filer

It supports both ckeditor widget provided by django-ckeditor and the one provided by djangocms-text-ckeditor.

Quickstart

  • Install django-ckeditor-filebrowser-filer:

    pip install django-ckeditor-filebrowser-filer
  • Add it to INSTALLED_APPS along with its dependencies:

    'filer',
    'ckeditor_filebrowser_filer',
  • Configure django-filer Canonical URLs

  • Add ckeditor_filebrowser_filer to urlconf:

    url(r'^filebrowser_filer/', include('ckeditor_filebrowser_filer.urls')),

    Currently only filebrowser_filer/ is supported as url path

  • Add FilerImage button to you CKEditor configuration:

    • Add 'FilerImage' to a toolbar in CKEDITOR_CONFIGS

    • Add 'filerimage' in `` ‘extraPlugins’`` in CKEDITOR_CONFIGS

    • Add 'image' in `` ‘removePlugins’`` in CKEDITOR_CONFIGS

Example:

CKEDITOR_CONFIGS = {
    'default': {
        'toolbar': 'Custom',
        'toolbar_Custom': [
            ...
            ['FilerImage']
        ],
        'extraPlugins': 'filerimage',
        'removePlugins': 'image'
    },
}

when using djangocms-text-ckeditor use CKEDITOR_SETTINGS instead of CKEDITOR_CONFIGS.

History

0.2.0 (2015-11-18)

  • Update to use canonical urls feature of filer 1.0

  • Update to work with djangocms-text-ckeditor 2.7

0.1.1 (2014-09-27)

  • Fix static files position

0.1.0 (2014-01-27)

  • First release on PyPI.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page