README.txt

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