Download the PHP package funayaki/bootstrap-ui without Composer
On this page you can find all versions of the php package funayaki/bootstrap-ui. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download funayaki/bootstrap-ui
More information about funayaki/bootstrap-ui
Files in funayaki/bootstrap-ui
Package bootstrap-ui
Short Description Twitter Bootstrap 3 support for CakePHP 3
License MIT
Homepage http://github.com/friendsofcake/bootstrap-ui
Informations about the package bootstrap-ui
Bootstrap UI
Transparently use AdminLTE 2 with CakePHP 3.
Requirements
- CakePHP 3.x
- AdminLTE 2.x
- jQuery 1.9+
What's included?
- FlashComponent + elements (types: error, info, success, warning)
- FormHelper (align: default, inline, horizontal)
- HtmlHelper (components: breadcrumbs, badge, label, icon)
- PaginatorHelper
- Widgets (basic, radio, button, select, textarea)
- Sample layouts (cover, signin, dashboard)
- Bake templates incomplete
Installing Using Composer
cd
to the root of your app folder (where the composer.json
file is) and run the following command:
Then load the plugin by adding the following to your app's config/boostrap.php
:
or using CakePHP's console:
Usage
You will need to modify your src/View/AppView
class to either extend BootstrapUI\View\UIView
or
use the trait BootStrapUI\View\UIViewTrait
.
AppView Setup
For a quick setup, just make your AppView
class extend BootstrapUI\View\UIView
. The base class will handle
the initializing and loading of the BootstrapUI layout.ctp
for your app.
The src\View\AppView.php
will look something like the following:
AppView Setup Using UIViewTrait
If you're adding BootstrapUI to an existing application. It might be easier to use the trait, as it gives you more control over the loading of the layout.
BootstrapUI Layout
BootstrapUI comes with its own layout.ctp
file and examples taken from the Bootstrap framework.
When no layout for the view is defined the BootstrapUI\View\UIViewTrait
will load its own layout.ctp
file. You can
override this behavior in two ways.
- Assign a layout to the view with
$this->layout('layout')
. - Disable auto loading of the layout in
BootstrapUI\View\UIViewTrait
with$this->initializeUI(['layout' => false]);
.
Loading the Bootstrap framework
If you wish to use your own layout template, just make sure to include:
When using the BootstrapUI layout (or a copy of it), extra layout types (directly taken from the Bootstrap examples). You just need to copy them to your application's layouts directory:
You can then simply extend them in your views like so:
Available types are:
- cover
- signin
- dashboard
- blog coming soon
NOTE: Remember to set the stylesheets in the layouts you copy.
Installing Bootstrap via Bower
A quick way of getting the Bootstrap assets installed is using bower. Assuming you are in ROOT
:
Console Bake
For those of you who want even more automation, some bake templates have been included. Use them like so:
Helper Usage
At the core of BootstrapUI is a collection of enhancements for CakePHP core helpers. These helpers replace the HTML templates used to render elements for the views. This allows you to create forms and components that use the Bootstrap styles.
The current list of enhanced helpers are:
BootstrapUI\View\Helper\FlashHelper
BootstrapUI\View\Helper\FormHelper
BootstrapUI\View\Helper\HtmlHelper
BootstrapUI\View\Helper\PaginatorHelper
BootstrapUI\View\Helper\BreadcrumbsHelper
When the BootstrapUI\View\UIViewTrait
is initialized it loads the above helpers with the same aliases as the
CakePHP core helpers. That means that when you use $this->Form->create()
in your views. The helper being used
is from the BootstrapUI plugin.
Basic Form
will render this HTML:
Horizontal Form
will render this HTML:
Configuration
You can configure each of the helpers by passing in extra parameters through the AppView.php.
Here is an example of changing the prev
and next
labels for the PaginatorHelper.
To style auth flash messages properly set the flash
key in AuthComponent
config as shown:
NOTE: Check tests for more examples.
Testing
You can run the tests for BootstrapUI by doing the following:
Patches & Features
- Fork
- Mod, fix
- Test - this is important, so it's not unintentionally broken
- Commit - do not mess with license, todo, version, etc. (if you do change any, bump them into commits of their own that I can ignore when I pull)
- Pull request - bonus point for topic branches
To ensure your PRs are considered for upstream, you MUST follow the CakePHP coding standards. A pre-commit
hook has been included to automatically run the code sniffs for you. From your project's root directory:
Bugs & Feedback
http://github.com/funayaki/bootstrap-ui/issues
License
Copyright (c) 2015, Jad Bitar and licensed under The MIT License.