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.0.0 - 218 (commit 2a398b4e81)
• Twitter Bootstrap v2.1.0

IMPORTANT: If the module does not seem to work, check the version of your ZF2 library and update to the version and commit specified above.

Installation - manual

1. Go to your project's directory.

2. Clone this project into your ./vendor directory as a DluTwBootstrap module:

   git clone https://bitbucket.org/dlu/dlutwbootstrap.git ./vendor/DluTwBootstrap

3. Follow the Post installation steps bellow

Installation - with Composer

1. Go to your project's directory.
2. Edit your composer.json file and add "dlu/dlutwbootstrap": "dev-master" into require section.
3. Run php composer.phar install (or php composer.phar update).
4. Follow the Post installation steps bellow

Post installation steps

1. Copy everything from the module's public directory to <your app>/public (i.e. Twitter Bootstrap and jQuery css files, js files and images).

2. Enable the DluTwBootstrap module in your app config file <your app>/config/application.config.php:

   • add 'DluTwBootstrap', under modules

3. 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!

Links

• DluTwBootstrap (ZF2 module) source
• DluTwBootstrap Demo (ZF2 module) source
• DluTwBootstrap Demo App (ZF2 application)
  • Live Demo App @ http://apps.zfdaily.com/dlutwbootstrap-demo
  • Source
• Tutorials and discussion of DluTwBootstrap on ZF Daily