Django-awesome-avatar is a reusable application providing Avatar model field. It allows crop selected area before saving image.
- field in profile model instead creating model for saving images
- HTML5 File API instead hidden iframe AJAX for image preview
- easy customizable presence (any view and widget templates)
To integrate django-awesome-avatar
with your site, there are few things
that are required:
Installing:
pip install django-awesome-avatar
List this application in the
INSTALLED_APPS
portion of your settings file. Your settings file will look something like:INSTALLED_APPS = ( ... 'awesome_avatar', )
Add the AvatarField
to your user or profile model:
from awesome_avatar.fields import AvatarField class Profile(Model): user = OneToOneField(User, related_name='profile') ... avatar = AvatarField(upload_to='avatars', width=100, height=100)
Use model form usually way:
class AvatarChangeForm(ModelForm): class Meta: model = Profile fields = ['avatar'] def change_avatar(request): if request.method == 'POST': form = AvatarChangeForm(request.POST, request.FILES, instance=request.user.profile) if form.is_valid(): form.save() return HttpResponseRedirect('/profile/') else: form = AvatarChangeForm(instance=request.user.profile) return render(request, 'template.html', {'form': form})
Define some model for saving images:
class Images(Model): image = ImageField(upload_to='images')
Use form field for cropping image:
from awesome_avatar import forms as avatar_forms class UploadAndCropImageForm(Form): image = avatar_forms.AvatarField() def upload_and_crop_image(request): if request.method == 'POST': form = UploadAndCropImageForm(request.POST) if form.is_valid(): Images(image=form.image).save() return HttpResponseRedirect('/any/') else: form = UploadAndCropImageForm() return render(request, 'template.html', {'form': form})
Django's settings.py
:
AWESOME_AVATAR = { 'width': 100, 'height': 100, 'select_area_width': 400, 'select_area_height': 300, 'save_quality': 90, 'save_format': 'png', ... }