SmileyChris

sorl-thumbnail ImageWithThumbnailsField

Rambling on about Django 29 months ago.

If you're using sorl-thumbnail, you may want to update svn and check out the new field I recently added.

No docs as of this moment, so just look at the source.

What, you're not afraid of source are you?

Ok, if you insist, here's a summary:

To use, just replace your current ImageField with ImageWithThumbnailsField (which you import from sorl.thumbnail.fields).

It takes an extra argument: thumbnail, which is a dictionary containing the 2-length tuple of the size and optionally a list of thumbnail options. For example, if you used this field:

MyModel(models.Model):
    ...
    photo = ImageWithThumbnailsField(
        upload_to='profiles',
        thumbnail={
            'size': (50, 50),
            'options': ('crop',)
        })

Your model instance will have two new functions:

get_photo_thumbnail

Returns a DjangoThumbnail instance for your pleasure (if you use this in a template, it'll return the full URL to the thumbnail)

get_photo_thumbnail_tag

Returns the HTML <img src="..." width="..." height="..." alt="" /> tag. You may find this useful for showing the thumbnail in admin using list_display.

If you want to use multiple thumbnails, you can also provide a extra_thumbnails dictionary:

photo = ImageWithThumbnailsField(
    upload_to='profiles',
    thumbnail={
        'size': (50, 50),
        'options': ('crop',)
    },
    extra_thumbnails={
        'admin': {
            'size': (60, 30)
        }
    })

Which would another two functions on your instance for each extra thumbnail. In this case, get_photo_admin_thumbnail and get_photo_admin_thumbnail_tag.