django-ckeditor-filebrowser-filer 0.5.0
A django-filer based CKEditor filebrowser
License: BSD
Requires Python: >=3.7

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