Metadata-Version: 1.1
Name: django_admin_thumbnail
Version: 1.0
Summary: Thumbnails for ImageFields in django admin.
Home-page: https://github.com/fjcaetano/django_admin_thumbnail
Author: Flávio Caetano
Author-email: flavio@vieiracaetano.com
License: MIT - see LICENSE.txt
Description: django_admin_thumbnail
        ======================
        [![PyPi version](https://pypip.in/v/django_admin_thumbnail/badge.png)](https://crate.io/packages/django_admin_thumbnail/)
        [![PyPi downloads](https://pypip.in/d/django_admin_thumbnail/badge.png)](https://crate.io/packages/django_admin_thumbnail/)
        
        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](https://raw.github.com/fjcaetano/django-admin-thumbnail/master/thumb_image.png)
        
        Usage
        -----
        
        Insert **admin_thumbnail** to the end of your `INSTALLED_APPS` in `settings.py`:
        
        ``` python
        INSTALLED_APPS = (
            ...
            'admin_thumbnail',
            ...
        )
        ```
        
        Now, your `ModelAdmin` must look like this::
        
        ``` python
        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](http://sorl-thumbnail.readthedocs.org/en/latest/) 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
        
        * [Django 1.4+](http://pypi.python.org/pypi/Django/1.4)
        * [sorl.thumbnail 11.12+](http://pypi.python.org/pypi/sorl-thumbnail/11.12)
        * [PIL 1.1.6+](http://pypi.python.org/pypi/PIL/1.1.6)
            
        # 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>
        
Platform: any
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Natural Language :: Portuguese (Brazilian)
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
