patricktalmadge / bootstrapper

Laravel Twitter Bootstrap Bundle
561 stars 129 forks source link

Bootstrapper

Latest stable version: Latest Stable Version

Travis status : Build Status

Current supported Bootstrap version: 3.2.0

Bootstrapper is a set of classes that allow you to quickly create Twitter Bootstrap 3 style markup.

Installation

Add the following to your composer.json file :

"require": {
    "patricktalmadge/bootstrapper": "~5",
},

or execute

composer require patricktalmadge/bootstrapper

Then register Bootstrapper's service provider with Laravel:

'Bootstrapper\BootstrapperServiceProvider',

If you are using Laravel 5, then you should instead use the Laravel 5 service provider.

'Bootstrapper\BootstrapperL5ServiceProvider',

You can then (if you want to) add the following aliases to your aliases array in your config/app.php file.

'Accordion' => 'Bootstrapper\Facades\Accordion',
'Alert' => 'Bootstrapper\Facades\Alert',
'Badge' => 'Bootstrapper\Facades\Badge',
'Breadcrumb' => 'Bootstrapper\Facades\Breadcrumb',
'Button' => 'Bootstrapper\Facades\Button',
'ButtonGroup' => 'Bootstrapper\Facades\ButtonGroup',
'Carousel' => 'Bootstrapper\Facades\Carousel',
'ControlGroup' => 'Bootstrapper\Facades\ControlGroup',
'DropdownButton' => 'Bootstrapper\Facades\DropdownButton',
'Form' => 'Bootstrapper\Facades\Form',
'Helpers' => 'Bootstrapper\Facades\Helpers',
'Icon' => 'Bootstrapper\Facades\Icon',
'InputGroup' => 'Bootstrapper\Facades\InputGroup',
'Image' => 'Bootstrapper\Facades\Image',
'Label' => 'Bootstrapper\Facades\Label',
'MediaObject' => 'Bootstrapper\Facades\MediaObject',
'Modal' => 'Bootstrapper\Facades\Modal',
'Navbar' => 'Bootstrapper\Facades\Navbar',
'Navigation' => 'Bootstrapper\Facades\Navigation',
'Panel' => 'Bootstrapper\Facades\Panel',
'ProgressBar' => 'Bootstrapper\Facades\ProgressBar',
'Tabbable' => 'Bootstrapper\Facades\Tabbable',
'Table' => 'Bootstrapper\Facades\Table',
'Thumbnail' => 'Bootstrapper\Facades\Thumbnail',

Including Bootstrap

Include the Bootstrap files just like any other css and js files! Download Bootstrap and JQuery from the Bootstrap site, place them in your public folder and then include them like so:

{{ HTML::style('path/to/bootstrap.css') }}
{{ HTML::script('path/to/jquery.js') }}
{{ HTML::script('path/to/bootstrap.js') }}

Feel free to use a CDN, but bear in mind that you may get unexpected functionality if the version you use isn't the version Bootstrapper currently supports (but open an issue to let us know!).

<link rel="stylesheet" href="https://github.com/patricktalmadge/bootstrapper/blob/master//netdna.bootstrapcdn.com/bootstrap/3.0.0/css/bootstrap.min.css">
<script src="http://code.jquery.com/jquery-1.10.1.min.js"></script>
<script src="https://github.com/patricktalmadge/bootstrapper/raw/master//netdna.bootstrapcdn.com/bootstrap/3.0.3/js/bootstrap.min.js"></script>

If you want to get the latest Bootstrap that Bootstrapper supports, then use the helper function:

Helpers::css()
Helpers::js()

If you want to stick at a certain version then use

artisan config:publish patricktalmadge/bootstrapper

And update your config file in app/config/packages.

We also have Twitter Bootstrap as a dependency, so you can grab the files from your vendor directory.

Documentation

Contributing

Contributing is easy! Just fork the repo, make your changes then send a pull request on GitHub. If your PR is languishing in the queue and nothing seems to be happening, then send Patrick an email or a tweet.