Django Standarized Image Field
Project description
Django Standarized Image Field
Django Field that implement the following features:
Django-Storages compatible (S3)
Resize images to different sizes
Access thumbnails on model level, no template tags required
Preserves original image
Allow image deletion
Rename files to a standardized name (using a callable upload_to)
Installation
Install latest PIL - there is really no reason to use this package without it
easy_install django-stdimage
or
pip django-stdimage
Put ‘stdimage’ in the INSTALLED_APPS
Usage
Import it in your project, and use in your models.
Example:
from stdimage import StdImageField
class MyClass(models.Model):
# works as ImageField
image1 = StdImageField(upload_to='path/to/img')
# can be deleted through admin
image2 = StdImageField(upload_to='path/to/img', blank=True)
# creates a thumbnail resized to maximum size to fit a 100x75 area
image3 = StdImageField(upload_to='path/to/img', variations={'thumbnail': (100, 75)})
# creates a thumbnail resized to 100x100 croping if necessary
image4 = StdImageField(upload_to='path/to/img', variations={'thumbnail': (100, 100, True})
# all previous features in one declaration
image_all = StdImageField(upload_to='path/to/img', blank=True,
variations={'large': (640, 480), 'thumbnail': (100, 100, True)})
For using generated thumbnail in templates use “myimagefield.thumbnail”. Example:
<a href="{{ object.myimage.url }}"><img alt="" src="{{ object.myimage.thumbnail.url }}"/></a>
About image names
By default StdImageField stores images without modifying the file name. If you want to use more consistent file names you can use the build in upload functions. Example:
from stdimage import StdImageField, UPLOAD_TO_CLASS_NAME, UPLOAD_TO_CLASS_NAME_UUID, UPLOAD_TO_UUID
from functools import partial
class MyClass(models.Model)
# Gets saved to MEDIA_ROOT/myclass/#FILENAME#.#EXT#
image1 = StdImageField(upload_to=UPLOAD_TO_CLASS_NAME)
# Gets saved to MEDIA_ROOT/myclass/pic.#EXT#
image2 = StdImageField(upload_to=partial(UPLOAD_TO_CLASS_NAME, name='pic'))
# Gets saved to MEDIA_ROOT/images/#UUID#.#EXT#
image3 = StdImageField(upload_to=partial(UPLOAD_TO_UUID, path='images'))
# Gets saved to MEDIA_ROOT/myclass/#UUID#.#EXT#
image4 = StdImageField(upload_to=UPLOAD_TO_CLASS_NAME_UUID)
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
Built Distribution
File details
Details for the file django-stdimage-0.4.0.tar.gz.
File metadata
- Download URL: django-stdimage-0.4.0.tar.gz
- Upload date:
- Size: 5.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 35da012f338d8ecc195520dc188f74cfb9ea5569b558d34f7e49fa25f98d4c13 |
|
| MD5 | 755f6b72577ebb5f75d972f90ab628c4 |
|
| BLAKE2b-256 | d1da09bcfa9ec5d0e6bd8922b03d3c8cee23961ff14dac5c95093cd23750f208 |
Provenance
File details
Details for the file django-stdimage-0.4.0.macosx-10.9-intel.exe.
File metadata
- Download URL: django-stdimage-0.4.0.macosx-10.9-intel.exe
- Upload date:
- Size: 67.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 3d0bfee51a2d0408e5494a1a79e3358a796cfbaa9b00c87061abc4e26638f190 |
|
| MD5 | f7149c4b09b0031b76160a9677142e6e |
|
| BLAKE2b-256 | edde72e11416e01b14be278c4d3db28626b5bcf366880f9cd8320d6205e36dc0 |
