Skip to main content

Django image uploader and cropping tool

Project description

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.

django-cropduster is a mature library currently in production at The Atlantic. However, the documentation at present is far from adequate. Until there is sufficiently detailed documentation we encourage any developers who have an interest in the project but are encountering difficulties using it to create issues on the GitHub project page requesting assistance.

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 you are working from source, ensure that you have django-cropduster checked out to the v4 branch. 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-cropduster-4.6.4.tar.gz (1.7 MB view details)

Uploaded Source

File details

Details for the file django-cropduster-4.6.4.tar.gz.

File metadata

File hashes

Hashes for django-cropduster-4.6.4.tar.gz
Algorithm Hash digest
SHA256 22a7614f4c4178908e2e31e6bc3ca2d5898d0e519b3e77dd0f1d1e12f9e7ab0b
MD5 ed4354f66250d3bdad14e52598b40f88
BLAKE2b-256 9461504c319a16a0c2899fcd9a638b4f90f299d0ed476a58b3cf2bb40ae3cf2e

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page