Plugin for CakePHP to ease the use of Twitter Bootstrap 3

At the moment this package is far from being complete and possibly broken. Use at your own risk!

The baked views need the FriendsOfCake/bootstrap-ui and the CakeDC/search plugins to work, so my package depends on these plugins (required in composer.json). Although you have to provide jquery, bootstrap and/or bootswatch, select2 and jasny bootstrap. The provided layout file assumes that they are installed via bower under the directory /webroot/bower/. At the moment I'm not using any CDN, but you can change this in the default.ctp File. All bake templates are highly opinionated and will reflect my personal design ideas. However you can use them as a starting point or inspiration.

What you get

1. Alternative Bake templates for the index, view, edit and add actions. The Templates produce less links in the sidebar. They include the option to output icons, when the provided Helpers are used. A search-form is provided in index.ctp which uses the search-plugin. Per default there is only a 'name'-property input. but you can add other fields. Don't forget to adapt $filterArgs in the resp. Table-Object. Flash-Messages in Controller actions are now wrapped in '__()' - function to allow easier translation.
2. HtmlHelper and FormHelper can add icons to links (Actually (Icomoon, FontAwesome and Glyphicons supported). You have to include the Font-Libraries yourself. I recommend using bower.
   The HtmlHelper now has an icon() method which outputs a span with the icon.
   Form->file() now generates the file-input-widget from jasny
3. some reusable elements (uploadButton, submitButton, searchButtons, pagination)

Installation

You can install this plugin into your CakePHP application using composer. You first have to add the repository manually by adding to your composer.json:

"repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/cewi/cakephp_tb_starter"
        }
    ],

The recommended way to install the package then is:

composer require cewi/cakephp_tb_starter

Then load the Plugins in your bootstrap.php

Plugin::load('Search');
Plugin::load('BootstrapUI');
Plugin::load('Cewi/CakephpTbStarter', ['bootstrap' => true]);

Don't forget to check your controller-code!

##Usage

###Helpers If you plan to use the Helpers you have to include them in AppView:

 public $layout = 'Cewi/CakephpTbStarter.default';

 public function initialize()
 {
    $this->loadHelper('Form', ['className' => 'Cewi/CakephpTbStarter.Form']);
    $this->loadHelper('Html', ['className' => 'Cewi/CakephpTbStarter.Html']);
    $this->loadHelper('Flash', ['className' => 'BootstrapUI.Flash']);
 } 

• $this->Html->span($iconName) will output a span-Tag with the icon. I.e. $this->Icon->span('glyphicon-star') will output

<span class="glyphicon glyphicon-star"  aria-hidden="true"></span>

• In $this->Html->link() and $this->Form->postLink() you can add 'icon'=>'the-icon-you-want' in the $options-Array. It then will output an icon before the title. Example: $this->Html->link(__('Edit'), ['action'=>'edit', 1], ['icon'=>'glyphicon-pencil']) will output:

<a href=foo_controller/edit/1><span class="glyphicon glyphicon-pencil"  aria-hidden="true"></span>Edit</a>

If you add 'short'=>true as an extra options, the generated code will not have the title string:

<a href=foo_controller/edit/1><span class="glyphicon glyphicon-pencil"  aria-hidden="true"></span></a>

• $this->Form->file() outputs the File input widget from jasny. You have to install the libraries with bower. They are loaded in the default.ctp Layout.

###Bake-Templates just add -t Cewi/CakeTbStarter to your bake commands. The templates rely on the layouts provided by the FriendsOfCake/bootstrap-ui Plugin (above). See there how to include them.