sanyatuning/dlutwbootstrap

ZF2 module to generate Twitter Bootstrap UI - forms, navigation, etc.

Maintainers

Details

bitbucket.org/sanyatuning/dlutwbootstrap

Homepage

Source

Issues

Installs: 64

Dependents: 1

Suggesters: 0

Security: 0

0.1.3.3 2013-06-04 12:42 UTC

Requires

New-BSD-License 56b8a6a510a8eabf86f8b3806ba8965433697e20

zf2moduletwitter bootstrapzend framework 2dlutwbootstrap

This package is auto-updated.

Last update: 2024-11-29 04:07:04 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

Alerts

  • todo: write this

Navigation

  • todo: write this

Forms

  • All four Twitter Bootstrap form types supported - Horizontal, Vertical, Inline, Search
  • Supported form elements
    • Button
    • Checkbox
    • Csrf
    • File
    • Hidden
    • Number
    • 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

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