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


Release history Release notifications

History Node

3.2.0

History Node

3.1.1

History Node

3.1.0

History Node

3.0.1

History Node

3.0.0

History Node

2.4.2

History Node

2.4.1

History Node

2.4.0

History Node

2.3.3

History Node

2.3.2

History Node

2.3.1

History Node

2.3.0

History Node

2.2.1

History Node

2.2.0

History Node

2.1.1

History Node

2.1.0

History Node

2.0.8

History Node

2.0.7

History Node

2.0.6

History Node

2.0.5

History Node

2.0.4

History Node

2.0.3

History Node

2.0.2

History Node

2.0.1

History Node

2.0.0

History Node

1.2.2

History Node

1.2.1

History Node

1.2.0

History Node

1.1.3

History Node

1.1.2

History Node

1.1.1

History Node

1.1.0

History Node

1.0.6

History Node

1.0.2

History Node

1.0.1

History Node

1.0.0

History Node

0.5.10

History Node

0.5.9

History Node

0.5.8

History Node

0.5.7

History Node

0.5.6

History Node

0.5.5

History Node

0.5.4

History Node

0.5.3

History Node

0.5.2

History Node

0.5.1

History Node

0.5.0

History Node

0.4.2

History Node

0.4.1

History Node

0.4.0

This version
History Node

0.3.0

History Node

0.2.3

History Node

0.2.2

History Node

0.2

History Node

0.1

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
django-stdimage-0.3.0.macosx-10.9-intel.exe (67.7 kB) Copy SHA256 hash SHA256 Windows Installer any Jan 15, 2014
django-stdimage-0.3.0.tar.gz (5.5 kB) Copy SHA256 hash SHA256 Source None Jan 15, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page