《django-tracking》项目技术文档

1. 安装指南

首先，确保你的环境中安装了现代版本的Django。《django-tracking》可以在Django 1.0 alpha 2和beta 1版本上运行。以下安装方式可供选择：

• 使用pip命令：

pip install django-tracking

• 使用easy_install命令：

easy_install django-tracking

• 从BitBucket、GitHub或Google Code检出源代码：

hg clone http://bitbucket.org/codekoala/django-tracking
git clone http://github.com/codekoala/django-tracking.git
hg clone http://django-tracking.googlecode.com/hg/ django-tracking

• 下载最新的.tar.gz文件并解压到你指定的目录。

2. 项目的使用说明

使用《django-tracking》项目前，需要完成以下配置：

• 在settings.py中的INSTALLED_APPS列表中添加tracking。
• 运行manage.py syncdb以创建必要的数据库表。

根据你的需求，以下几种中间件可以使用：

• VisitorTrackingMiddleware：追踪访问者的信息，需要放在AuthenticationMiddleware之后。
• VisitorCleanUpMiddleware：自动清理旧的访问者信息。
• BannedIPMiddleware：禁止特定的IP地址访问网站。

若要在模板中使用相关标签，确保django.core.context_processors.request在TEMPLATE_CONTEXT_PROCESSORS中。

3. 项目API使用文档

《django-tracking》项目提供了模板标签供在模板中使用：

• {% visitors_on_site as visitors %}：获取当前网站活跃用户数量。
• {% visitors_on_page as same_page %}：获取当前页面的活跃用户数量。

通过在settings.py中设置NO_TRACKING_PREFIXES可以排除某些区域的追踪。此外，可以在Django管理界面中设置不追踪特定的用户代理（User-Agent）。

4. 项目安装方式

具体安装方式已在“安装指南”中详细说明，以下是简要步骤：

• 添加tracking到INSTALLED_APPS。
• 运行syncdb创建数据库表。
• 根据需要添加中间件到MIDDLEWARE_CLASSES。
• 配置相关设置，如GOOGLE_MAPS_KEY（如果使用地图功能）等。

通过以上步骤，你可以成功集成《django-tracking》到你的Django项目中，并利用它提供的功能来追踪和分析你的网站访问者。