A file management application for django that makes handling of files and images a breeze.
Documentation: http://django-filer.readthedocs.org/en/latest/index.html
Wiki: https://github.com/stefanfoulis/django-filer/wiki
- 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
To get started using django-filer
simply install it with
pip
:
$ pip install django-filer
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 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.
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.