What?
A simpler Django template tag to add Gravatar support to your Django projects. This is based on my 2008 post entitled Implementing Gravatar in Django.
Installation
To install this app, simply:
pip install django-simplegravatar
or drop the 'simplegravatar' folder somewhere on your PYTHONPATH
Add 'simplegravatar' to your projects INSTALLED_APPS list in
settings.py
Configuration
There are a few optional settings that can be added to your Django settings file to affect the global behavior of simplegravatar.
Pixel width and height of Gravatar (they are all square)
g, pg, r, x
- 404: do not load any image if none is associated with the email hash, instead return an HTTP 404 (File Not Found) response
- mm: (mystery-man) a simple, cartoon-style silhouetted outline of a person (does not vary by email hash)
- identicon: a geometric pattern based on an email hash
- monsterid: a generated 'monster' with different colors, faces, etc
- wavatar: generated faces with differing features and backgrounds
- retro: awesome generated, 8-bit arcade-style pixelated faces
Use https?
USAGE (this goes in your templates)
{% load simplegravatar %}
{% show_gravatar "[email protected]" %}
You may optionally pass a size into this template tag:
{% show_gravatar "[email protected]" 48 %}
If you require a secure image (instead of using SETTINGS):
{% show_gravatar_secure "[email protected]" %}
Enjoy!