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)