用于django项目的改进django管理工具仪表板
django-fluent-dashboard的Python项目详细描述
Django Fluent仪表板
fluent_dashboard模块在 django-admin-tools(docs)。
django-admin-tools包提供了替换标准django的默认机制。 管理主页和一个基于小部件的仪表板。fluent_dashboard模块对此进行了扩展, 通过提供额外的小部件(称为“模块”),例如:
- 管理员主页的“图标列表”模块。
- 管理员主页的“欢迎”模块。
- 管理主页的可配置模块布局,通过settings.py。
- “返回站点”链接。
- 一个可选的“缓存统计”模块。
文档可以在以下位置找到:https://django-fluent-dashboard.readthedocs.io/
屏幕截图
安装
首先安装模块,最好是在虚拟环境中。它可以从pypi安装:
pip install django-fluent-dashboard
或者可以安装当前文件夹:
pip install .
配置
将以下设置添加到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像素。 图标名称有三种不同的格式:
- 绝对url按原样传递。
- 带有/字符的图标名与STATIC_URL相对。
- 没有任何路径信息的图标名与当前主题文件夹相关,例如静态URL/fluent\u dashboard/主题名
组织应用程序组
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,}),)
有关这些选项和其他设置的详细信息,请参见documentation。
显示缓存状态
此应用程序具有对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',)
未配置缓存时,模块将不会显示该缓存。
贡献
本模块设计为通用模块。万一你有什么不喜欢的, 或者认为它不够灵活,请让我们知道。我们很乐意改进它!
如果你有其他有价值的贡献、建议或想法, 请也让我们知道,因为我们会调查的。 也欢迎拉取请求。:-)