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.

Documentation

S3 also works with the standard BOTO package.

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
• Usage
  • Upload some photos in the admin
  • Define some Photosizes
  • Built-in pages and templates
  • Custom usage
• 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
• Contributing to Photologue
  • Example project
  • Workflow
  • Coding style
  • Unit tests
  • Documentation
  • Translations
  • New features
  • And finally…
• Changelog
  • 3.14 (unreleased)
  • 3.13 (2020-09-03)
  • 3.12 (2020-07-30)
  • 3.11 (2019-12-13)
  • 3.10 (2019-08-29)
  • 3.9 (2019-04-21)
  • 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