Metadata-Version: 2.0
Name: django-filer
Version: 0.9.5
Summary: A file management application for django that makes handling of files and images a breeze.
Home-page: http://github.com/stefanfoulis/django-filer
Author: Stefan Foulis
Author-email: stefan@foulis.ch
License: BSD
Platform: OS Independent
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Internet :: WWW/HTTP
Requires-Dist: Django (>=1.3)
Requires-Dist: easy-thumbnails (>=1.0)
Requires-Dist: django-mptt (>=0.5.1,<0.6)
Requires-Dist: django-polymorphic (>=0.2)

============
django-filer
============


A file management application for django that makes handling of files and images a breeze.

.. figure:: docs/_static/directory_view_1_screenshot.png
   :scale: 50 %
   :alt: file browser

Filer picker widget: |file-picker-widget-screeshot|

.. |file-picker-widget-screeshot| image:: docs/_static/default_admin_file_widget.png


Documentation: http://django-filer.readthedocs.org/en/latest/index.html

Wiki: https://github.com/stefanfoulis/django-filer/wiki

Dependencies
------------

* `Django`_ >= 1.3 (with ``django.contrib.staticfiles``)
* django-mptt >= 0.2.1
* `easy_thumbnails`_ >= 1.0-alpha-17
* `django-polymorphic`_ >= 0.2 (<=0.4.0 when used with django 1.3.x)
* `PIL`_ 1.1.7 (with JPEG and ZLIB support)

Installation
------------

To get started using ``django-filer`` simply install it with
``pip``::

    $ pip install django-filer


Configuration
-------------

Add ``"filer"``, ``"mptt"`` and ``"easy_thumbnails"`` to your project's ``INSTALLED_APPS`` setting and run ``syncdb``
(and ``migrate`` if you're using South).

See the docs for advanced configuration:

  * `subject location docs`_
  * `permission docs`_ (experimental)
  * `secure file downloads docs`_ (experimental)


Testsuite
---------

The easiest way to run the testsuite is to checkout the code, make sure you have ``PIL`` installed, and run::

    python setup.py test


For serious testing ``tox`` is recommended. See documentation for details.


.. _Django: http://djangoproject.com
.. _django-polymorphic: https://github.com/bconstantin/django_polymorphic
.. _easy_thumbnails: https://github.com/SmileyChris/easy-thumbnails
.. _sorl.thumbnail: http://thumbnail.sorl.net/
.. _PIL: http://www.pythonware.com/products/pil/
.. _Pillow: http://pypi.python.org/pypi/Pillow/
.. _docs: http://django-filer.readthedocs.org/en/latest/index.html
.. _subject location docs: http://django-filer.readthedocs.org/en/latest/installation.html#subject-location-aware-cropping
.. _permission docs: http://django-filer.readthedocs.org/en/latest/permissions.html
.. _secure file downloads docs: http://django-filer.readthedocs.org/en/latest/secure_downloads.html


