**Django Fluent Dashboard安装与使用指南**

Django Fluent Dashboard安装与使用指南

django-fluent-dashboardAn improved django-admin-tools dashboard for Django projects项目地址:https://gitcode.com/gh_mirrors/dj/django-fluent-dashboard

1. 目录结构及介绍

django-fluent-dashboard是为Django框架设计的一个定制化后台管理仪表盘模块，基于django-admin-tools构建。下面是该项目的基本目录结构概览及其简介：

.
├── docs                  # 文档目录，包括API说明和用户手册。
├── django-fluent-dashboard  # 核心源代码包。
│   ├── fluent_dashboard   # 包含自定义仪表盘类和其他相关组件。
│   │   ├── __init__.py
│   │   ├── dashboard.py   # 实现了如FluentIndexDashboard等关键类。
│   ├── tests              # 单元测试目录。
├── setup.py               # 项目打包和安装脚本。
├── README.rst             # 项目快速入门和概述。
├── AUTHORS                # 作者列表。
├── CHANGES.rst            # 变更日志。
└── ...                    # 其他常规Python项目文件如gitignore, pyproject.toml等。

重点文件说明:

• dashboard.py: 包含核心类FluentIndexDashboard和FluentAppIndexDashboard, 这些类定义了仪表盘的行为和布局。
• __init__.py: 确保包可以被导入。

2. 项目的启动文件介绍

在使用django-fluent-dashboard时，实际上不会直接操作一个特定的“启动文件”，因为它是作为Django应用集成到你的现有项目中的。不过，集成的关键在于修改Django项目的settings.py文件来激活此插件。你需要添加fluent_dashboard至INSTALLED_APPS中，并设置ADMIN_TOOLS_INDEX_DASHBOARD指向fluent_dashboard.dashboard.FluentIndexDashboard，以替换默认的后台首页。

示例配置片段如下：

INSTALLED_APPS += (
    'fluent_dashboard',  # 添加到已有的应用程序列表中
    'admin_tools',
    'admin_tools.theming',
    'admin_tools.menu',
    'admin_tools.dashboard',  # 确保这些依赖项也存在
)

ADMIN_TOOLS_INDEX_DASHBOARD = 'fluent_dashboard.dashboard.FluentIndexDashboard'

3. 项目的配置文件介绍

主要配置 - settings.py

主要的配置发生在你的Django项目的settings.py文件中。除了将fluent_dashboard添加到INSTALLED_APPS外，还需配置以下几点：

• ADMIN_TOOLS_INDEX_DASHBOARD: 指定使用的仪表盘类，默认情况下为FluentIndexDashboard。
• （可选）FLUENT_DASHBOARD_APP_GROUPS: 自定义应用分组显示方式，允许通过设置调整后台管理界面中应用程序的组织结构。

示例配置：

# 在settings.py中加入以下配置
INSTALLED_APPS = [
    # ...其他应用...
    'fluent_dashboard', 
    # 不要忘记admin相关的依赖
] 

ADMIN_TOOLS_INDEX_DASHBOARD = 'fluent_dashboard.dashboard.FluentIndexDashboard'

# 如有需要，可配置应用分组
FLUENT_DASHBOARD_APP_GROUPS = {
    'My Custom Group': ('app1', 'app2'),
}

通过这样的配置，你可以获得一个更加定制化的Django管理界面，提升用户体验和管理效率。

---

以上就是关于django-fluent-dashboard的基础集成和配置指导。确保按照步骤操作，并根据项目需求适当调整配置。记得在开发环境中充分测试以避免生产环境的问题。

django-fluent-dashboardAn improved django-admin-tools dashboard for Django projects项目地址:https://gitcode.com/gh_mirrors/dj/django-fluent-dashboard