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-simplegravataror 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.
| **SIMPLEGRAVATAR_SIZE** (default: 80)
Pixel width and height of Gravatar (they are all square)
| **SIMPLEGRAVATAR_RATING** (default: \g\)
g, pg, r, x
| **SIMPLEGRAVATAR_DEFAULT** (default: \\)
| Default image if no Gravatar exists for email. Should be a full image
URL to your custom image, or one of the Gravatar built-in defaults...
- 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
| **SIMPLEGRAVATAR_SECURE** (default: False)
Use https?
For more information about these default options see:
http://en.gravatar.com/site/implement/images/
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!
