Skip to main content

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.

https://secure.travis-ci.org/twaddington/django-gravatar.png

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-gravatar2-1.1.3.tar.gz (5.6 kB view details)

Uploaded Source

File details

Details for the file django-gravatar2-1.1.3.tar.gz.

File metadata

File hashes

Hashes for django-gravatar2-1.1.3.tar.gz
Algorithm Hash digest
SHA256 7a048e302d58c1f8e62a42ff4e829d6eb3dda476ee23601779e2e5ed83a7c4fe
MD5 7e7c064e6c638d6fc95ef9297d9fef72
BLAKE2b-256 f2ca7fef0c1c6d7afa9afc01a84a6ed0ab8a58309b4caaf3465d6248718ac67e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page