Welcome to Flask Gravatar’s documentation!

This is small and simple integration gravatar into flask.

Installation

Install the extension with one of the following commands:

$ easy_install Flask-Gravatar

or alternatively if you have pip installed:

$ pip install Flask-Gravatar

How to Use

Initialize with flask application and default parameters:

gravatar = Gravatar(app,
                    size=100,
                    rating='g',
                    default='retro',
                    force_default=False,
                    force_lower=False,
                    use_ssl=False,
                    base_url=None)

Then in your template:

{{ 'zzz.sochi@gmail.com' | gravatar }}

Bigger and adult:

{{ 'zzz.sochi@gmail.com' | gravatar(size=200, rating='x') }}

Parameters

All parameters are described in gravatar documentation.

API Reference

class flaskext.gravatar.Gravatar(app, size=100, rating='g', default='retro', force_default=False, force_lower=False)

Simple object for create gravatar link.

Parameters:

• app (flask.Flask) – Your Flask app instance
• size (int or str) – Default size for avatar
• rating (str) – Default rating
• default (str) – Default type for unregistred emails
• force_default (bool) – Build only default avatars
• force_lower (bool) – Make email.lower() before build link

__call__(email, **kw)

Build gravatar link.

Parameters:

• email – Email for create link
• kw – Reload defaults

Default parameters. May change in runtime.

size

rating

default

force_default

force_lower

Changelog

0.4.1 2013-11-07

• Python 3 support (pull #9)

0.4.0 2013-08-09

• Add custom url support (pull #7)
• Use setuptools (pull #6)

0.3.0 2013-03-23

• Enable registering multiple times in one process

0.2.4 2012-11-28

• Add init_app method
• Some bugs fixes

0.2.3 2011-11-29

• Add HTTPS suppport

0.2.2 2011-01-10

• First public release
• It’s work