README

此插件在您以管理员身份登录时，在应用程序顶部生成一个易于使用的管理栏。

注意：目前这是一个不稳定的 CakePHP 3.x 插件。它目前处于开发中，应被视为实验性的。

安装

您可以使用 composer 将此插件安装到您的 CakePHP 应用程序中。

安装 composer 包的推荐方法是

composer require cakemanager/cakeadmin-adminbar:dev-master

现在使用以下命令加载插件

$ bin/cake plugin load -r -b AdminBar

最后，您需要使用以下方式加载 AdminBar.AdminBar-Component

$this->loadComponent('AdminBar.AdminBar');

设置

您可以在后端的设置页面中激活或停用 AdminBar。

添加新项目

通过 CakePHP 的 Configure 类添加项目。请看以下示例

Configure::write('AdminBar.goto_backend', [
    'on' => [
        'prefix' => ['!admin', '*'],
        'controller' => '*',
        'action' => '*',
    ],
    'label' => 'CakeAdmin Panel',
    'url' => '/admin'
]);

说明

• goto_backend - 项目的名称。应该是唯一的（因为 Configure 类中的覆盖）。
• on - 使用 on 键来验证项目是否应根据当前请求显示。请参阅下面的文档。
• label - 项目的标签。
• url - 用于创建 URL 的字符串或数组。有关所有可用选项，请参阅下面的文档。

on 键

通过 on 键可以验证项目是否应该显示。

• 在 ! 前使用使用的键时（如 'prefix' => '!admin'），当前的 prefix 不应该是 admin。
• 使用名称时（如 'prefix' => 'admin'），当前的 prefix 必须等于 admin。
• 使用 * 时（如 'prefix' => '*'），当前的 prefix 可以是任何内容。
• 当您想根据多个名称进行验证时，应使用数组，如 'prefix' => ['!admin', '*'],。

您可以根据 plugin、prefix、controller、action 和您想验证的任何其他参数进行验证。这意味着当您在路由中定义了 type 参数时，您可以使用以下方式验证 type

Configure::write('AdminBar.custom_type', [
    'on' => [
        'controller' => '*',
        'action' => '*',
        'type' => 'specific'
    ],
]);

url 键

url 键可以是字符串或数组以创建 URL。您可以使用 : 获取请求参数的值。

Configure::write('AdminBar.read_blog', [
    'label' => 'Read Blog',
    'url' => [
        'prefix' => false,
        'plugin' => 'Cms',
        'controller' => 'Blogs',
        'action' => 'view',
        ':pass.1'
    ]
]);

:pass.1 用于获取请求参数的特定值。当这些参数嵌套时，使用 . 来进入它们。回顾我们的 type 示例，您可以使用以下内容

Configure::write('AdminBar.custom_type', [
    'url' => [
        'prefix' => false,
        'plugin' => 'Cms',
        'controller' => 'Blogs',
        'action' => 'view',
        ':type'
    ]
]);

保持联系

如果您需要一些帮助或对此插件有想法，请随时在 Gitter 上聊天。

欢迎提交拉取请求！