Adds user picture icons (avatars) to 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
A mirror is also available on Bitbucket: https://bitbucket.org/boldprogressives/trac-userpictures-plugin
The avatar engine is configurable, and two are provided in this package: a GravatarProvider that looks up the user’s email address at Gravatar, and a UserManagerProvider that uses internally hosted images provided by the Trac UserManager Plugin if it is installed: http://trac-hacks.org/wiki/UserManagerPlugin
The approach of the plugin is to filter specific Trac views, gather all the authors found in the “data” hash being passed to Genshi, then using Genshi filters to insert additional avatar nodes with the proper img tags.
Currently supported views are:
Timeline
Ticket details: reporter, owner, comments, comment diffs
Attachment views (on tickets, wiki pages, etc)
Source control views (directory listings, file contents, changesets)
Report and custom query views
Wiki history, diffs and individual versions
Search results
This is, more or less, all the places where users show up in a standard Trac instance. If you find any other places where icons should also be inserted, whether in a standard Trac installation or in a view provided by your favorite plugin, please submit an issue or a patch.
Patches implementing additional avatar engines are also welcome.
Installation
Install the plugin in your favorite way (python setup.py develop, uploading an egg, etc) and then enable its components in trac.ini like so:
[components] userpictures.* = enabled
You should then choose your preferred avatar engine. For Gravatar:
[userpictures] pictures_provider = UserPicturesGravatarProvider
For UserManager, ensure that the UserManager plugin is installed, and then:
[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.
There are a number of optional “size” settings for each view; these are set to sensible defaults that are designed to look good with a standard Trac install and the stylesheet provided by this plugin, but look at the source in userpictures/__init__.py (and the CSS in userpictures/htdocs/userpictures.css) if you really want to change the way the icons are displayed.
Changes
0.1.1 (20 Aug 2012)
Fixed typo in code that caused Python error when navigating to browser views
0.1 (19 Aug 2012)
Initial release.
1 maintainer
Metadata
1 maintainer
Release files for trac-UserPicturesPlugin 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| trac-UserPicturesPlugin-0.1.1.tar.gz | 6.0 kB | Details |
Release files / trac-UserPicturesPlugin-0.1.1.tar.gz
| Download URL | trac-UserPicturesPlugin-0.1.1.tar.gz |
|---|---|
| Size | 6.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4dc6c61fc5e5162ac8a6ec45550aeb1351f0733d160639abd7e3e49776fd225e
|
|
BLAKE2b-256 checksum How to use checksums |
a86a8a109038640480be46805319cdf5c9257715f1e11596f63dc9181d45a41d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
