django-athumb 1.0

Requirements

• python >= 2.5

• django >= 1.0

• boto >= 1.8d <= 2.0

Installation

To install run

python setup.py install

which will install the application into python’s site-packages directory.

Configuration

settings.py

Add to INSTALLED_APPS:

‘athumb’

Add to TEMPLATE_CONTEXT_PROCESSORS in settings.py:

‘django.core.context_processors.request’

If you want S3 storage as your default file back-end:

# If you don’t want this to be the global default, just make sure you # specify the S3BotoStorage_AllPublic backend on a per-field basis. DEFAULT_FILE_STORAGE = ‘athumb.backends.s3boto.S3BotoStorage_AllPublic’

Then setup some values used by the backend:

AWS_ACCESS_KEY_ID = ‘YourS3AccessKeyHere’ AWS_SECRET_ACCESS_KEY = ‘YourS3SecretAccessKeyHere’ AWS_STORAGE_BUCKET_NAME = ‘OneOfYourBuckets’

Backends

django-athumb comes with a simplified s3boto backend, modified from those found in the django-storages project. For most cases, you’ll want to use athumb.backends.s3boto.S3BotoStorage_AllPublic, as it does not use HTTPS, and is a good bit faster than S3BotoStorage because it makes some assumptions.

NOTE: This package is primarily aimed at serving S3 thumbnails, I have not tested it at all with the Django standard backend.

Template Tags

When referring to media in HTML templates you can use custom template tags. These tags can by accessed by loading the athumb template tag collection.

{% load thumbnail %}

If you’d like to make the athumb tags global, you can add the following to your master urls.py file:

from django.template import add_to_builtins add_to_builtins(‘athumb.templatetags.thumbnail’)

Some backends (S3) support https URLs when the requesting page is secure. In order for the https to be detected, the request must be placed in the template context with the key ‘request’. This can be done automatically by adding ‘django.core.context_processors.request’ to __TEMPLATE_CONTEXT_PROCESSORS__ in settings.py

To-Do

• See the issue tracker for a list of outstanding things needing doing.

Change Log

1.0

• Initial release.