[[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/trac-hacks/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 
[/newticket?component=UserPicturesPlugin new ticket].

[[TicketQuery(component=UserPicturesPlugin&group=type,format=progress)]]

== Download

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

== Source

Mirrors are available on Github and Bitbucket:
 * https://github.com/trac-hacks/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 your `trac.ini` file:
{{{#!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:'''