Django form widget for cropping uploaded images based on a predefined size
Project description
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
~~~~~~~~~~~~
.. code:: sh
$ pip install DjangoKeyhole
Add ``keyhole`` to youâre ``INSTALLED_APPS`` in ``settings.py``
Last but not least
.. code:: sh
$ python manage.py collectstatic
How to use
~~~~~~~~~~
.. code:: python
from django.contrib import admin
#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!**
.. _cropit: http://scottcheng.github.io/cropit/
=============
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
~~~~~~~~~~~~
.. code:: sh
$ pip install DjangoKeyhole
Add ``keyhole`` to youâre ``INSTALLED_APPS`` in ``settings.py``
Last but not least
.. code:: sh
$ python manage.py collectstatic
How to use
~~~~~~~~~~
.. code:: python
from django.contrib import admin
#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!**
.. _cropit: http://scottcheng.github.io/cropit/
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
DjangoKeyhole-0.2.dev0.tar.gz
(11.0 kB
view hashes)