Welcome to django-photologue’s documentation!

Django-photologue

A powerful image management and gallery application for the Django web framework. Upload photos, group them into galleries, apply effects such as watermarks.

Take a closer look

• We have a demo website.
• We also have some examples of sites using Photologue on the wiki.

For S3, you’ll have to install Boto, which for now is not compatible with Python 3 so you’re stuck with Python 2.7…

Support

If you have any questions or need help with any aspect of Photologue then please join our mailing list.

Travis CI status

We use Travis to check that the unit test suite is working against various combinations of Python, Django, etc… Click here for the full report.

Contents:

• Installation & configuration
  • Installation
  • Dependencies
  • Configure Your Django Settings file
  • Add the urls
  • Sync Your Database
  • Instant templates
  • Sitemap
  • Sites
  • Amazon S3
• Customisation: extending templates
• Customisation: Settings
  • PHOTOLOGUE_GALLERY_LATEST_LIMIT
  • PHOTOLOGUE_GALLERY_SAMPLE_SIZE
  • PHOTOLOGUE_IMAGE_FIELD_MAX_LENGTH
  • PHOTOLOGUE_SAMPLE_IMAGE_PATH
  • PHOTOLOGUE_MAXBLOCK
  • PHOTOLOGUE_DIR
  • PHOTOLOGUE_PATH
  • PHOTOLOGUE_MULTISITE
• Customisation: Admin
  • Create a customisation application
  • Changing the admin
  • Possible uses
• Customisation: Views and Urls
  • Create a customisation application
  • Changing pagination from our new urls.py
  • Values that can be overridden from urls.py
  • Changing views.py to create a RESTful api
• Customisation: Models
  • Create a customisation application
  • Extending
• Customisation: third-party contributions
  • Old-style templates
• Contributing to Photologue
  • Example project
  • Workflow
  • Coding style
  • Unit tests
  • Documentation
  • Translations
  • New features
  • And finally…
• Changelog
  • 3.9 (unreleased)
  • 3.8.1 (2017-12-03)
  • 3.8 (2017-12-03)
  • 3.7 (2017-05-10)
  • 3.6 (2016-10-05)
  • 3.5.1 (2016-01-13)
  • 3.5 (2016-01-09)
  • 3.4.1 (2015-12-23)
  • 3.4 (2015-12-23)
  • 3.3.2 (2015-07-20)
  • 3.3.1 (2015-07-20)
  • 3.3 (2015-07-20)
  • 3.2 (2015-05-11)
  • 3.1.1 (2014-11-13)
  • 3.1 (2014-11-03)
  • 3.0.2 (2014-09-23)
  • 3.0.1 (2014-09-16)
  • 3.0 (2014-09-15)
  • 2.8.3 (2014-08-28)
  • 2.8.2 (2014-07-26)
  • 2.8.1 (2014-07-26)
  • 2.8 (2014-05-04)
  • 2.7 (2013-10-27)
  • 2.6.1 (2013-05-19)
  • 2.6 (2013-05-19)
  • 2.5 (2012-12-13)
  • 2.4 (2012-08-13)

Indices and tables

• Index
• Module Index
• Search Page