[[PageOutline(2-5,Contents,pullout)]]

= Adds user picture icons (avatars) to Trac

== Description

This plugin allows a user to add a user picture icons (avatars) to his/her profile on Trac.

Screenshots of the plugin in action can be found at https://github.com/boldprogressives/trac-UserPicturesPlugin/wiki/Screenshots

Credit goes to Michael Bayer for the idea and most of the code in https://bitbucket.org/zzzeek/tracvatar

See also: TracvatarPlugin

== Bugs/Feature Requests

Existing bugs and feature requests for UserPicturesPlugin are 
[report:9?COMPONENT=UserPicturesPlugin here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=UserPicturesPlugin&owner=ejucovy new ticket].

== Download

Download the zipped source from [pypi:trac-UserPicturesPlugin/ here].

== Source

Mirrors are available on Github and Bitbucket:
 * https://github.com/boldprogressives/trac-UserPicturesPlugin/
 * https://bitbucket.org/boldprogressives/trac-userpictures-plugin

== Installation

 1. Install the plugin in your favorite way, such as python setup.py develop, uploading an egg, etc.
 1. Enable the component in `trac.ini`:
{{{
#!ini
[components]
userpictures.* = enabled
}}}
 1. Choose your preferred avatar engine. For Gravatar:
{{{
#!ini
[userpictures]
pictures_provider = UserPicturesGravatarProvider
}}}

For UserManagerPlugin integration, ensure that the UserManagerPlugin is installed and enabled, and then:

{{{
#!ini
[userpictures]
pictures_provider = UserPicturesUserManagerProvider
}}}

If you do not explicitly select either engine, a default provider is used which displays a blank silhouette for every user.

== Author/Contributors

'''Author:''' [wiki:ejucovy] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''