django-awesome-avatar 1.0.3

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

• HTML FileAPI 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. 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',
)

1. 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)

2. And for example, use in ModelForm:

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

Global Settings

settings.py:

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

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

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