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 byget_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}