illuminate3/bootawesome

An easy way to intergrate Twitter Bootstrap with Laravel 4.

dev-master 2015-04-17 02:54 UTC

README

Think of Bootstrap as an easy way to integrate Bootstrap with Laravel 4, providing a variety of helpers to speed up development. These include:

  • Bootstrap::css-boot
  • Bootstrap::css-font
  • Bootstrap::js-1x
  • Bootstrap::js-2x
  • Bootstrap::vertical
  • Bootstrap::horizontal
  • Bootstrap::inline
  • Bootstrap::text
  • Bootstrap::password
  • Bootstrap::email
  • Bootstrap::file
  • Bootstrap::date
  • Bootstrap::datetime
  • Bootstrap::time
  • Bootstrap::textarea
  • Bootstrap::select
  • Bootstrap::checkbox
  • Bootstrap::radio
  • Bootstrap::submit
  • Bootstrap::button
  • Bootstrap::reset
  • Bootstrap::link
  • Bootstrap::secureLink
  • Bootstrap::linkRoute
  • Bootstrap::linkAction
  • Bootstrap::linkIcon
  • Bootstrap::mailto
  • Bootstrap::none
  • Bootstrap::success
  • Bootstrap::info
  • Bootstrap::warning
  • Bootstrap::danger

Original source

This package is essentially Bradley Cronford's Bootstrap

Source Versions

Bootstrap v3.2.0 FontAwesome v4.2.0 jquery v1.11.1 or v2.1.1

Installation

Begin by installing this package through Composer. Edit your project's composer.json file to require illuminate3/bootawesome.

"require": {
	"illuminate3/bootawesome": "dev-master"
}

Next, update Composer from the Terminal:

composer update

Once this operation completes, the next step is to add the service provider. Open app/config/app.php, and add a new item to the providers array.

'Illuminate3\BootAwesome\BootstrapServiceProvider',

The final step is to introduce the facade. Open app/config/app.php, and add a new item to the aliases array.

'Bootstrap'       => 'Illuminate3\BootAwesome\Facades\Bootstrap',

If you want to introduce the packages JavaScripts and Stylesheets, run the following command to pull them into your project.

php artisan asset:publish illuminate3/bootawesome

That's it! You're all set to go.

Usage

In order to include the Bootstrap dependencies you will need to utilise the Bootstrap::css() and Bootstrap:js() methods in the head section of your layout / page template.

It's really as simple as using the Bootstrap class in any Controller / Model / File you see fit with:

Bootstrap::

This will give you access to

CSS-BOOT

The css-boot method includes Bootstrap CSS via either a CDN / Local file, and pass optional attributes.

Bootstrap::cssBoot();
Bootstrap::cssBoot('local', ['type' => 'text/css']);

CSS-FONT

The css-font method includes Bootstrap CSS via either a CDN / Local file, and pass optional attributes.

Bootstrap::cssFont();
Bootstrap::cssFont('local', ['type' => 'text/css']);

JS-1X

The js-1x method includes Bootstrap JS via either a CDN / Local file, and pass optional attributes.

Bootstrap::js1x();
Bootstrap::js1x('local', ['type' => 'text/javascript']);

JS-2X

The js-2x method includes Bootstrap JS via either a CDN / Local file, and pass optional attributes.

Bootstrap::js2x();
Bootstrap::js2x('local', ['type' => 'text/javascript']);

Vertical

The vertical method allows a form to be set in a vertical manner. This is the default form type. The vertical method can be chained before any form element is added and will continue for subsequent form elements until overwritten.

Bootstrap::vertical();
Bootstrap::vertical()->text('text', 'Text', 'Value');

Horizontal

The horizontal method allows a form to be set in a horizontal manner. This form type accepts both an input class and a label class. The horizontal method can be chained before any form element is added and will continue for subsequent form elements until overwritten.

Bootstrap::horizontal('col-sm-10', 'col-sm-2');
Bootstrap::horizontal('col-sm-10', 'col-sm-2')->text('text', 'Text', 'Value');

Inline

The inline method allows a form to be set in an inline manner. This form type accepts only a label class. The inline method can be chained before any form element is added and will continue for subsequent form elements until overwritten.

Bootstrap::inline('sr-only');
Bootstrap::inline('sr-only')->text('text', 'Text', 'Value');

Text

The text method generates a text field with an optional label and Font Awesome icon, from errors and options.

Bootstrap::text('text', 'Text', 'Value', $errors);

Password

The password method generates a password field with an optional label and Font Awesome icon, from errors and options.

Bootstrap::password('password', 'Password');

Email

The email method generates an email field with an optional label and Font Awesome icon, from errors and options.

Bootstrap::email('email', 'Email address', 'Value');

File

The file method generates a file field with an optional label, from errors and options.

Bootstrap::file('file', 'File');

Date

The date method generates a date field with a date picker, with an optional label, from errors, input options, and javascript parameters.

Bootstrap::date('date', 'Date');
Bootstrap::date('date', 'Date', date('d-m-Y'), $errors, [], ['format' => 'DD-MM-YYYY']);

Datetime

The datetime method generates a date field with a datetime picker, with an optional label, from errors, input options, and javascript parameters.

Bootstrap::datetime('datetime', 'Date');
Bootstrap::datetime('datetime', 'Date', date('d-m-Y H:i:s'));

Time

The time method generates a date field with a time picker, with an optional label, from errors, input options, and javascript parameters.

Bootstrap::time('time', 'Time');
Bootstrap::time('time', 'Time', date('H:i:s'));

Textarea

The textarea method generates a textarea field with an optional label and Font Awesome icon, from errors and options.

Bootstrap::textarea('file', 'File', 'Value');

Select

The select method generates a select field with items and an optional label, selected item, from errors and options.

Bootstrap::select('select', 'Select', ['1' => 'Item 1', '2' => 'Item 2'], 2);

Checkbox

The checkbox method generates a checkbox field with a value and an optional label, checked and options.

Bootstrap::checkbox('checkbox', 'Checkbox', 1, true);

Radio

The radio method generates a radio field with a value and an optional label, checked and options.

Bootstrap::checkbox('radio', 'Radio', 1);

Submit

The submit method generates a submit button with a value and optional attributes.

Bootstrap::submit('Submit');

Button

The button method generates a button with a value and optional attributes.

Bootstrap::button('Button');

Reset

The reset method generates a reset button with a value and optional attributes.

Bootstrap::reset('Reset');

modalButton

The modalButton method generates a button with a value and optional attributes.

Bootstrap::modalButton('Submit');

Link

The link method generates a link button with a url, title and optional attributes and secure link.

Bootstrap::link('/', 'Link');

Secure Link

The secureLink method generates a secure link button with a url, title and optional attributes and secure link.

Bootstrap::secureLink('/', 'Link');

Link Route

The linkRoute method generates a link button with a route, title and optional parameters, attributes.

Bootstrap::linkRoute('home', 'Home');

Link Action

The linkAction method generates a link button with an action, title and optional parameters, attributes.

Bootstrap::linkAction('index', 'Home');

Link Icon

The linkIcon method generates a link button with a url, title, Font Awesome icon and optional attributes and secure link. You do not need the Font Awesome "fa" prefix, just use the icon name and it's size.

Bootstrap::linkIcon('/', 'Link', 'flag fa-fw');

Link Icon Route

The linkIconRoute method generates a link button with a url, title, Font Awesome icon and optional attributes and secure link. You do not need the Font Awesome "fa" prefix, just use the icon name and it's size.

Bootstrap::linkIcon('/', 'Link', 'flag fa-fw');

Mailto

The mailto method generates a mailto link button with an email address, title and optional attributes.

Bootstrap::mailto('test@test.com', 'Email');

None Alert

The none method generates a none alert with content with optional emphasis, optionally be dismissible, and optional attributes.

Bootstrap::none('A message', null, true);

Success Alert

The success method generates a success alert with content with optional emphasis, optionally be dismissible, and optional attributes.

Bootstrap::success('A success message', 'Well done!', true);

Info Alert

The info method generates an info alert with content with optional emphasis, optionally be dismissible, and optional attributes.

Bootstrap::info('An info message', 'Heads up!', true);

Warning Alert

The warning method generates a warning alert with content with optional emphasis, optionally be dismissible, and optional attributes.

Bootstrap::warning('A warning message', 'Warning!', true);

Danger Alert

The danger method generates a danger alert with content with optional emphasis, optionally be dismissible, and optional attributes.

Bootstrap::danger('A danger message', 'Oh snap!', true);

Full Modal

The fullModal method generates a modal alert with content with optional emphasis, optionally be dismissible, and optional attributes.

Bootstrap::fullModal('A modal message', 'Oh snap!', submit);
{{ Bootstrap::modalButton(
	trans('lingos::button.delete'),
	array(
		'class' => 'btn btn-danger',
		'data-toggle' => 'modal',
		'data-target' => '#delete-' . $user->id,
	)
) }}

{{ Bootstrap::fullModal(
$user->id, 'myModal', 'title', 'admin.users.destroy', 'delete', 'delete', 'close', 'button'
) }}

License

Bootawesome is open-sourced software licensed under the MIT license