Thumbnail maker for Django
Project description
Auto-generator of thumbnails for Django, using sorl-thumbnail.
Features
Auto-genarates thumbnails using sorl-thumbnail while uploading (saving) images
You can use any engines & plugins you usually use with sorl-thumbnail
The application does not replace thumbnail templatetag and you can use everything you want from sorl-thumbnail
Command to auto-generate missing thumbnails
How to Use
Get the code
Get the code for the latest stable release use pip:
$ pip install django-thumbnail-maker
Configure your project
Register 'thumbnail_maker', in the INSTALLED_APPS section of your project’s settings:
INSTALLED_APPS = ( 'django.contrib.auth', 'django.contrib.admin', 'django.contrib.sites', 'django.contrib.comments', 'django.contrib.sessions', 'django.contrib.messages', 'django.contrib.contenttypes', 'thumbnail_maker', )
Set up required thumb formats in THUMBNAIL_MAKER_FORMATS dictionary. Keys are the names for your formats (could be any string). Values are tuples of length 2: first element is a geometry string (used in sorl-thumbnail), second is a dictionary with options (crop, quality, padding, format, etc.):
THUMBNAIL_MAKER_FORMATS = { 'banner': ('400x300', {'crop': 'center', 'quality': 90}), '50x50': ('50x50', {}), 'any_name': ('5x277', {'padding': True}) }
Set up your model’s field
Use ImageWithThumbnailsField and thumbs option, where thumbs is a tuple of thumb format names (keys from THUMBNAIL_MAKER_FORMATS dictionary):
from django.db import models from thumbnail_maker import ImageWithThumbnailsField class Item(models.Model): image = ImageWithThumbnailsField( upload_to='somewhere', thumbs=('banner', '50x50'), )
Templates usage
All of the examples assume that you first load the thumbnail_maker template tag in your template:
{% load thumbnail_maker %}
A simple usage:
{% usethumbnail item.image "banner" as im %} <img src="{{ im.url }}" width="{{ im.width }}" height="{{ im.height }}"> {% endusethumbnail %} {% usethumbnail item.image "50x50" as im %} <img src="{{ im.url }}" width="{{ im.width }}" height="{{ im.height }}"> {% endusethumbnail %}
You can also use string paths instead of image objects:
{% usethumbnail "dummy/image.png" "50x50" as im %} <img src="{{ im.url }}" width="{{ im.width }}" height="{{ im.height }}"> {% endusethumbnail %}
Management commands usage
Django-thumbnail-maker comes with a manage.py command to generate missing thumbs. You can use it while
./manage.py make_thumbnails <app>.<model> <field>
In case you want to make all thumbs replacing old ones, use --force option:
./manage.py make_thumbnails --force <app>.<model> <field>
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for django-thumbnail-maker-0.0.4.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | bbcf38d7047831a29e3d565c938c3c992032fc99590fefca12523495ad2685be |
|
MD5 | ca432021c356fa81964d1fb2e2fe6aa7 |
|
BLAKE2b-256 | d09d72b30beafbc55a4e28200d4c9d486dbbb761b9aaae3adb3fc5714b8cd411 |