Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
A customizable plug-in photo management application for the Django web framework.
tag: django-photolo…

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
photologue
.gitignore
CHANGELOG.txt
LICENSE.txt
MANIFEST.in
README.rst
setup.py

README.rst

Photologue

Improved image management for the Django web framework.

Installation

The easiest way to install Photologue is with pip:

pip install django-photologue

Photologue uses the Python Imaging Library and South; these will be installed automatically if they are not already there.

You can verify Photologue is available to your project by running the following commands from within your project directory:

manage.py shell
>>> import photologue
>>> photologue.VERSION
(2, 0, 'rc1')

Tracking the Development Version

The current development version of Photologue can be checked out via Git from the project site using the following command:

git clone git://github.com/jdriscoll/django-photologue.git

Dependencies

Photologue uses the Django admin app, so enable it if you have not already done so.

Configure Your Django Settings

  1. Add 'photologue' to your INSTALLED_APPS setting:

    INSTALLED_APPS = (
         # ...other installed applications,
         'photologue',
    )
    
  2. Confirm that your MEDIA_ROOT and MEDIA_URL settings are correct (Photologue will store uploaded files in a folder called 'photologue' under your MEDIA_ROOT).

Add the urls

Add photologue to your projects urls.py file:

urlpatterns += patterns('',
    ...
    (r'^photologue/', include('photologue.urls')),
)

Sync Your Database

Run the Django 'syncdb' command to create the appropriate tables. After the database in initialized, run the following command to initialize Photologue:

python manage.py plinit

Instant Photo Gallery

Photologue comes with basic templates for galleries and photos. You can of course override them, or completely replace them. Note that all Photologue templates inherit from photologue/root.html, which itself just inherits from a site-wide base.html - you can change this to use a different base template.

Additional Documentation and Support

Offical docs are available on Google Code (Photologue is in the process of tranferring from Google Code to Github).

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

Something went wrong with that request. Please try again.