PRE-ALPHA

Requirements:
- PIL
- mptt
- sorl.thumbnail
- django 1.1
- (south) not a requirement, but handy

for cms integration:
- django-cms-2.0

Setup
- add 'image_filer' to INSTALLED_APPS
- make the directory 'image_filer' (found in image_filer/media/') available in MEDIA_ROOT
  optional: configure IMAGE_FILER_MEDIA_URL in your project's settings.py to the URL
  where image_filer-media can be found (usually MEDIA_URL+'image_filer/' which is the
  default)
- for image upload to work, create the folder "catalogue" in your MEDIA_ROOT and make
  it writable to the web server (www-data on linux/unix). Image filer will try to do this
  for you, but if the MEDIA_ROOT folder is not writable (recomended), it will fail and you
  will see "IO ERROR" in the clipboard.
  optional: configure IMAGE_FILER_UPLOAD_ROOT to define an alternative upload directory.


Custom plugins using image folders
==================================
To customize a slideshow as shown in cms_plugins.FolderSlideshowPlugin, just do
the following in your own project:

- create a file 'cms_plugins.py' in your application root (where models.py resides):

        from cms.plugin_pool import plugin_pool
        from django.utils.translation import ugettext_lazy as _
        from image_filer.cms_plugins import FolderSlideshowPlugin
        
        class CustomSlideshowPlugin(FolderSlideshowPlugin):
            name = _("Custom slideshow")
            class Meta:
                proxy = True
            render_template = "slideshow.html"
        plugin_pool.register_plugin(CustomSlideshowPlugin)

- create an appropriate 'templates/slideshow.html' relative to your application's
  root (look at 'image_filer/slideshow2.html' for guidance)