django-fluent-dashboard 2.0

配置

将以下设置添加到settings.py

INSTALLED_APPS += (
    'fluent_dashboard',

    # enable the admin
    'admin_tools',
    'admin_tools.theming',
    'admin_tools.menu',
    'admin_tools.dashboard',
    'django.contrib.admin',
)

ADMIN_TOOLS_INDEX_DASHBOARD = 'fluent_dashboard.dashboard.FluentIndexDashboard'
ADMIN_TOOLS_APP_INDEX_DASHBOARD = 'fluent_dashboard.dashboard.FluentAppIndexDashboard'
ADMIN_TOOLS_MENU = 'fluent_dashboard.menu.FluentMenu'

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': (),
        'OPTIONS': {
            'loaders': (
                ...
                'admin_tools.template_loaders.Loader',  # Add this line!
            ),
        }
    }
]

admin_tools.theming和admin_tools.menu应用程序是可选的。

添加到urls.py

urlpatterns += [
    url(r'^admintools/', include('admin_tools.urls')),
]

之后可以创建admin_tools的数据库表

./manage.py migrate

自定义仪表板

添加额外图标

FLUENT_DASHBOARD_APP_ICONS设置是一个字典，允许您为自定义模块定义额外图标并覆盖默认设置。例如

FLUENT_DASHBOARD_APP_ICONS = {
    'auth/user': "user.png"
}

图标应为48x48像素。图标名称以3种不同的格式处理

• 绝对URL直接传递。

• 带有/字符的图标名称相对于STATIC_URL。

• 不带任何路径信息的图标名称相对于当前主题文件夹，例如：STATIC_URL/fluent_dashboard/themename/

组织应用程序组

FLUENT_DASHBOARD_APP_GROUPS设置定义了哪些应用程序被分组。例如

FLUENT_DASHBOARD_APP_GROUPS = (
    (_('CMS'), {
        'models': (
            'cms.*',
            'pages.*',
            'fiber.*',
        ),
        'module': 'CmsAppIconList',
        'collapsible': False,
    }),
    (_('Interactivity'), {
        'models': (
            'django.contrib.comments.*',
            'form_designer.*'
            'threadedcomments.*',
            'zinnia.*',
        ),
    }),
    (_('Administration'), {
        'models': (
            'django.contrib.auth.*',
            'django.contrib.sites.*',
            'google_analytics.*',
            'registration.*',
        ),
    }),
    (_('Applications'), {
        'models': ('*',),
        'module': 'AppList',
        'collapsible': True,
    }),
)

有关这些选项和附加设置的详细信息，请参阅文档。

显示缓存状态

此应用程序提供了对dashboardmods包的可选支持，可以显示缓存统计信息。可以使用以下方式安装

pip install dashboardmods

应用程序需要配置缓存后端，例如

INSTALLED_APPS += (
    'dashboardmods',
)

# Example Memcache configuration:
CACHES = {
    'default': {
        'BACKEND': 'django.core.cache.backends.memcached.MemcachedCache',
        'KEY_PREFIX': 'mysite.production',
        'LOCATION': '127.0.0.1:11211',
        'TIMEOUT': 24*3600,
    },
}

# Optional, example Varnish configuration:
VARNISH_MANAGEMENT_ADDRS = ('127.0.0.1:6082',)

当未配置缓存时，模块将不会显示。

相关应用程序

以下包提供额外的模块，可以在仪表板上显示

• django-admin-user-stats将图表添加到仪表板，以查看上个月注册的用户数量。

• django-admin-tools-stats是从上一个包派生出来的，并为任何模型类型添加了可配置的图表。

• dashboardmods被检测到以显示缓存统计信息，但还提供了一个配置RSS源模块。

• django-admin-tools不应被遗忘，因为它还提供了RSS源、链接列表和标签分组模块。

可以通过继承FluentIndexDashboard类并使用ADMIN_TOOLS_INDEX_DASHBOARD设置将其指向该模块来集成这些模块。

贡献

本模块旨在通用。如果您对它有任何不满，或者认为它不够灵活，请告诉我们。我们很高兴改进它！

如果您有任何其他有价值的贡献、建议或想法，也请告诉我们，我们将进行研究。也欢迎提交拉取请求。:-)