===============
Ajax image uploads.
-------------------------------------
[](https://crate.io/packages/django-ajaximage)
[](https://crate.io/packages/django-ajaximage)
Upload images via ajax. Images are optionally resized.
## Support
Python 2/3
Chrome / Safari / Firefox / IE10+
For older browser support use version 0.1.18.
## Installation
Install with Pip:
```pip install django-ajaximage```
## Django Setup
### settings.py
```python
INSTALLED_APPS = [
...
'ajaximage',
...
]
# Settings
AJAXIMAGE_AUTH_TEST = lambda u: True
```
### urls.py
```python
urlpatterns = patterns('',
url(r'^ajaximage/', include('ajaximage.urls')),
)
```
Run ```python manage.py collectstatic``` if required.
## Use in Django admin only
### models.py
```python
from django.db import models
from ajaximage.fields import AjaxImageField
class Example(models.Model):
thumbnail = AjaxImageField(upload_to='thumbnails',
max_height=200, #optional
max_width=200, # optional
crop=True) # optional
# if crop is provided both max_height and max_width are required
```
## Use the widget in a custom form
### forms.py
```python
from django import forms
from ajaximage.widgets import AjaxImageWidget
class AjaxImageUploadForm(forms.Form):
images = forms.URLField(widget=AjaxImageWidget(upload_to='form-uploads'))
```
### views.py
```python
from django.views.generic import FormView
from .forms import AjaxImageUploadForm
class MyView(FormView):
template_name = 'form.html'
form_class = AjaxImageUploadForm
```
### templates/form.html
```html
<html>
<head>
<meta charset="utf-8">
<title>ajaximage</title>
{{ form.media }}
</head>
<body>
{{ form.as_p }}
</body>
</html>
```
## Examples
Examples of both approaches can be found in the examples folder. To run them:
```shell
$ git clone git@github.com:bradleyg/django-ajaximage.git
$ cd django-ajaximage
$ python setup.py install
$ cd example
$ python manage.py syncdb
$ python manage.py runserver 0.0.0.0:5000
```
Visit ```http://localhost:5000/admin``` to view the admin widget and ```http://localhost:5000/form``` to view the custom form widget.
1 maintainer
Metadata
1 maintainer
Release files for django-ajaximage 0.2.8
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| django-ajaximage-0.2.8.tar.gz | 8.3 kB | Without provenance | Details |
Release files / django-ajaximage-0.2.8.tar.gz
| Download URL | django-ajaximage-0.2.8.tar.gz |
|---|---|
| Size | 8.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9a00e52178eb3ba6fbed4a0ce1c9571ce25986fdff02561f0184dd4fecbae6ec
|
|
BLAKE2b-256 checksum How to use checksums |
e771370999720eba1f6e563c6e3ad933ff100f9780a6879fbe93d7c27b8d16bf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Security for django-ajaximage 0.2.8
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
