Skip to main content

Django Standarized Image Field

Project description

https://travis-ci.org/codingjoe/django-stdimage.png https://pypip.in/v/django-stdimage/badge.png https://pypip.in/d/django-stdimage/badge.png

Django Standarized Image Field

Django Field that implement those features:

  • Rename files to a standardized name (using object id)

  • Resize images for that field

  • Automatically creates a thumbnail (resizing it)

  • Allow image deletion

Installation

Install latest PIL - there is really no reason to use this package without it

easy_install 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):
    image1 = StdImageField(upload_to='path/to/img') # works as ImageField
    image2 = StdImageField(upload_to='path/to/img', blank=True) # can be deleted throwgh admin
    image3 = StdImageField(upload_to='path/to/img', variations={'thumbnail': (100, 75)}) # creates a thumbnail resized to maximum size to fit a 100x75 area
    image4 = StdImageField(upload_to='path/to/img', variations={'thumbnail': (100, 100, True}) # creates a thumbnail resized to 100x100 croping if necessary

    image_all = StdImageField(upload_to='path/to/img', blank=True, variations={'large': (640, 480), 'thumbnail': (100, 100, True)}) # all previous features in one declaration

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

StdImageField stores images in filesystem modifying its name. Renamed name is set using field name, and object primary key. Also it changes old windows “jpg” extesions to standard “jpeg”.

Using image_all field previously defined (that creates a thumbnail), if an image called myimage.jpg is uploaded, then resulting images on filesystem would be (supose that this image belongs to a model with pk 14):

image_all_14.jpeg
image_all_14.large.jpeg
image_all_14.thumbnail.jpeg

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-stdimage-0.3.0.tar.gz (5.5 kB view details)

Uploaded Source

Built Distribution

django-stdimage-0.3.0.macosx-10.9-intel.exe (67.7 kB view details)

Uploaded Source

File details

Details for the file django-stdimage-0.3.0.tar.gz.

File metadata

File hashes

Hashes for django-stdimage-0.3.0.tar.gz
Algorithm Hash digest
SHA256 9b5b21666c6b32fcbb5e09c576d251662c211fcd3eb2e33ba97e9641a1a2c63f
MD5 3bef7863faf34d035ef313844ad746b7
BLAKE2b-256 78b015e1312e17d6d152f499f67843f25a9c74cccb3ebec5a71ccfdc8846a0cf

See more details on using hashes here.

Provenance

File details

Details for the file django-stdimage-0.3.0.macosx-10.9-intel.exe.

File metadata

File hashes

Hashes for django-stdimage-0.3.0.macosx-10.9-intel.exe
Algorithm Hash digest
SHA256 bee70526c230397a4456548d3388255e646ee30e208efa59c589649406f12a57
MD5 8c4bb0df2aef956e04e1667aef3f439a
BLAKE2b-256 1e4fcd9cf3a71d06b7c6447c7b313efc23811a277b7e5899d78a0d53841c465f

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page