Metadata-Version: 2.0
Name: django-ckeditor-filebrowser-filer
Version: 0.2.0b8
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
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Requires-Dist: django-filer (>=1.0)

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

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

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

.. 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: http://django-filer.readthedocs.org/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/






History
-------

0.2.0 (unreleased)
++++++++++++++++++

* 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

0.1.1 (2014-09-27)
++++++++++++++++++

* Fix static files position

0.1.0 (2014-01-27)
++++++++++++++++++

* First release on PyPI.


