为Django项目提供Clicky分析
项目描述
django-clicky应用程序将Clicky分析集成到Django项目中。
概述
Clicky是一个在线网站分析工具。它与Google Analytics类似,提供有关谁访问您的网站以及他们正在做什么的统计数据。Clicky提供实时数据,并设计得非常易于使用。此Django应用程序提供了一个模板标签,可以将跟踪代码添加到HTML模板中。
安装
要安装django-clicky,只需将django_clicky包放置在Python路径上的某个位置。应用程序在项目的settings.py文件中进行配置。为了使用模板标签,必须将django_clicky包包含在INSTALLED_APPS列表中
INSTALLED_APPS = [ ... 'django_clicky', ... ]
您在CLICKY_SITE_ID设置中设置您的Clicky站点ID
CLICKY_SITE_ID = '12345678'
(您可以在Clicky账户网站首选项页面上的信息选项卡中找到站点ID。)
使用
django-clicky应用程序目前提供了一个跟踪访客点击的模板标签。要在模板中使用此标签,首先通过添加{% load clicky %}在顶部加载django-clicky模板库。
跟踪访客点击
Clicky使用JavaScript跟踪每个访问者的点击操作。标签 track_clicky 在HTML页面中插入跟踪代码。Clicky网页建议在关闭 </body> HTML标签之前直接添加代码。
... {% track_clicky %} </body> </html>
模板标签添加的JavaScript代码是异步的,适用于纯HTTP和安全的HTTPS页面。它还包含后备HTML代码,使用 <a> 和 <img> 标签跟踪禁用JavaScript的浏览器。如果您想跳过此后备代码(例如,如果您想将其添加到HTML头部部分),可以使用 CLICKY_RENDER_NON_JS_CODE 设置。
CLICKY_RENDER_NON_JS_CODE = False
Clicky数据可以通过 自定义属性 进行注释。最明显有用的信息是访问者是否为登录用户。模板标签 track_clicky 将自动提供访问者用户名,如果用户已登录Django。
忽略内部访问者
通常,您不希望跟踪来自您的开发或内部IP地址的点击。因此,您可以设置 CLICKY_INTERNAL_IPS 为一个列表或元组,其中包含模板标签不会渲染的地址。
CLICKY_INTERNAL_IPS = ['192.168.45.2', '192.168.45.5']
如果您已经使用了 INTERNAL_IPS 设置,可以将Clicky内部地址设置为该值。从2.0.0版开始,这是默认设置。
变更日志
- 1.2.1
停止开发。请使用django-analytical中的Clicky模块。
- 1.2.0
自动跟踪登录用户。
- 1.1.0
添加了 CLICKY_INTERNAL_IPS 设置。
- 1.0.0
初始发布。