dlu / dlutwbootstrap
ZF2 module to generate Twitter Bootstrap UI - forms, navigation, etc.
Requires
- php: >=5.3.3
- zendframework/zendframework: >=2.1.0
This package is not auto-updated.
Last update: 2018-12-07 23:43:28 UTC
README
Introduction
DluTwBootstrap is a Zend Framework 2 module facilitating usage of Twitter Bootstrap in ZF2 applications.
If you are new to DluTwBootstrap, first go to http://apps.zfdaily.com/dlutwbootstrap-demo to see it in action on-line.
Implemented features
Forms
- All four Twitter Bootstrap form types supported - Horizontal, Vertical, Inline, Search
- Supported form elements
- Button
- Checkbox
- Csrf
- File
- Hidden
- MultiCheckbox (not supported on Inline and Search forms)
- Multiselect (not supported on Inline and Search forms)
- Password
- Radio (not supported on Inline and Search forms)
- Reset
- Select
- Submit
- Text
- Textarea
- Inline help (hint), block help (description) and placeholder texts are supported with relevant elements
- Error state and messages (error messages are supported on Horizontal and Vertical forms)
- Highlighting required fields
- Prepend / append text to text input
- Multi-checkbox and radio can be optionally rendered inline
- Fieldset legend
Supported versions
- Zend Framework 2.1.4
- Twitter Bootstrap v2.1.0
Installation - manual
- Go to your project's directory.
Clone this project into your
./vendor
directory as aDluTwBootstrap
module:git clone https://bitbucket.org/dlu/dlutwbootstrap.git ./vendor/DluTwBootstrap
Follow the Post installation steps bellow
Installation - with Composer
- Go to your project's directory.
- Edit your
composer.json
file and add"dlu/dlutwbootstrap": "dev-master"
intorequire
section. - Run
php composer.phar install
(orphp composer.phar update
). - Follow the Post installation steps bellow
Post installation steps
- Copy everything from the module's
public
directory to<your app>/public
(i.e. Twitter Bootstrap and jQuery css files, js files and images). Enable the DluTwBootstrap module in your app config file
<your app>/config/application.config.php
:- add
'DluTwBootstrap',
undermodules
- add
Optional: Move
module.DluTwBootstrap.global.php
from the module's root directory to<your app>/config/autoload
directory. This sets the layout script to the one supplied with the module to load all necessary css and js dependencies. (Do not do this if you have your own layout and you already have the Twitter Bootstrap environment set-up properly in your project!)
Check and Demo
To check that you have installed the module properly and to see it in action, install the DluTwBootstrap Demo module. The Demo module is the easiest and quickest way to start working with the DluTwBootstrap module as it clearly shows the rendered output (e.g. a form) 'side by side' with the actual source code used to produce that output. Recommended!