Home

There's not much at present in this wiki, but you will find:

Some example websites using Photologue

Photologue wishlist

What is Photologue?

Photologue is a reusable Django application that provides powerful image management and manipulation functionality as well as a complete photo gallery solution. The 2.x release adds more effects, including reflections and transparent watermarks. It also introduces the ImageModel abstract base class allowing developers to easily integrated the Photologue core functionality into their own models. Photologue embraces the Django admin and smoothly integrates with photo thumbnails and effect previews.

What does it do?

Photologue allows you to define *PhotoSize models. "Photo Sizes" are predefined image specifications such as thumbnails, banners, display sizes and user portraits. "Photo Sizes" can be scaled to a height or width proportionately or cropped from the center, top, left, bottom or right. Photologue will resize your original images to the sizes on you define on request and cache the results for further requests. Photologue allows you to apply your own pre-defined PhotoEffect models to your "Photo Sizes" as well as individual photos. "Photo Effects" include adjusts such as "color", "brightness", "contrast" and "sharpness" as well as filters like "Find Edges" and "Emboss". Sharpen your images. Make your thumbnails black and white. It's auto-magical with Photologue.

Photologue gives you the ability to upload an entire gallery of images at once, using the GalleryUpload model, in a .zip file. Save time uploading a large number of images and apply tags, effects, and more. Photologue's ImageModel abstract class parses EXIF information from supported files using the excellent EXIF.py module and stores the information as a Python property for easy access. Photologue's Photo model replaces the Django ImageField. Plug Photologue into your existing apps using foreign key relationships and enjoy a better experience managing uploaded images. Photologue is easy to use. Models inheriting from the ImageModel abstract base class, including the Photo model, are modified at runtime with several "accessor" methods for retrieving specific photo paths, urls, etc. For instance, if you defined a "display" photo size, your photo models would be extended with the following methods: get_display_url, get_display_path and get_display_size. These methods are added for each "Photo Size" you define.

Photologue is efficient. Uploaded images are only resized and processed upon first request. It then caches the result saving disk space, memory and processing power. Individual "Photo Sizes" such as thumbnails can be "pre-cached" to improve performance. Photologue optionally supports the django-tagging application for setting tags on both your photos and galleries.

Photologue comes with a complete set of example templates for setting up a photo gallery fast. Define a master template, apply some styles and you've got a complete photo gallery system for your site or blog. Photologue cleans up after itself. Unused files and folders are deleted automatically.