django-simplecrop 1.0.4

django-simplecrop
================

A simple module to crop images in an easy way in Django Administration.


Installation
-----------------------------------
Install ``django-simplecrop`` (or download from [PyPI](http://pypi.python.org/pypi/django-simplecrop/ "Download from PyPI")):

pip install django-simplecrop

Add ``simplecrop`` to ``INSTALLED_APPS`` in ``settings.py``:


INSTALLED_APPS = (
...
'simplecrop',
...
)

Include ``simpleCropAutodiscover()`` after ``admin.autodiscover()``:

...
from simplecrop.utils import simpleCropAutodiscover

admin.autodiscover()
simpleCropAutodiscover()

Include ``simplecrop.urls`` in ``urls.py``:

urlpatterns = patterns('',
...
url(r'^simplecrop/', include('simplecrop.urls')),
)


Usage
------------------


Include the ``__crops__`` parameter in your model and specify the field and image sizes:

class MyModel(models.Model):
__crops__ = [
["image", ["110x110", "200x150"]]
]

title = models.CharField(u"Title", max_length=128)
text = models.TextField("Text")
image = models.ImageField("Image", upload_to="images")


Testing
-----------------
Step 1 - Add image:

Step 2 - Crop images:


Template tag
-----------------
Use the template tag `{% thumbnail %}` in your templates:

How to use:

<img name="myimage" src="{% thumbnail ImageObj '100x100' %}" />

\* *This template tag obtains the thumbnail image created when saving in admin. If it does not exist, a new thumbnail with the specified sizes will be created.*

Authors
-----------------

- [Felipe R. Rêgo](https://github.com/feliperrego "GitHub - Felipe R. Rêgo")
- [Silvio Lucena Junior](https://github.com/silviolucenajunior "GitHub - Silvio Lucena")