Essential Gravatar support for Django. Features helper methods, templatetags and a full test suite!
Project description
django-gravatar
A lightweight django-gravatar app. Includes helper methods for interacting with gravatars outside of template code.
Features
Helper methods for constructing a gravatar url and checking an email for an existing gravatar
Templatetags for generating a gravatar url or gravatar <img> tag.
Full test suite!
Installing
Install from PyPi:
$ pip install django-gravatar2
Make sure you install django-gravatar2 as there are several other incompatible django-gravatar libraries available.
Add django_gravatar to your INSTALLED_APPS in settings.py:
INSTALLED_APPS = ( # ... 'django_gravatar', )
Basic Usage
Use in code:
from django_gravatar.helpers import get_gravatar_url, has_gravatar url = get_gravatar_url('alice@example.com', size=150) gravatar_exists = has_gravatar('bob@example.com')
Use in templates:
{% load gravatar %} {% gravatar_url user.email 150 %} # https://secure.gravatar.com/avatar/hash.jpg?size=150 {% gravatar user.email 150 %} # <img class="gravatar" src="https://secure.gravatar.com/avatar/hash.jpg?size=150" width="150" height="150" alt="" /> {% gravatar user.email 150 "user@example.com" %} # <img class="gravatar" src="https://secure.gravatar.com/avatar/hash.jpg?size=150" width="150" height="150" alt="user@example.com" />
Configuring
The following options can be configured in your settings.py:
GRAVATAR_URL # Gravatar base url. Defaults to ‘http://www.gravatar.com/’
GRAVATAR_SECURE_URL # Gravatar base secure https url. Defaults to ‘https://secure.gravatar.com/’
GRAVATAR_DEFAULT_SIZE # Gravatar size in pixels. Defaults to ‘80’
GRAVATAR_DEFAULT_IMAGE # An image url or one of the following: ‘mm’, ‘identicon’, ‘monsterid’, ‘wavatar’, ‘retro’. Defaults to ‘mm’
GRAVATAR_DEFAULT_RATING # One of the following: ‘g’, ‘pg’, ‘r’, ‘x’. Defaults to ‘g’
GRAVATAR_DEFAULT_SECURE # True to use https by default, False for plain http. Defaults to True
Contributing
Feel free to fork django-gravatar on GitHub! We’d love to see your pull requests. Please make sure you run tests before submitting a patch.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file django-gravatar2-1.1.3.tar.gz
.
File metadata
- Download URL: django-gravatar2-1.1.3.tar.gz
- Upload date:
- Size: 5.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 |
7a048e302d58c1f8e62a42ff4e829d6eb3dda476ee23601779e2e5ed83a7c4fe
|
|
MD5 |
7e7c064e6c638d6fc95ef9297d9fef72
|
|
BLAKE2b-256 |
f2ca7fef0c1c6d7afa9afc01a84a6ed0ab8a58309b4caaf3465d6248718ac67e
|