django-ckeditor-filebrowser-filer

================================= django-ckeditor-filebrowser-filer

|Gitter| |PyPiVersion| |PyVersion| |License|

A django-filer based CKEditor filebrowser

Supported versions

Python: 3.7 to 3.11

Django: 3.2 to 4.2

django-filer: 2.0 and above

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_.

.. warning:: if you are using filer<1.2 this plugin requires django CMS_ cmsplugin_filer_image_, thus you need to install and configure both according to their respective documentation.

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.

.. _Canonical URLs: https://django-filer.readthedocs.io/en/latest/installation.html#canonical-urls .. _django CMS: https://pypi.python.org/pypi/django-cms .. _django-filer: https://pypi.python.org/pypi/django-filer .. _cmsplugin_filer_image: https://pypi.python.org/pypi/cmsplugin_filer_image .. _django-ckeditor: https://pypi.python.org/pypi/django-ckeditor .. _djangocms-text-ckeditor: https://pypi.python.org/pypi/djangocms-text-ckeditor .. _django-ckeditor-filer: https://github.com/ikresoft/django-ckeditor-filer/

.. |Gitter| image:: https://img.shields.io/badge/GITTER-join%20chat-brightgreen.svg?style=flat-square :target: https://gitter.im/nephila/applications :alt: Join the Gitter chat

.. |PyPiVersion| image:: https://img.shields.io/pypi/v/django-ckeditor-filebrowser-filer.svg?style=flat-square :target: https://pypi.python.org/pypi/django-ckeditor-filebrowser-filer :alt: Latest PyPI version

.. |PyVersion| image:: https://img.shields.io/pypi/pyversions/django-ckeditor-filebrowser-filer.svg?style=flat-square :target: https://pypi.python.org/pypi/django-ckeditor-filebrowser-filer :alt: Python versions

.. |Status| image:: https://img.shields.io/travis/nephila/django-ckeditor-filebrowser-filer.svg?style=flat-square :target: https://travis-ci.org/nephila/django-ckeditor-filebrowser-filer :alt: Latest Travis CI build status

.. |TestCoverage| image:: https://img.shields.io/coveralls/nephila/django-ckeditor-filebrowser-filer/master.svg?style=flat-square :target: https://coveralls.io/r/nephila/django-ckeditor-filebrowser-filer?branch=master :alt: Test coverage

.. |License| image:: https://img.shields.io/github/license/nephila/django-ckeditor-filebrowser-filer.svg?style=flat-square :target: https://pypi.python.org/pypi/django-ckeditor-filebrowser-filer/ :alt: License

.. |CodeClimate| image:: https://codeclimate.com/github/nephila/django-ckeditor-filebrowser-filer/badges/gpa.svg?style=flat-square :target: https://codeclimate.com/github/nephila/django-ckeditor-filebrowser-filer :alt: Code Climate

.. :changelog:

---

History

.. towncrier release notes start

0.5.0 (2023-09-27)

Bugfixes

• Fix filer_version url and migrate to bump-my-version (#59)

0.4.0 (2023-08-03)

• Added compatibility with Django 4.2
• Drop support for Django<3.2

0.3.0 (2019-03-23)

• Added compatibility with Django 2.0

0.2.5 (2018-03-29)

• Fixed error when editing an image

0.2.4 (2018-01-09)

• Fixed filer version detection
• Added support for Django 1.11

0.2.3 (2017-04-19)

• Added russian translations

0.2.2 (2017-03-14)

• Added french translations

0.2.1 (2017-01-01)

• Added support for Django 1.10

0.2.0 (2016-10-22)

• Added support for canonical urls feature of filer 1.0
• Added support to django-ckeditor (without django CMS)
• Added support to filer up to 1.2
• Added support to ThumbnailOption
• Updated to work with djangocms-text-ckeditor 2.7
• Fixed support for advanced deployment structure

0.1.1 (2014-09-27)

• Fix static files position

0.1.0 (2014-01-27)

• First release on PyPI.