django-filer

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

Filer picker widget:

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

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

Dependencies

Django >= 1.4
django-mptt >=0.5.1
easy_thumbnails >= 1.0
django-polymorphic >= 0.2
Pillow 2.3.0 (with JPEG and ZLIB support, PIL 1.1.7 is supported but not recommended)

django.contrib.staticfiles is required.

Django >= 1.6 is supported together with django-polymorphic >= 0.5.4

Django >= 1.7 is supported together with django-polymorphic >= 0.5.6

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)

Django 1.7

Django 1.7 is supported together with the new migrations. To avoid disrupting user experience the new migrations are installed in filer.migrations_django. If you are going to deploy filer in a Django 1.7 project you are required to add the following configuration:

MIGRATION_MODULES = {

'filer': 'filer.migrations_django',

}

South and Django migrations will be swapped in filer 1.0.

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