django-admin-tools 0.9.3

概述

django-admin-tools是为默认django管理界面提供的扩展/工具集合，它包括

• 一个功能齐全且可定制的仪表板；

• 一个可定制的菜单栏；

• 使管理主题更容易的工具。

代码托管在Github。

Django-admin-tools有详细的文档，您可以在在线浏览文档。一个好的开始是阅读快速入门指南。

该项目由David Jean Louis创建，之前托管在Bitbucket。

如果您想讨论django-admin-tools的未来，请加入邮件列表。

要求

django-admin-tools 兼容 Django 1.11 LTS 到 Django 4.0，以及 Python 2.7 和 3.5 及以上版本。

对于较老的 Python 和 Django 版本，请使用 django-admin-tools 的 0.8.1 版本，该版本可在 Pypi 上获取。

安装

要安装 django-admin-tools，请在此目录内运行以下命令：

python setup.py install

如果您有 Python 的 easy_install 工具，也可以输入以下命令来下载和安装，一步到位：

easy_install django-admin-tools

或者如果您使用 pip

pip install django-admin-tools

或者如果您更愿意，可以直接将包含的“admin_tools”目录放置在您的 Python 路径上的某个位置，或者从 Python 路径上的某个位置创建指向它的符号链接；如果您正在使用 Mercurial 检出，这将非常有用。

安装指南可在文档中找到：安装指南

文档

提供了详尽的文档，它是用优秀的 Sphinx 程序 制作的：Extensive documentation

翻译

存在一个针对 django-admin-tools 的 transifex 项目。

截图

django 管理员登录屏幕

管理员索引仪表板

管理员菜单

仪表板模块可以被拖动、折叠、关闭等。

应用索引仪表板

版本 0.9.3，2023 年 8 月 10 日

• 文档修复

• 升级到 jquery-ui 1.13.2

• 修复当 template_name 被给定为 PosixPath 或其他类型时的错误

• 向 dummy.html 添加默认模板名称以满足 django-compressor 的需求

版本 0.9.2，2021 年 12 月 12 日

• 修复对 Django 4.0 的支持

• 与管理员深色模式的兼容性

• 修复了问题 #100（在添加最后一列时的 js 错误）

• 修复了问题 #103（与 django-constance 的兼容性）

版本 0.9.1，2021 年 1 月 12 日

此版本增加了对 django 3.X 版本和未来版本的 support

• 放弃了对 django < 1.11 的 support

• 支持 django 3.X 和未来版本

• 更新 jQuery 和 jQuery UI 到最新版本

版本 0.9.0，2020 年 1 月 19 日

此版本增加了对 Django 2.2 的 support 并修复了各种问题。

• Django 2.2 支持

• Python 3.7 支持

• 更新文档

版本 0.8.1，2017 年 5 月 30 日

此版本增加了对 Django 1.11 的 support 并修复了各种问题。

• Django 1.11 支持

• 添加了应用配置以启用标签覆盖，避免应用名称冲突

• 安全修复：防止通过知道 id 来删除用户书签

• 更好地支持自定义用户模型

• 修复了文档字符串

版本 0.8.0，2016 年 8 月 12 日

此版本增加了对 Django 1.10 的 support 并修复了各种错误和文档问题。

• Django 1.10 支持

• Dashboard pre_content 和 post_content 现在默认接受 HTML

• 使用 staff_member_required 装饰器代替 login_required

• 使用 user.get_username() 代替 user.username

• 修复了 DAT 发布的警告中错误的模板加载器类名

• 修复了文档和文档字符串中的各种错误

版本 0.7.2，2016 年 1 月 14 日

错误修复版本。

• 删除了在某些情况下导致问题的配置检查，我们现在使用内置的 django 系统检查框架

• 从 admin_tools 模板中删除了多余的“trans”调用

• 完全遵循 PEP8 标准

版本 0.7.1，2015 年 11 月 27 日

错误修复版本。此版本修复了与 django.template.loaders.cached.Loader 的不兼容性问题。

版本 0.7.0，2015 年 11 月 5 日

• 重要信息，请阅读：*

从本版本（0.7.0）开始，您必须将 admin_tools.template_loaders.Loader 添加到设置文件中的模板加载器变量中，有关详细信息，请参阅此处：https://django-admin-tools.readthedocs.io/en/latest/configuration.html

变更日志

• 支持 Django 1.9 和新的管理员平面主题

• 增加了一个自定义模板加载器（基于 django-apptemplates），允许我们扩展管理模板而不是覆盖它们

• 修复了许多警告

• 修复了其他一些小问题和错误

版本 0.6.0，2015 年 7 月 7 日

• 非常重要，请务必阅读：*

从本版本（0.6.0）开始，django-admin-tools 不再与 Django 1.6 或更低版本兼容。

使用较旧 Django 版本的用户应使用 pypi 上可用的 0.5.2 版本。

如果您已经使用 django-admin-tools 与 Django <= 1.6，请确保将您的需求文件固定到特定版本，例如：django-admin-tools==0.5.2。如果您不这样做，"pip install –upgrade" 将会破坏您的管理站点。已警告！

现在来看实际的变更日志

• 删除了对 django 1.6 或更低版本的支持

• 添加了对 django 1.8 的支持

• 清理了旧的兼容性代码

• 使用 django 内置的静态文件

• 各种改进和错误修复

版本 0.5.2，2014 年 8 月 11 日

• 添加了对 django 1.5 和 1.6 的支持

• Django 1.7 支持，但迁移仍使用 south

• 添加了对 python 3 的支持

• 添加了一些块以简化模板继承

• 添加了管理命令以删除仪表板首选项

• 修复了问题 #126（feedparser 废弃警告）

• 修复了问题 #133（最近操作链接有不必要的 /admin/ 前缀）

• 在应用列表、菜单和应用程序索引的面包屑中使用 i18n 应用名称

• 在管理头部中使用 user.get_short_name 和 user.get_username（修复 #121）

• 对 AppList 和 ModelList 模块提供了更好的文档字符串

• 在仪表板模块上单击折叠/添加/删除按钮时，不再跳转到页面顶部

感谢所有为这次发布做出贡献的人们。

版本 0.5.1，2013 年 3 月 13 日

错误修复版本，所有使用 django < 1.5 的用户应升级

本版本修复了破坏 LinkList 仪表板模块的 bug（感谢 Iacopo Spalletti 的 pull request）。

版本 0.5.0，2013 年 3 月 6 日

如果您是从旧版本升级，请注意以下信息

从本版本开始，django-admin-tools 需要 Django 1.3 或更高版本。如果您正在运行 Django < 1.3，请勿升级并继续使用 0.4.1 版本。

• 与 Django 1.4 和 Django 1.5 的兼容性

• 升级到最新的 jQuery / jQuery-ui

• 许多错误修复和小的改进

版本 0.4.1，2011 年 11 月 15 日

• 静态文件和 django 1.3 支持

• 修复了模块实例化问题（修复 #65）

• 支持嵌套组并改进了 html id 生成（修复问题 #70）

• 修复了各种 js 和 css 问题

• 添加了芬兰语的翻译并对其他语言的更新

• 更健壮的仪表板布局

• 为 Group 模块添加了 force_show_title 属性

版本 0.4.0，2010 年 12 月 13 日

如果您是从旧版本升级，请注意以下信息

本版 django-admin-tools 引入了对 south 数据库迁移的支持，如果您不使用 south，可以跳过此步骤。

现有 django-admin-tools 应执行以下操作

python manage.py migrate --fake admin_tools.dashboard
python manage.py migrate --fake admin_tools.menu

新用户应执行以下操作

python manage.py migrate admin_tools.dashboard
python manage.py migrate admin_tools.menu

主要变更

• API 的大幅改进（请参阅仪表板和菜单文档以获取详细信息），旧 API 仍然支持，但现在已弃用；

• 添加了 ModelList 菜单项；

• 对自定义和多个管理站点的基本支持；

• 与 django-grappelli 的更好集成；

• 对 django south 的支持。

错误修复和小的变更

• 修复了问题 #40（python 2.5 兼容性）；

• 修复了问题 #49：禁用空组模块的渲染；

• 修复了问题 #51：更健壮的测试运行器；

• 修复了问题 #57 和 #58：更新自定义仪表板和菜单模板文件以反映当前代码；

• 修复了问题 #60：在模块内容中显式设置链接的颜色；

• 一些针对未来 django 1.3 的修复；

• 修复了问题 #61：如果用户尚未保存任何首选项，则创建空的首选项实例。

• 修复了问题 #62：更新基本模板以反映 django 1.2 的更改；

• 修复了各种 js 命名空间污染问题；

• 改进了文档；

• 支持 CZ 语言。

更多信息请参阅： http://bitbucket.org/izi/django-admin-tools/changesets

版本 0.3.0，2010年7月16日

主要变更

• 添加了测试基础设施，代码覆盖率约为70%；

• 导入路径和类名已更改。旧类名和路径已弃用但仍然可用；

• dashboard.modules.AppList，dashboard.modules.ModelList 和 menu.items.AppList 现在可以通过 models 和 exclude 参数显示来自不同应用的任何模型（使用glob语法）。现在保留了顺序。参见 #15；

• 实现了仪表板模块分组：现在您可以在选项卡、手风琴或堆叠布局中分组模块。

错误修复和细微更改

• 将菜单和仪表板模板目录移动到“admin_tools”目录，以避免与其他应用程序（例如：django-cms）的名称冲突，参见： http://github.com/digi604/django-cms-2.0/issues/issue/397/；

• 修复了书签错误。保存的URL已被url编码，因此我们需要在保存之前对其进行解码。在 BookmarkForm 中添加了 clean_url 方法。修复了 #25；

• 根据 INSTALLED_APPS 的内容条件性地构建 urlpatterns；

• 更好地显示选定的菜单项；

• 避免为检索仪表板首选项发起无用的ajax GET请求；

• 升级了jquery和jquery ui，并将文件重命名为更通用的名称；

• 如果发生 NoReverseError，则不显示书签表单。这破坏了 django.contrib.auth 单元测试；

• 修复了删除书签表单的URL查找；

• 修复了问题 #26（菜单栏对非工作人员用户显示）并更新了模板以匹配 django 1.2 模板；

• 修复了问题 #29：Django 1.2 管理员基本模板更改；

• 更改了加载js文件的方式，希望现在它们是以同步方式加载的（修复了问题 #32）；

• 修复了问题 #33：不应显示空的应用列表菜单项；

• 修复了问题 #34：无法将模块拖动到空列中；

• 修复了问题 #35（菜单的错误文档字符串）。

新的类名和路径

*admin_tools.dashboard*

• admin_tools.dashboard.models.Dashboard => admin_tools.dashboard.Dashboard

• admin_tools.dashboard.models.DefaultIndexDashboard => admin_tools.dashboard.DefaultIndexDashboard

• admin_tools.dashboard.models.DefaultAppIndexDashboard => admin_tools.dashboard.DefaultAppIndexDashboard

• admin_tools.dashboard.models.AppIndexDashboard => admin_tools.dashboard.AppIndexDashboard

• admin_tools.dashboard.models.DashboardModule => admin_tools.dashboard.modules.DashboardModule

• admin_tools.dashboard.models.AppListDashboardModule => admin_tools.dashboard.modules.AppList

• admin_tools.dashboard.models.ModelListDashboardModule => admin_tools.dashboard.modules.ModelList

• admin_tools.dashboard.models.LinkListDashboardModule => admin_tools.dashboard.modules.LinkList

• admin_tools.dashboard.models.FeedDashboardModule => admin_tools.dashboard.modules.Feed

*admin_tools.menu*

• admin_tools.menu.models.Menu => admin_tools.menu.Menu

• admin_tools.menu.models.DefaultMenu => admin_tools.menu.DefaultMenu

• admin_tools.menu.models.MenuItem => admin_tools.menu.items.MenuItem

• admin_tools.menu.models.AppListMenuItem => admin_tools.menu.items.AppList

• admin_tools.menu.models.BookmarkMenuItem => admin_tools.menu.items.Bookmarks

版本 0.2.0，2010年3月15日

• 书签现在保存在数据库中（修复了问题 #20，感谢 @alexrobbins）；

• 仪表板首选项也保存在数据库中；

• 添加了对 django-staticfiles STATIC_URL 设置的支持（修复了问题 #21，感谢 @dstufft）；

• 修复了问题 #23：在Windows上 render_theming_css 标签不起作用；

• 添加了波兰语、意大利语、希腊语和巴西语本地化；

• 更新了文档。

0.2.0中的不兼容更改

现在，django-admin-tools将菜单和仪表板首选项存储在数据库中，因此您需要运行syncdb并将django-admin-tools urls添加到您的urlconf中。这些步骤在文档中有详细描述。您还需要将 admin_tools 添加到您的 INSTALLED_APPS 中以使本地化工作（在先前的版本中未记录此信息）。

版本 0.1.2，2010年2月13日

• 修复了文档问题；

• 添加了地区设置；

• 修复问题 #9：当 feedparser 未安装时不会失败；

• 修复问题 #5：在 cookies 中实现了仪表板布局的持久化；

• 在默认仪表板中默认启用所有模块；

• 修复在 app_index 中显示的最近操作日志条目的 URL；

• 添加了“书签”菜单项及其管理代码；

• 修复了与 django 1.2 相关的 jQuery 问题。

版本 0.1.1，2010 年 2 月 10 日

• 修复问题 #2：模板标签库具有通用名称；

• 更改了选择仪表板的方式，不再依赖于请求变量，而是通过模板标签传递额外参数（修复问题 #3）；

• 修复了 MANIFEST.in（修复问题 #1）；

• 改进了 setup.py 文件。

版本 0.1.0，2010 年 2 月 10 日

• 初始发布