README

安装

您可以使用以下命令通过composer安装：

composer require cakephp-brasil/twitter-bootstrap

请确保在 config/bootstrap.php 中加载插件。

Plugin::load('TwitterBootstrap');

如何使用

使用 bake 创建视图

只需在命令末尾添加 --theme TwitterBootstrap，例如

bin\cake bake all MyModel --theme TwitterBootstrap

启用表单

在 src/View/AppView.php 中，在 initialize() 内添加 $this->loadHelper('Form', ['className' => 'TwitterBootstrap.Form']);，如下所示

public function initialize()
{
    $this->loadHelper('Form', ['className' => 'TwitterBootstrap.Form']);
}

默认布局

启用布局

在控制器中（例如，AppController以用于任何页面）报告 $this->viewBuilder()->theme('TwitterBootstrap');，然后使用 $this->viewBuilder()->layout('adminlte'); 启用主题。

在 src/View/AppView.php 中，在 initialize() 内添加 $this->loadHelper('Form', ['className' => 'TwitterBootstrap.Form']);，如下所示

更改标题

在AppController中，只需使用 $this->set('project_name', '您想要的标题')。

更改右上角菜单

在 src/Template/Element 中创建一个名为 nav-bar-right.ctp 的文件（您可以从 vendor/cakephp-brasil/twitter-bootstrap/src/Template/Element 中的模板复制），可能需要创建 adminlte 目录。

自动发布必要的视图

更改左上角菜单

在 src/Template/Element 中创建一个名为 nav-bar-left.ctp 的文件（您可以从 vendor/cakephp-brasil/twitter-bootstrap/src/Template/Element 中的模板复制），可能需要创建 adminlte 目录。

自动发布必要的视图

AdminLTE

如何启用布局

在控制器中（例如，AppController以用于任何页面）报告 $this->viewBuilder()->theme('TwitterBootstrap');，然后使用 $this->viewBuilder()->layout('adminlte'); 启用主题。

在 src/View/AppView.php 中，在 initialize() 内添加 $this->loadHelper('Form', ['className' => 'TwitterBootstrap.Form']);，如下所示

public function initialize()
{
    $this->loadHelper('Form', ['className' => 'TwitterBootstrap.Form']);
}

更改顶部（header）

在 src/Template/Element/adminlte 中创建一个名为 header.ctp 的文件（您可以从 vendor/cakephp-brasil/twitter-bootstrap/src/Template/Element/adminlte 中的模板复制），可能需要创建 adminlte 目录。

自动发布必要的视图

更改左侧

在 src/Template/Element/adminlte 中创建一个名为 sidebar.ctp 的文件（您可以从 vendor/cakephp-brasil/twitter-bootstrap/src/Template/Element/adminlte 中的模板复制），可能需要创建 adminlte 目录。

自动发布必要的视图

更改页脚

在 src/Template/Element/adminlte 中创建一个名为 footer.ctp 的文件（您可以从 vendor/cakephp-brasil/twitter-bootstrap/src/Template/Element/adminlte 中的模板复制），可能需要创建 adminlte 目录。

自动发布必要的视图

更改内容块

在 src/Template/Element/adminlte 中创建一个名为 content.ctp 的文件（您可以从 vendor/cakephp-brasil/twitter-bootstrap/src/Template/Element/adminlte 中的模板复制），可能需要创建 adminlte 目录。

自动发布必要的视图

更改右侧菜单（当点击顶部齿轮链接时出现）

在 src/Template/Element/adminlte 中创建一个名为 control_sidebar.ctp 的文件（您可以从 vendor/cakephp-brasil/twitter-bootstrap/src/Template/Element/adminlte 中的模板复制），可能需要创建 adminlte 目录。

自动发布必要的视图

禁用：创建一个空的视图并将其从顶部链接中删除。

自动发布上述所需视图

贡献者：@josimar-lemos

觉得每次需要修改主题元素时，都要复制粘贴真的很麻烦（懒程序员在此）。

我创建了一个Shell脚本来简化这个过程，目前只提供了一个选项来一次性复制所有元素，如果需要，我可以增加更多功能。

进行测试

$ cd path-to-project
$ bin/cake TwitterBootstrap.publish

或者

$ cd path-to-project
$ bin/cake TwitterBootstrap.publish all

------ 笔记结束

参与贡献

在此项目上进行Fork，进行修改并发送Pull Request，不要忘记建议新功能。