Metadata-Version: 2.1
Name: django-ckeditor-filebrowser-filer
Version: 0.3.0
Summary: A django-filer based CKEditor filebrowser
Home-page: https://github.com/nephila/django-ckeditor-filebrowser-filer
Author: Iacopo Spalletti
Author-email: i.spalletti@nephila.it
License: BSD
Keywords: django-ckeditor-filebrowser-filer,django,filer,ckeditor,filebrowser
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.11
Classifier: Framework :: Django :: 2.0
Classifier: Framework :: Django :: 2.1
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
License-File: LICENSE
License-File: AUTHORS.rst
Requires-Dist: django-filer>=1.0

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

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

A django-filer based CKEditor filebrowser

Supported versions
==================

Python: 2.7, 3.5, 3.6, 2.7

Django: 1.11 to 2.1

django-filer: 1.2 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




History
-------

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.
