Django-admin-tools-stats 安装与配置指南

概述

Django-admin-tools-stats 是一个强大的 Django 扩展，它为 Django 管理后台提供了丰富的数据统计和可视化功能。本文将详细介绍如何安装和配置这个工具，帮助开发者快速集成到自己的 Django 项目中。

安装前准备

在开始安装 Django-admin-tools-stats 之前，需要确保系统满足以下依赖条件：

1. Django 框架：版本需不低于 1.4
2. Python-dateutil：版本需不低于 1.5，用于扩展标准 datetime 模块
3. Django-admin-tools：Django 管理工具集合
4. Django-cache-utils：简化缓存相关操作的实用工具
5. Django-jsonfield：版本需不低于 0.6，用于模型中的 JSON 字段
6. Django-nvd3：版本需不低于 0.5.0，基于 NVD3 的图表库封装
7. Python-memcached：版本需不低于 1.47，用于与 memcached 交互

安装步骤

推荐使用 pip 工具一次性安装所有依赖项：

pip install -r requirements.txt

项目配置

1. 基础配置

首先需要配置 django-admin-tools，确保其正常运行。然后，在项目的 settings.py 文件中添加以下应用：

INSTALLED_APPS = (
    'admin_tools_stats',
    'django_nvd3',
)

2. 仪表盘配置

在 dashboard.py 文件中添加以下代码，用于集成统计图表功能：

from admin_tools_stats.modules import DashboardCharts, get_active_graph

# 添加应用列表模块
self.children.append(modules.AppList(
    _('Dashboard Stats Settings'),
    models=('admin_tools_stats.*', ),
))

# 添加图表模块
graph_list = get_active_graph()
for i in graph_list:
    kwargs = {}
    kwargs['graph_key'] = i.graph_key
    kwargs['require_chart_jscss'] = False

    for key in context['request'].POST:
        if key.startswith('select_box_'):
            kwargs[key] = context['request'].POST[key]

    self.children.append(DashboardCharts(**kwargs))

3. 数据库同步

运行以下命令创建必要的数据库表：

python manage.py syncdb

管理后台配置

完成上述步骤后，可以通过 Django 管理后台进行进一步配置：

1. 访问管理后台
2. 配置"Dashboard Stats Criteria"（统计条件）
3. 配置"Dashboard Stats"（统计图表）

注意事项

1. 确保所有依赖项版本符合要求，否则可能导致兼容性问题
2. 在生产环境中，建议配置适当的缓存策略以提高性能
3. 图表功能依赖于 JavaScript 和 CSS 资源，确保前端资源正确加载

通过以上步骤，开发者可以顺利将 Django-admin-tools-stats 集成到项目中，为管理后台添加强大的数据统计和可视化功能。