Metadata-Version: 2.0
Name: TracHackergotchi
Version: 1.2
Summary: Adds user-specific icons to the Trac timeline view.
Home-page: http://trac-hacks.org/wiki/HackergotchiPlugin
Author: Noah Kantrowitz
Author-email: noah@coderanger.net
License: BSD
Keywords: trac plugin timeline identicon hackergotchi
Platform: UNKNOWN
Classifier: Framework :: Trac
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Requires-Dist: Trac

Notes
=====
Adds user-specific icons to the timeline view.

.. image:: http://trac-hacks.org/raw-attachment/wiki/HackergotchiPlugin/hackergotchi.png

Providers
=========

Identicon
---------

Locally generate identicons__ using the author information. This provider
requires PIL__ to be installed.

__ http://www.docuverse.com/blog/donpark/2007/01/18/visual-security-9-block-ip-identification
__ http://pythonware.com/products/pil/

Identicon implementation is courtesy of `Shin Adachi <shn@glucose.jp>`_.

Gravatar
--------

Uses the Gravatar.com__ service to generate images.

__ http://gravatar.com

Configuration
=============

All configuration options go in the ``[hackergotchi]`` section.

``providers`` : *optional, default: GravatarHackergotchiProvider, IdenticonHackergotchiProvider*
    Order to try providers when looking for an image. Any providers enabled
    but not listed will be tried in a pseudo-random order.

``gravatar_default`` : *optional, default: identicon*
    Value to pass along to Gravatar to use if the email doesn't match
    anything. Valid values are ``identicon``, ``monsterid``, ``wavatar``,
    or a URL to an image. In the first three cases, a icon will be
    procedurally generated.

To enable the plugin::

    [components]
    hackergotchi.* = enabled

Example
=======

To never use the Gravatar provider::

    [hackergotchi]
    providers = IdenticonHackergotchiProvider

    [components]
    hackergotchi.* = enabled
    hackergotchi.providers.GravatarHackergotchiProvider = disabled



