Django Admin Shortcuts

这是什么？

这是一个简单的仪表盘应用程序，它向您的Django管理首页添加快捷方式。这里的重点是简单！

为什么存在？

因为有些人指出，有时在管理首页上找到所需的应用程序有点困难。

“那么为什么我们不稍微定制一下管理网站呢？”

“不，我不想费心编辑模板或设置一个复杂的仪表盘应用程序……”

好吧，幸运的是django-admin-shortcuts在这里，因为它只需五分钟的时间，就可以从旧的无聊管理界面转换到这个应用程序的卓越工程品质。

如何使用它？

1. pip install django-admin-shortcuts

2. 将 'admin_shortcuts' 添加到您的 INSTALLED_APPS，在 'django.contrib.admin' 之前 <-- 重要

3. 将 ADMIN_SHORTCUTS 添加到您的设置中

   例如

ADMIN_SHORTCUTS = [
    {
        'title': 'Authentication',
        'shortcuts': [
            {
                'title': 'Groups',
                'url_name': 'admin:auth_group_changelist',
                               'has_perms': ['example.change_group', 'example.delete_group'],
            },
            {
                'title': 'Add user',
                'url_name': 'admin:auth_user_add',
                'test_func': 'example.utils.has_perms_to_users',
            },
        ]
    },
]

在哪里 ...

• 必需的 url_name 是一个将使用Django的反向URL方法解析的名称（请参阅Django文档 https://docs.django.ac.cn/en/5.0/ref/contrib/admin/#admin-reverse-urls）
• 可选的 app_name 是用于URL反转的管理应用程序的名称。如果您在 urls.py 中只有一个管理网站，可以安全忽略此选项
• 可选的 url 是将覆盖 url_name 的直接链接
• 可选的 url_extra 是附加在URL末尾的额外内容（如用于预过滤管理视图的GET数据）
• 可选的 title 是快捷方式的标题
• 可选的 count 和 count_new 是指向您项目中函数的路径，该函数返回一些有趣的东西（如所有产品的数量或所有待处理订单的数量）。该函数可以可选地接受一个参数，即当前的Django HttpRequest对象。
• 可选的 test_func 是指向项目中返回布尔值的函数的路径。如果为 True，则显示快捷方式。就像上面一样，此函数可以可选地接受一个名为 request 的参数。
• 可选的 has_perms 是一个表示显示快捷方式所需内置管理员权限的字符串列表。
• 可选的 open_new_window 设置链接是否在新窗口中打开（默认为 False）
• 可选的 icon 是一个表情符号（如果您没有指定，神奇的小马会为您做到这一点）

4. 利润！！

5. 可选地，还可以将 ADMIN_SHORTCUTS_SETTINGS 添加到您的设置中

ADMIN_SHORTCUTS_SETTINGS = {
    'open_new_window': False,
}

在哪里 ...

• 可选的 open_new_window 使所有快捷方式都在新窗口中打开

上图中所使用的设置是什么？

ADMIN_SHORTCUTS = [
    {
        'shortcuts': [
            {
                'url': '/',
                'open_new_window': True,
            },
            {
                'url_name': 'admin:logout',
            },
            {
                'title': 'Users',
                'url_name': 'admin:auth_user_changelist',
                'count': 'example.utils.count_users',
            },
            {
                'title': 'Groups',
                'url_name': 'admin:auth_group_changelist',
                'count': 'example.utils.count_groups',
                'has_perms': ['example.change_group', 'example.delete_group'],
            },
            {
                'title': 'Add user',
                'url_name': 'admin:auth_user_add',
                'test_func': 'example.utils.has_perms_to_users',
                'has_perms': 'example.utils.has_perms_to_users',
            },
        ]
    },
    {
        'title': 'CMS',
        'shortcuts': [
            {
                'title': 'Pages',
                'url_name': 'admin:index',
            },
            {
                'title': 'Files',
                'url_name': 'admin:index',
                'icon': '❤️'
            },
            {
                'title': 'Contact forms',
                'url_name': 'admin:index',
                'count_new': '3',
            },
            {
                'title': 'Products',
                'url_name': 'admin:index',
            },
            {
                'title': 'Orders',
                'url_name': 'admin:index',
                'count_new': '12',
            },
        ]
    },
]
ADMIN_SHORTCUTS_SETTINGS = {
    'open_new_window': False,
}

我想改变东西的外观

• 要更改 CSS，请覆盖 templates/admin_shortcuts/base.css 模板
• 要更改自动选择的图标，请指定 ADMIN_SHORTCUTS_ICON_MAPPINGS 中的映射