illuminate3 / bootawesome
An easy way to intergrate Twitter Bootstrap with Laravel 4.
Requires
- php: >=5.4.0
Requires (Dev)
- mockery/mockery: ~0.9.1
- phpspec/phpspec: 2.0.*@dev
This package is not auto-updated.
Last update: 2024-12-25 06:46:10 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
- CSS-FONT
- JS-1X
- JS-2X
- Vertical
- Horizontal
- Inline
- Text
- Password
- File
- Date
- Datetime
- Time
- Textarea
- Select
- Checkbox
- Radio
- Submit
- Button
- Reset
- modalButton
- Link
- Secure Link
- Link Route
- Link Action
- Link Icon
- Link Icon Route
- Mailto
- None Alert
- Success Alert
- Info Alert
- Warning Alert
- Danger Alert
- Full Modal
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');
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