davidyell / nice-admin
一个组合插件,用于改善管理员区域索引视图的外观。
Requires
- php: >=5.6.0
- cakephp/cakephp: ~3.4
Requires (Dev)
- cakephp/cakephp-codesniffer: ^2.0
- phpunit/phpunit: ^4.8
Suggests
- twbs/bootstrap: Twitter Bootstrap front-end framework, for styles and layout.
README
此插件旨在使从CakePHP构建的管理区域看起来更美观,并更容易使用和理解。
需求
- CakePHP 3.x
- PHP 5.4.16+
- TwitterBootstrap(可选 - 仅用于样式)
你将获得哪些内容?
ActionButtons Helper
用于将索引视图中“操作”单元格的内容替换为按钮而不是文本链接的辅助工具。
StatusLights Helper
用于将索引视图中的状态列替换为基于状态_id的漂亮彩色标签。
布尔值 Helper
这将更改布尔显示字段为勾选(✔)和叉号(✘)而不是1/0。
获取代码
composer require davidyell/nice-admin:dev-master
安装
需要使用 Plugin::load('NiceAdmin')
在您的 /config/bootstrap.php
中加载该插件。
使用方法
要使用辅助工具,您需要将它们添加到您的 AppView
中的辅助工具数组。
$this->loadHelper('NiceAdmin.StatusLights', $options); $this->loadHelper('NiceAdmin.Actions'); $this->loadHelper('NiceAdmin.Gravatar'); $this->loadHelper('NiceAdmin.Boolean');
加载 StatusLights Helper
您可以将选项数组传递给 StatusLights Helper。数组的关键是 status_id
,然后是一个包含要显示的 label
和输出项的 class
的数组。
$options = [ 1 => [ 'label'=>'Live', 'class'=>'label label-success' ], 2 => [ 'label'=>'Inactive', 'class'=>'label label-inverse' ], 3 => [ 'label'=>'Deleted', 'class'=>'label' ] );
下面的示例复制了 Helper 中的默认设置。因此,如果您对默认设置感到满意,则不需要传递这些选项。
StatusLights Helper
这将把状态链接转换为易于视觉识别的标签。
<td>
<?= $this->StatusLights->status($entity->id); ?>
</td>
ActionButtons Helper
您可以选择输出按钮或图标,具体取决于您需要哪种。默认情况下,Helper 会输出所有三个链接作为按钮。传递包含您想要输出的按钮的 v
、e
和/或 d
的数组。对于“查看”、“编辑”和“删除”。然后您需要传递控制器。最后一个选项是 icons
或 buttons
。
<td class="actions">
<?php echo $this->Actions->actions($entity->id, ['e','d'], 'myController', 'icons');?>
</td>
加载 Boolean Helper
类似于StatusLights辅助工具,您可以传递一个选项数组来自定义输出显示。
$optons = 1 => [ // true 'class'=>'badge badge-success', 'display'=>'✔' ], 0 => [ // false 'class'=>'badge badge-important', 'display'=>'✘' ] )
布尔辅助工具
<?= $this->Boolean->display(1); ?>
它看起来像什么?
进一步开发
告诉我您想添加的功能,或者随时分叉并创建一个拉取请求。
许可证
本作品受Creative Commons Attribution-ShareAlike 3.0 Unported License许可。