跳转到主要内容

django-avatar的分支,用于GeoNode

项目描述

基本要求

要将 geonode-avatar 集成到您的站点中,需要相对较少的步骤。最小集成可以这样做

  1. 在您的设置文件中,将此应用程序列入 INSTALLED_APPS 部分。您的设置文件可能看起来像这样

    INSTALLED_APPS = (
        # ...
        'avatar',
    )
  2. 将分页URL添加到根URL配置文件末尾。您的URL配置看起来可能像这样:

    urlpatterns = patterns('',
        # ...
        (r'^admin/(.*)', admin.site.root),
        (r'^avatar/', include('avatar.urls')),
    )
  3. 在模板导航方案中的某个位置,链接到更改头像页面

    <a href="{% url avatar_change %}">Change your avatar</a>
  4. 无论您想在何处显示用户的头像,首先加载头像模板标签

    {% load avatar_tags %}

    然后,使用avatar标签显示默认大小的头像

    {% avatar user %}

    或者明确指定大小(以像素为单位)

    {% avatar user 65 %}
  5. 可选地自定义avatar/change.htmlavatar/confirm_delete.html以符合您网站的风格和感觉。

视图

本应用程序只有两个视图:一个用于更改用户的头像,另一个用于删除用户的头像。

更改头像

实际的视图函数位于avatar.views.change,可以通过URL名称avatar_change引用。它接受两个关键字参数:extra_contextnext_override。如果提供了extra_context,则该上下文将放置到模板的上下文中。

如果提供了next_override,则用户在表单提交后将重定向到指定的URL。否则,用户将被重定向到request.POST中的next参数指定的URL。如果request.POST中没有next参数,将搜索request.GET。如果request.GET中没有next参数,将检查HTTP_REFERER标题。如果该标题不存在,用户将被重定向回当前URL。

删除头像

实际的视图函数位于avatar.views.delete,可以通过URL名称avatar_delete引用。它接受与avatar.views.change相同的两个关键字参数,并且遵循相同的重定向规则。

模板标签

要开始使用这些模板标签,您必须首先将标签加载到模板渲染系统中

{% load avatar_tags %}

{% avatar_url user [size in pixels] %}

渲染给定用户的头像URL。用户可以是django.contrib.auth.models.User对象实例或用户名。

{% avatar user [size in pixels] %}

渲染给定用户指定大小的HTMLimg标签。用户可以是django.contrib.auth.models.User对象实例或用户名。

{% render_avatar avatar [size in pixels] %}

给定实际的avatar.models.Avatar对象实例,渲染代表请求大小的HTMLimg标签。

全局设置

有一些设置可以轻松自定义网站上的头像。以下列出这些设置

AUTO_GENERATE_AVATAR_SIZES

一个表示上传时生成头像大小的整数可迭代对象。这可以在预先生成调整大小版本时节省渲染时间。默认为(80,)

AVATAR_RESIZE_METHOD

根据PIL提供的选项来调整图像大小的方法。默认为Image.ANTIALIAS

AVATAR_STORAGE_DIR

MEDIA_ROOT下的目录用于存储图像。如果使用非文件系统存储设备,这将被简单地附加到文件名开头。

AVATAR_GRAVATAR_BACKUP

一个布尔值,用于确定是否在系统中找不到给定用户的Avatar实例时默认使用Gravatar服务。默认为True。

AVATAR_DEFAULT_URL

如果AVATAR_GRAVATAR_BACKUP设置为False且在系统中找不到给定用户的Avatar实例时,默认使用的URL。

管理命令

本应用程序包含一个管理命令:rebuild_avatars。它不接受任何参数,并且当运行时,将根据《AUTO_GENERATE_AVATAR_SIZES》设置中指定的像素大小重新渲染所有头像缩略图。

项目详情


下载文件

下载适用于您的平台文件。如果您不确定选择哪个,请了解更多关于安装包的信息。

源分发

此版本没有提供源分发文件。请参阅生成分发存档教程

构建分发

geonode_avatar-5.0.8-py2.py3-none-any.whl (60.1 kB 查看哈希值)

上传时间: Python 2 Python 3

由以下组织支持