Settings¶

THUMBNAIL_PATH: The path where thumbnails are saved.

Default: os.getcwd() + '/thumbnails-cache'

Default in Django: django.conf.settings.MEDIA_ROOT + '/thumbnails-cache'

THUMBNAIL_URL: The prefix for the url property of an Thumbnail object. The url property will contain this prefix and the relative path from THUMBNAIL_PATH.

Default: '/thumbnails/''

Default in Django: django.conf.settings.MEDIA_URL + '/thumbnails-cache'

THUMBNAIL_ENGINE: Default: thumbnails.engines.PillowEngine

THUMBNAIL_CACHE_BACKEND: Default: thumbnails.cache_backends.SimpleCacheBackend

Default in Django: thumbnails.cache_backends.DjangoCacheBackend

THUMBNAIL_CACHE_TIMEOUT: A timeout parameter for cache backends that does not support eternal items.

Default: 60 * 60 * 24 * 365 (a year in seconds)

THUMBNAIL_STORAGE_BACKEND: Default: thumbnails.storage_backends.FilesystemStorageBackend

Default in Django: thumbnails.storage_backends.DjangoStorageBackend

Image options¶

THUMBNAIL_SCALE_UP: If this is set to True the thumbnails can be scaled bigger than the original.

Default: False

THUMBNAIL_QUALITY: Quality sent to the engine.

Default: 90

THUMBNAIL_COLORMODE: The default colormode for thumbnails. Supports all values supported by pillow. In other engines there is a best effort translation from pillow modes to the modes supported by the current engine.

Default: 'RGB'

THUMBNAIL_FALLBACK_FORMAT: If the engine is not able to detect file type from the source or the file type is not supported this format will be used.

Defaults: 'JPEG'

THUMBNAIL_FALLBACK_FORMAT: This will override the original image format, however, passing format into get_thumbnail will override this value.

Defaults: None

THUMBNAIL_ALTERNATIVE_RESOLUTIONS: Defines which alternative resolutions should be created. Each item in the list will create an alternative version with the number as a proportions-factor.

Default: [2]

Templatetags and filters¶

THUMBNAIL_FILTER_OPTIONS: The options passed into get_thumbnail by the Markdown and HTML filter. It can contain all options that is supported by get_thumbnails, however size is required.

Default: {'size': '500'}

Dummy thumbnails¶

THUMBNAIL_DUMMY: Activates the dummy thumbnail functionality, when this is active the original image will not be opened.

Default: False

THUMBNAIL_DUMMY_FALLBACK: Makes the dummy thumbnail functionality only be used if the thumbnail cannot be created.

Default: False

THUMBNAIL_DUMMY_URL: This is the url that the dummy url is generated from. It should be a string that can be used with string.format and the arguments are width and height, THUMBNAIL_DUMMY_URL.format(width=width, height=height)

Default: http://puppies.lkng.me/{width}x{height}