Installation

Introduction

The easiest way to install Photologue is with pip:

pip install django-photologue

You can also install the development version which is on Github:

git clone git://github.com/jdriscoll/django-photologue.git
cd django-photologue
python setup.py install

This code should work ok - like Django itself, we try to keep the master branch bug-free.

Dependencies

These 3 apps will be installed automatically if they are not already there.

Note

  • Pillow can be tricky to install; sometimes it will install smoothly out of the box, sometimes you can spend hours figuring it out - installation issues vary from platform to platform, and from one OS release to the next, so listing them here would not be practical. Google is your friend, and it’s worth noting that Pillow is a fork of PIL, so googling ‘PIL installation <your platform>’ can also help.
  • Photologue, like Django itself, only supports the last 2 releases of Django.

Photologue also 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',
         'south',
    )
    
  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

Use South to setup the new tables:

python manage.py migrate photologue

If you are installing Photologue for the first time, this will set up some default PhotoSizes to get you started - you are free to change them of course!

Project Versions

Table Of Contents

Previous topic

Welcome to django-photologue’s documentation!

Next topic

Customising and extending

This Page