Django form widget for cropping uploaded images based on a predefined size


License
MIT
Install
pip install DjangoKeyhole==0.81.dev0

Documentation

DjangoKeyhole

DjangoKeyhole is a Django addon that adds an image crop widget to the standard ImageField. The actual cropping is done by the wonderful jquery cropping library cropit. Now the implementation destroys the original image but future versions might support non-destructive cropping.

  • quick and easy instalation
  • no external dependencyes
  • magic.

Installation

$ pip install DjangoKeyhole

Add keyhole to you're INSTALLED_APPS in settings.py

Last but not least

$ python manage.py collectstatic

How to use

from django import forms

#import the widget
from keyhole.widgets import CroppedImageWidget

class MyAdminForm(forms.ModelForm):
    # width and height are in px
    foo_image = forms.ImageField(widget=CroppedImageWidget(width=160, height=160))

Todo's

  • Write Tests
  • Fix typos in text
  • Add Code Comments
  • Test in pyhon 2.7

Version

0.1

License

MIT

Free Software, Hell Yeah!