TwitterBootstrap Plugin for CakePHP2.x

(https://github.com/slywalker/TwitterBootstrap)

The TwitterBootstrap Plugin provides an easy-to-use feature Bootstrap in CakePHP2.x
Bootstrap, from Twitter
This v1.5.5 supports Bootstrap v2.2.2

Installation

This plugin

Composer

{
  "repositories": [
    {
      "type": "package",
      "package": {
        "name": "twitter/bootstrap",
        "version": "dev-master",
        "source": {
          "url": "git://github.com/twitter/bootstrap",
          "type": "git",
          "reference": "master"
        },
        "require": {
          "composer/installers": "*"
        }
      },
      "packagist": false
    }
  ],
  "require": {
    "twitter/bootstrap": "dev-master",
    "slywalker/twitter_bootstrap": "dev-master"
  },
  "config": {
    "vendor-dir": "Vendor"
  }
}

Submodule

$ cd /your_app_path
$ git submodule add git://github.com/slywalker/TwitterBootstrap.git Plugin/TwitterBootstrap
$ git submodule update --init --recursive

Clone

$ cd /your_app_path/Plugin
$ git clone git://github.com/slywalker/TwitterBootstrap.git
$ cd TwitterBootstrap
$ git submodule update --init

Enable plugin

You need to enable the plugin your app/Config/bootstrap.php file:

CakePlugin::load('TwitterBootstrap');

If you are already using CakePlugin::loadAll();, then this is not necessary.

bootstrap

Manual

• Download bootstrap: Bootstrap, from Twitter
• Unzip that download.
• Copy folders(css, img, js) in the resulting folder to app/webroot

Shell Command (need recess and uglifyjs)
(Copy less, js, img files to webroot and make css, js files)

$ cd /your_app
$ Console/cake TwitterBootstrap.copy
$ Console/cake TwitterBootstrap.make

Usage

Controller/AppController.php:

<?php
class AppController extends Controller {

    public $helpers = array(
        'Session',
        'Html' => array('className' => 'TwitterBootstrap.BootstrapHtml'),
        'Form' => array('className' => 'TwitterBootstrap.BootstrapForm'),
        'Paginator' => array('className' => 'TwitterBootstrap.BootstrapPaginator'),
    );

}

View/Layout/default.ctp:

<?php echo $this->Html->css('bootstrap.min'); ?>
<?php echo $this->Html->css('bootstrap-responsive.min'); ?>
<?php echo $this->Html->script('bootstrap.min'); ?>

Output form input as Bootstrap format

<?php echo $this->Form->create('Sample', array('class' => 'form-horizontal')); ?>
    <fieldset>
        <legend>Extending form controls</legend>
        <?php echo $this->Form->input('field1', array(
            'label' => 'Prepended text',
            'type' => 'text',
            'class' => 'span2',
            'prepend' => '@',
            'helpBlock' => 'Here\'s some help text',
        )); ?>
        <?php echo $this->Form->input('field2', array(
            'label' => 'Appended text',
            'type' => 'text',
            'class' => 'span2',
            'append' => '.00',
            'helpInline' => 'Here\'s more help text',
        )); ?>
        <?php echo $this->Form->input('field3', array(
            'label' => 'Append and prepend',
            'type' => 'text',
            'class' => 'span2',
            'prepend' => '$',
            'append' => '.00',
        )); ?>
        <?php echo $this->Form->input('field4', array(
            'label' => 'Append with button',
            'type' => 'text',
            'class' => 'span2',
            'append' => array('Go!', array('wrap' => 'button', 'class' => 'btn')),
        )); ?>
        <?php echo $this->Form->input('field5', array(
            'label' => 'Inline checkboxes',
            'type' => 'select',
            'multiple' => 'checkbox inline',
            'options' => array('1', '2', '3'),
        )); ?>
        <?php echo $this->Form->input('field6', array(
            'label' => 'Checkboxes',
            'type' => 'select',
            'multiple' => 'checkbox',
            'options' => array(
                '1' => 'Option one is this and that¡ªbe sure to include why it\'s great',
                '2' => 'Option two can also be checked and included in form results',
                '3' => 'Option three can¡ªyes, you guessed it¡ªalso be checked and included in form results',
            ),
            'helpBlock' => '<strong>Note:</strong> Labels surround all the options for much larger click areas and a more usable form.',
        )); ?>
        <?php echo $this->Form->input('field7', array(
            'label' => 'Radio buttons',
            'type' => 'radio',
            'options' => array(
                '1' => 'Option one is this and that¡ªbe sure to include why it\'s great',
                '2' => 'Option two can is something else and selecting it will deselect option one',
            ),
        )); ?>
        <div class="form-actions">
            <?php echo $this->Form->submit('Save changes', array(
                'div' => false,
                'class' => 'btn btn-primary',
            )); ?>
            <button class="btn">Cancel</button>
        </div>
    </fieldset>
<?php echo $this->Form->end(); ?>

Output SessionHelper::flash as Bootstrap format

// SomethingsController
$this->Session->setFlash(__('The something has been saved'), 'alert', array(
    'plugin' => 'TwitterBootstrap',
    'class' => 'alert-success'
));
$this->Session->setFlash(__('The something could not be saved. Please, try again.'), 'alert', array(
    'plugin' => 'TwitterBootstrap',
    'class' => 'alert-error'
));

// View
<?php echo $this->Session->flash(); ?>

// Auth
<?php echo $this->Session->flash('auth', array(
    'element' => 'alert',
    'params' => array('plugin' => 'TwitterBootstrap'),
)); ?>

Output Paginate as Bootstrap format

// div.pagination.pagination-centered
<?php echo $this->Paginator->pagination(); ?>
// ul.pager
<?php echo $this->Paginator->pager(); ?>

Breadcrumb

<?php echo $this->Html->breadcrumb(array(
    $this->Html->link('one', '/one'),
    $this->Html->link('two', '/two'),
    'three',
)); ?>

You can see more sample. access http://{webroot}/twitter_bootstrap