Photologue

Powerful image management for the Django web framework.

Installation

Offical releases are available from: http://code.google.com/p/django-photologue/

Source Distribution

Download the .zip distribution file and unpack it. From within the extracted directory run the following command:

python setup.py install

Tracking the Development Version

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

svn checkout http://django-photologue.googlecode.com/svn/trunk/ photologue-trunk

Then either copy the photologue-trunk/photologue directory or create a symlink to the photologue-trunk/photologue directory somewhere on your python path, such as your Django project or site-packages directory.

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')

Configure Your Django Settings

Add 'photologue' to your INSTALLED_APPS setting:

INSTALLED_APPS = (
     # ...other installed applications,
     'photologue',
)

Confirm that your MEDIA_ROOT and MEDIA_URL settings are correct.

Register Photologue with the Django Admin

Add the following to your projects urls.py file:

from django.contrib import admin

admin.autodiscover()

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

To use the included photo gallery templates and views you need to first add photologue to your projects urls.py file.

# urls.py:
urlpatterns += patterns('',
    (r'^admin/(.*)', admin.site.root),
    (r'^photologue/', include('photologue.urls')),
)

Once your urls are configured you need to copy the directory photologue/templates/photologue to your projects "templates" directory:

myproject/
    myapp/
        ...
    templates/
        photologue/
            ...

If you'd rather, you can also add the absolute path to the photologue/templates directory to your TEMPLATE_DIRS setting.

# settings.py:
TEMPLATE_DIRS = ('/path/to/photologue/templates',)

Additional Documentation and Support

Offical docs:

http://code.google.com/p/django-photologue/w/list

If you have any questions or need help with any aspect of Photologue please feel free to join the discussion group:

http://groups.google.com/group/django-photologue