对Django的重要支持。功能助手方法,模板标签和一个完整的测试套件!
django-gravatar2的Python项目详细描述
一个轻量级的django gravatar应用程序。包括用于在模板代码之外与Gravatar交互的帮助程序方法。
如果你喜欢这个图书馆,而且它节省了你一些时间,请考虑 以Gittip donation支持进一步的开发!
功能
- 构建GravaTar URL并检查现有Gractar 的电子邮件的助手方法
- 用于生成Gravatar URL或Gravatar<;img>;标记的模板标记。
- 全套测试套件!
安装
从pypi安装:
您可以直接从github安装应用程序:
$ pip install git+git://github.com/twaddington/django-gravatar.git#egg=DjangoGravatar
或者,现在可以直接从pypi安装!
$ pip install django-gravatar2
确保将django-gravatar2安装为 还有其他几个不兼容的django gravatar库可用。
在“设置”中将django_gravatar添加到已安装的应用程序中。py:
INSTALLED_APPS = ( # ... 'django_gravatar', )
基本用法
在代码中使用:
from django_gravatar.helpers import get_gravatar_url, has_gravatar, get_gravatar_profile_url, calculate_gravatar_hash url = get_gravatar_url('alice@example.com', size=150) gravatar_exists = has_gravatar('bob@example.com') profile_url = get_gravatar_profile_url('alice@example.com') email_hash = calculate_gravatar_hash('alice@example.com')
在模板中使用:
{% 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" /> {% gravatar_profile_url user.email %} # https://secure.gravatar.com/hash
配置
可以在settings.py中配置以下选项:
gravatar_url gravatar基url。默认为“http://www.gravatar.com/”
gravatar_secure_url gravatar base安全https url。默认为“https://secure.gravatar.com/”
Gravatar_默认的Gravatar大小(像素)。默认为“80”
gravatar_default_image一个图像url或以下之一:“mm”、“identicon”、“monsterid”、“wavatar”、“retro”。默认为“mm”
gravatar_default_rating以下之一:“g”、“pg”、“r”、“x”。默认为“g”
gravatar_default_secure默认情况下为true使用https,普通http为false。默认为真
贡献
请随意fork django-gravatar 在Github!我们很乐意看到你的请求。请一定要跑 在提交修补程序之前进行测试。