/django-filer

File and Image Management Application for django

Primary LanguagePythonBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

django-filer

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

file browser

Filer picker widget: file-picker-widget-screeshot

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

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

Dependencies

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:

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

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