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
Fork me on GitHub