Skip to content
File and Image Management Application for django. NOTICE: update to django-filer 0.8.5 for easy-thumbnails >= 1.0-alpha-17 support.
Python JavaScript Shell
Pull request Compare This branch is 1623 commits behind divio:develop.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
docs
filer
.gitignore
.hgignore
.travis.yml
.travis_setup
AUTHORS
HISTORY
LICENSE
LICENSES
MANIFEST.in
README.rst
runtests.sh
setup.py
test_settings.py
test_settings_django_12.py
test_settings_django_13.py
test_urls.py

README.rst

django-filer

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

Dependencies

Installation

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

$ pip install django-filer

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

Configuration

django-filer supports permissions on files. They can be enabled or disabled. Files with disabled permissions are your regular world readable files in MEDIA_ROOT. Files with permissions are a other case however. To be able to check permissions on the file downloads a special view is used and they are saved in a separate location (in a directory called smedia next to MEDIA_ROOT by default).

filer.server.urls needs to be included in the root urls.py:

urlpatterns += patterns('',
    url(r'^', include('filer.server.urls')),
)

By default files with permissions are served directly by django. That is acceptable in a development environment, but very bad for performance in production. See the docs on how to serve files more efficiently.

For automatic subject location aware cropping of images replace easy_thumbnails.processors.scale_and_crop with filer.thumbnail_processors.scale_and_crop_with_subject_location in the THUMBNAIL_PROCESSORS setting:

THUMBNAIL_PROCESSORS = (
    'easy_thumbnails.processors.colorspace',
    'easy_thumbnails.processors.autocrop',
    #'easy_thumbnails.processors.scale_and_crop',
    'filer.thumbnail_processors.scale_and_crop_with_subject_location',
    'easy_thumbnails.processors.filters',
)
Something went wrong with that request. Please try again.