Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Thumbnails for ImageFields in django admin.
Python CSS
branch: master

README.md

django_admin_thumbnail

PyPi version PyPi downloads

This is a package developed to help you with ImageField visualization in your ModelAdmin. It automatically creates user friendly thumbnail for any ImageField you choose to put in your list_display.

All you have to do is to switch from ModelAdmin to ThumbAdmin subclass. It's super easy to use:

The Looks

This is how it looks when you hover your cursor over an ImageField column:

The Looks

Usage

Insert admin_thumbnail to the end of your INSTALLED_APPS in settings.py:

INSTALLED_APPS = (
    ...
    'admin_thumbnail',
    ...
)

Now, your ModelAdmin must look like this::

from models import ModelExample
from admin_thumbnail import thumb_admin
from django.contrib import admin

class ModelExampleAdmin(thumb_admin.ThumbAdmin):
    list_display = ('an_image_field',)

admin.register(ModelExample, ModelExampleAdmin)

After that you must create your DB table that manages the cached thumbnails:

python manage.py syncdb

If you're using south you'll need to initialise sorl.thumbnail's migrations:

python manage.py schemamigration sorl.thumbnail --initial
python manage.py migrate sorl.thumbnail --database=$DATABASE_NAME

If your $DATABASE_NAME is not default, and you're using a (DB router)[https://docs.djangoproject.com/en/dev/topics/db/multi-db/#using-routers], you should add a key named thumbnail to your database mapping dictionary!

Yes! It's THAT simple!

Installation

Please, first read the sorl.thumbnail installation to install it's requirements.

Install using pip:

pip install django-admin-thumbnail

Or you can clone the project and install it via:

python setup.py install

Requirements

Localization

django-admin-thumbnail is localizable, but currently, the only officially supported languages are pt_BR, en_US and es. But feel free to localize it the way you want and then, send me the .po file for it to be official.

Contact

If you have any comments, ideas questions, feedback, etcetera, email me and we'll be in touch. I'm flavio@vieiracaetano.com

Something went wrong with that request. Please try again.