README

一个使用 Twitter Bootstrap 制作 CakePHP 3 管理模板的自定义主题，使用 CakePHP Bake 插件。

要求

CakePHP 3
PHP 5.6+

是什么？

这是一个用于 CakePHP/Bake 插件的主题，可以对生成的代码进行自定义。我创建它是因为我不喜欢默认的 bake 主题，或者它输出操作侧边栏的事实。

此外，我倾向于使用 Twitter Bootstrap 来制作我的管理区域，因此这个主题将利用这个前端框架。

安装

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

安装 composer 软件包的推荐方法是使用：

composer require davidyell/nice-admin-bake-scripts

设置

在您的 config/bootstrap.php 中，您需要使用 Plugin::load('NiceAdminBakeTheme'); 加载插件

在您的管理布局中，如果您使用 Twitter Bootstrap，则需要包含主题和javascript。此片段还包括 jQuery，因此如果您已经加载了它，请删除该行。

// In the head of your layout
<?= $this->Html->css([
    '//maxcdn.bootstrap.ac.cn/bootstrap/3.3.5/css/bootstrap.min.css',
    '//maxcdn.bootstrap.ac.cn/bootstrap/3.3.5/css/bootstrap-theme.min.css'
]) ?>

// Before your script block
<?= $this->Html->script([
    '//ajax.googleapis.ac.cn/ajax/libs/jquery/3.2.1/jquery.min.js',
    '//maxcdn.bootstrap.ac.cn/bootstrap/3.3.5/js/bootstrap.min.js'
]);?>

可选的附加组件

如果您想使用 Twitter Bootstrap 制作所有表单，请确保在您的应用程序中启用 friendsofcake/bootstrap-UI 并在您的 src/View/AppView.php 中加载辅助程序。了解更多关于在他们的自述文件中安装 bootstrap-ui 的信息。

这可以很容易地与 friendsofcake/crud 插件结合使用，在约 5 分钟内基本完成整个基本管理！

包含了一个基本的样式表，用于修复一些小问题。您可以将样式表符号链接到您的自己的 webroot/css 并从那里包含它，使用

$ bin/cake plugin assets symlink NiceAdminBakeTheme

或者如果您想手动创建链接 cd webroot/css && ln -s ../../vendor/davidyell/nice-admin-bake-scripts/webroot/css/nice-admin.css。

烘烤

烘烤时，主题应该可用。您可以运行带有 -h 的 bake 命令并检查在 --theme 选项的帮助中列出的可用主题来检查此。如果您看不到它请确保您已加载插件。

控制器

bin/cake bake controller --theme=NiceAdminBakeTheme Examples

模板

bin/cake bake template --theme=NiceAdminBakeTheme Examples

前缀模板

bin/cake bake template --theme=NiceAdminBakeTheme --prefix=Admin Examples

示例布局、元素和仪表盘

该插件包含基本的管理员布局、仪表盘和导航元素。您可以根据需要将其创建符号链接、扩展或复制到您的项目中。

如果您想链接到样式。 echo $this->Html->css(['nice-admin']);

然而，使用符号链接是更好的选择。

$ bin/cake plugin assets symlink NiceAdminBakeTheme

⚠️ 这些元素是可选的，并不提供完整的管理员功能。您需要根据需求进行自定义。

对标准 bake 的修改

从控制器中移除了 _serialize
从所有模板中移除了操作侧边栏
使用 Bootstrap 格式化表格
在表格顶部添加了“新建”按钮
在索引模板中添加了基本过滤器表单
整理了分页
将操作列的链接改为按钮
使用 Time 辅助函数添加了日期、日期时间和时间的处理
使用 Bootstrap 图标处理布尔数据
更新了视图模板以使用 Bootstrap 面板
间隔 Table 定义函数
在索引模板的列中添加了类
列表现在是有序的
索引分页使用查询完成

许可证

查看 license.md

davidyell / nice-admin-bake-scripts

维护者

详细信息