django-staff-toolbar 2.0

django-staff-toolbar

在网页上显示仅限员工使用的控件。

功能

• 链接到当前对象的管理页面。

• 显示工具栏项的完整配置。

• 添加自定义菜单项的API。

安装

首先安装模块，最好是在虚拟环境中

pip install django-staff-toolbar

INSTALLED_APPS += (
    'staff_toolbar',
)

{% load staff_toolbar_tags %}

{% staff_toolbar %}

<link rel="stylesheet" type="text/css" href="{{ STATIC_URL }}staff_toolbar/staff_toolbar.css" />

自定义管理URL

使用以下方式自动检测管理URL

• 模板中的 object 变量。

• 模板中的 view.object 变量。

在某些情况下，这可能不够。当自动检测的“更改对象”链接未指向正确页面时，可以使用两种方法解决此问题

{% set_staff_object page %}

{% set_staff_url %}{% url 'dashboard:catalogue-product' object.id %}{% end_set_staff_url %}

自定义菜单

默认菜单设置如下

STAFF_TOOLBAR_ITEMS = (
    'staff_toolbar.items.AdminIndexLink',
    'staff_toolbar.items.ChangeObjectLink',
    'staff_toolbar.items.LogoutLink',
)

每一行代表一个可调用的函数，使用 (request, context) 来调用。当包含一个元组时，这将转换成一个新的 Group 对象，导致输出中额外出现一个 <ul> 标签。

一个更复杂的示例

from django.core.urlresolvers import reverse_lazy
from django.utils.translation import ugettext_lazy as _
from staff_toolbar import toolbar_item, toolbar_link, toolbar_title, toolbar_literal

STAFF_TOOLBAR_ITEMS = (
    'staff_toolbar.items.AdminIndexLink',
    'staff_toolbar.items.ChangeObjectLink',
    (
        toolbar_title(_("User")),
        toolbar_link(url=reverse_lazy('admin:password_change'), title=_("Change password")),
        'staff_toolbar.items.LogoutLink',
    )
)

toolbar_title() 和 toolbar_item() 函数允许向项目传递额外的参数，而无需在设置中预先加载它们。

也可以直接实例化实际的类，但是这可能会因为导致你的设置模块加载大量其他代码而引发导入错误。以下示例与上一个示例功能相同

from django.core.urlresolvers import reverse_lazy
from django.utils.translation import ugettext_lazy as _
from staff_toolbar.items import AdminIndexLink, ChangeObjectLink, Group, ToolbarTitle, Link, LogoutLink

STAFF_TOOLBAR_ITEMS = (
    AdminIndexLink(),
    ChangeObjectLink(),
    Group(
        ToolbarTitle(_("User")),
        Link(url=reverse_lazy('admin:password_change'), title=_("Change password")),
        LogoutLink(),
    )
)

注意事项

对于具有 SESSION_COOKIE_SECURE = True 的HTTPS站点，工具栏显然不会在由HTTP提供的标准页面上显示。

要么在HTTPS上显示所有页面（毕竟这是正确的做法™），要么请提供一个很好的pull request，以很好地解决这个问题，用于混合站点。

贡献

此模块旨在通用，并易于集成到您的站点中。欢迎提交pull request和改进！

如果您有任何其他有价值的贡献、建议或想法，也请告诉我们！