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.
These 3 apps will be installed automatically if they are not already there.
Note
Photologue also uses the Django admin app, so enable it if you have not already done so.
Add ‘photologue’ to your INSTALLED_APPS setting:
INSTALLED_APPS = (
# ...other installed applications,
'photologue',
'south',
)
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 photologue to your projects urls.py file:
urlpatterns += patterns('',
...
(r'^photologue/', include('photologue.urls')),
)
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!
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.