django-awesome-avatar 1.0.5

Avatar django model field

Django-awesome-avatar is a reusable application providing Avatar model field. It allows crop selected area before saving image.

Purpose

Unlike django-avatar and django-upload-avatar

django-awesome-avatar uses:

• 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)

Usage

To integrate django-awesome-avatar with your site, there are few things that are required:

1. Installing:

   pip install django-awesome-avatar

2. List this application in the INSTALLED_APPS portion of your settings file. Your settings file will look something like:

   INSTALLED_APPS = (
       ...
       'awesome_avatar',
   )

3. Add the AvatarField to your profile model:

   from awesome_avatar.fields import AvatarField
   
   class Profile(Model):
       ...
       avatar = AvatarField(upload_to='avatars', width=100, height=100)

4. And for example, use in ModelForm:

   class AvatarChangeForm(ModelForm):
       class Meta:
           model = Profile
           fields = ['avatar']
   
   ...
   return render(request, template, {'form': AvatarChangeForm})

Global Settings

Django’s settings.py:

AWESOME_AVATAR = {
    'width': 100,
    'height': 100,

    'select_area_width': 400,
    'select_area_height': 300,

    'save_quality': 90,
    'save_format': 'png',
    ...
}