Skip to content

Latest commit

 

History

History
62 lines (44 loc) · 1.69 KB

README.rst

File metadata and controls

62 lines (44 loc) · 1.69 KB

django-cropduster

django-cropduster is a project that makes a form field available that uses the Jcrop jQuery plugin. It is a drop-in replacement for django's ImageField and allows users to generate multiple crops from images, using predefined sizes and aspect ratios. django-cropduster was created by developers at The Atlantic. It is compatible with python 2.7 and 3.4, and Django versions 1.4 - 1.8.

Installation

The recommended way to install django-cropduster is from PyPI:

pip install django-cropduster

Alternatively, one can install a development copy of django-cropduster from source:

pip install -e git+git://github.com/theatlantic/django-cropduster.git#egg=django-cropduster

If the source is already checked out, use setuptools:

python setup.py develop

Configuration

To enable django-cropduster, "cropduster" must be added to INSTALLED_APPS in settings.py and you must include cropduster.urls in your django urlpatterns.

# settings.py

INSTALLED_APPS = (
    # ...
    'cropduster',
)

# urls.py

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

License

The django code is licensed under the Simplified BSD License. View the LICENSE file under the root directory for complete license and copyright information.

The Jcrop jQuery library included is used under the MIT License.