snaquaye / bootstrap-bundle

BraincraftedBootstrapBundle integrates Bootstrap into Symfony2 by providing templates, Twig extensions, services and commands.

BraincraftedBootstrapBundle

By Florian Eckerstorfer

About

BraincraftedBootstrapBundle helps you integrate Bootstrap in your Symfony2 project.

Installation

First you need to add braincrafted/bootstrap-bundle to composer.json:

{
   "require": {
        "braincrafted/bootstrap-bundle": "dev-master"
    }
}

Please note that dev-master points to the latest release. If you want to use the latest development version please use dev-develop. Of course you can also use an explicit version number, e.g., 2.0.*.

You also have to add BraincraftedBootstrapBundle to your AppKernel.php:

// app/AppKernel.php
//...
class AppKernel extends Kernel
{
    //...
    public function registerBundles()
    {
        $bundles = array(
            ...
            new Braincrafted\Bundle\BootstrapBundle\BraincraftedBootstrapBundle()
        );
        //...

        return $bundles;
    }
    //...
}

Additionally you have to install Bootstrap and jQuery as dependencies and configure Assetic to compile the LESS files. You can find more information in the Getting Started section of the documentation.

Compatibility

This bundle has two main dependencies, Symfony and Bootstrap. The following table shows which version of BraincraftedBootstrapBundle is compatible with which version of Symfony and Bootstrap.

BootstrapBundle	Symfony	Bootstrap	jQuery
v1.3.*	v2.2.*	v2.3.*	v1.9.*
v1.4.*	v2.2.*	v2.3.*	v1.9.*
v1.5.*	v2.2.*	v2.3.*	v1.9.*
v2.0.*	v2.3.*	v3.0.*	v1.10.*

Changelog

Version 2.0.0

• Updated to Symfony v2.3.6
• Updated to Bootstrap v3.0.1
• Updated to jQuery v1.10.2
• Remove include_responsive option because Bootstrap 3.0 no longer has a non responsive version
• Added boostrap_money form type that uses Bootstraps prepend or append style to display the currency
• percent form type uses Bootstraps append style to display the percent sign
• Changed namespace back to Braincrafted\Bundle\BootstrapBundle
• Support for custom variables.less
• Several Twig filters are now functions
• Added bootstrap_set_style and bootstrap_get_style Twig functions to globally set the style of forms
• Added command to generate custom bootstrap.less file
• Added command to copy icon fonts into web/ directory
• Added Composer script handler for copying icon fonts
• Pagination now supports disabled links
• Added Twig function badge
• Removed Twig filters badge_* (Bootstrap v3.0 does not include multiply badge styles)
• Twig filters label_* are now Twig functions
• Twig filter icon is now a Twig function
• Added braincrafted_collection form type

Version 2.0.0-alpha2

• Fixed compatibility with PHP 5.3 (Fixes #111)
• Renamed braincrafted_collection to bootstrap_collection
• widget_col, label_col and simple_col can be defined in form builder (Fixes #113)
• Add support for input groups
• Fix bug with inline forms when no placeholder is defined

Version 2.0.0-alpha3

• Fixed configuration of input groups in form builder (Fixes #115)
• Fixed trailing slash in braincrafted_bootstrap.output_dir option
• Fixed undefined variable in pagination template
• Better tested

Version 2.0.0-beta1

• Fixed duplicate div.form-group in choice_widget_expanded (Fixes #131)
• Use correct assets when not using LESS (Fixes #128) [amcgowanca]
• Add col_size option to set the column size for form widgets (Fixes #127)
• Add support for simple_col options in textarea_widget
• Renamed views
• Add error messages in checkbox_row and radio_widget (Fixes #118)

Version 1.5.0

• Works with new Bootstrap repository twbs/bootstrap
• Basic support for Bootstrap v3.0
• Allow override options in menus
• Extend from base form layout
• Fixed problems with removing elemnts in JavaScript collection form type
• Various other bugfixes

Version 1.4.0

• Changed namespace to Bc\Bundle\BootstrapBundle
• Automatically configure Twig
• Automatically configure KnpMenuBundle
• Automatically configure KnpPaginatorBundle
• Automatically configure Assetic
• Improved layout of error messages in compound fields
• Improved code style (usage of PHP_CodeSniffer and PHPMD)
• Support for data-prototype option in collection fields
• Helper and template for flash messages

Version 1.2.0

• Added support for Assetic

License

• The bundle is licensed under the MIT License
• The CSS and Javascript from the Twitter Bootstrap are licensed under the Apache License 2.0