Download the PHP package hamichen/zf2-twb-bundle without Composer

On this page you can find all versions of the php package hamichen/zf2-twb-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package zf2-twb-bundle

TwbBundle, v2.0

(Supports Twitter Bootstrap v3.*)

Build Status Latest Stable Version Total Downloads Dependency Status

NOTE : If you want to contribute don't hesitate, I'll review any PR.

Support the project

Introduction

TwbBundle is a module for Zend Framework 2, for easy integration of the Twitter Bootstrap v3.*.

Contributing

If you wish to contribute to TwbBundle, please read the CONTRIBUTING.md file.

Demonstration / example

Render forms, buttons, alerts with TwbBundle : see it in action on-line.

Requirements

Installation

Main Setup

By cloning project (manual)

  1. Clone this project into your ./vendor/ directory.
  2. (Optionnal) Clone the Twitter bootstrap project (v3.*) into your ./vendor/ directory.

With composer (the faster way)

  1. Add this project in your composer.json:

  2. Now tell composer to download TwbBundle by running the command:

Post installation

  1. Enabling it in your application.config.php file.

  2. Include Twitter Bootstrap assets
With AssetsBundle module (easy way)
Manually

How to use TwbBundle

View helpers

TwbBundle provides view helpers helping render html elements

Forms

Form : TwbBundle\Form\View\Helper\TwbBundleForm

Form helper can be called in a view with the view helper service form(\Zend\Form\FormInterface $oForm = null, $sFormLayout = \TwbBundle\Form\View\Helper\TwbBundleForm::LAYOUT_HORIZONTAL) :

Open form tag with a specific layout :

This helper accepts a form element as first param, and an optionnal Bootstrap defined layout style definition as second param. Here are the available layouts :

The helper auto add form specific class and form role attributes.

Button : TwbBundle\Form\View\Helper\TwbBundleFormButton

Button helper can be called in a view with the view helper service formButton(\Zend\Form\ElementInterface $oElement, $sButtonContent = null) :

This helper accepts a button element as first param, and an optionnal button content as second param. It auto add button specific class (btn & btn-default is no button class is defined) attribute.

The option glyphicon (string or array) and fontAwesome (string or array) can be defined to render a glyphicon or a fontAwesome icon into the element : The glyphicon is rendered by the glyphicon renderer. The fontAwesome is rendered by the fontAwesome renderer.

If the option is a string, it should be the name of the icon (e.g. "star", "search" ...), the glyphicon will prepend the label if exists. If the option is an array, it accept the folling options :

Button can be set as dropdown button by defined the option dropdown (array) to the element : The dropdown is rendered by the dropdown renderer, it accept the folling additionnal options :

The option disable-twb can be passed to the element to disable rendering it in a div container.

Checkbox : TwbBundle\Form\View\Helper\TwbBundleFormCheckbox

Checkbox helper can be called in a view with the view helper service formCheckbox(\Zend\Form\Checkbox $oElement) :

This helper accepts a checkbox element as first param. As the input is rendered into a label element, the label position (append by default) can passed as an option The option disable-twb (boolean) can be passed to the element to disable rendering it in a label.

Form collection : TwbBundle\Form\View\Helper\TwbBundleFormCollection

Form collection helper can be called in a view with the view helper service formCollection(\Zend\Form\ElementInterface $oElement) :

This helper accepts a form collection (fieldset) element as first param.

Form element : TwbBundle\Form\View\Helper\TwbBundleFormElement

Form element helper can be called in a view with the view helper service formElement(\Zend\Form\ElementInterface $oElement) :

This helper accepts a form element as first param. This helper can render prepend and/or append add-on by setting the appropriate option add-on-prepend and/or add-on-append to the element. These options accept the following values :

Form element errors : TwbBundle\Form\View\Helper\TwbBundleFormElementErrors

Form element errors helper can be called in a view with the view helper service formElementErrors(\Zend\Form\ElementInterface $oElement) :

This helper accepts a form element as first param. This helper render element's errors.

Multi-Checkbox : TwbBundle\Form\View\Helper\TwbBundleFormMultiCheckbox

Multi-Checkbox helper can be called in a view with the view helper service formMultiCheckbox(\Zend\Form\ElementInterface $oElement) :

This helper accepts an element as first param. The option inline (boolean) can be passed to the element to display checkoxes inlined (default) or not.

Radio : TwbBundle\Form\View\Helper\TwbBundleFormRadio

Radio helper can be called in a view with the view helper service formCheckbox(\Zend\Form\ElementInterface $oElement) :

This helper accepts an element as first param. The option disable-twb (boolean) can be passed to the element to disable rendering it in a div container.

Form row : TwbBundle\Form\View\Helper\TwbBundleFormRow

Form element helper can be called in a view with the view helper service formRow(\Zend\Form\ElementInterface $oElement) :

This helper accepts a form element as first param. The option twb-layout (string) can be passed to the element to render the row with a defined layout style as form helper. The option validation-state (string) can be passed to the element to render the row with a defined validation state class attribute(has-...). If the element has messages, has-error class attribute is auto added. The option column-size (int) can be passed to the element to render the row with a defined column size class attribute(col-lg-...). The option help-block (string) can be passed to the element to render an help block translated appending the element.

If you like to wrap elements into a

in case you want X number of elements on the same line the option twb-row-open (bool) can be passed to the element where the row must start and will be printed before the element is rendered. It could be you have to provide the column-size in combination with this option. The option twb-row-close (bool) can be passed to the element to close the earlier opened row and will be printed after the elements is rendered. Note: closing earlier opened rows is your responsibility.

You can allow the label html rendering after toggling off escape :

You can also set the the form-group size by passing the twb-form-group-size option on the element passed to formRow, example Twig syntax:

Static : TwbBundle\Form\View\Helper\TwbBundleFormStatic

Static helper can be called in a view with the view helper service formStatic(\Zend\Form\ElementInterface $oElement) :

This helper accepts an element as first param.

Mixed

Alert : TwbBundle\View\Helper\TwbBundleAlert

Alert helper can be called in a view with the view helper service alert($sAlertMessage = null, $aAlertAttributes = null, $bDismissable = false) :

This helper accepts a message as first param, attributes for alert container as second param (optionnal) and boolean as third param to display or not a close action to the alert message (optionnal). The class attribute "alert" is auto added to the alert container.

Badge : TwbBundle\View\Helper\TwbBundleBadge

Badge helper can be called in a view with the view helper service badge($sBadgeMessage = null, array $aBadgeAttributes = null) :

This helper accepts a message as first param, and attributes for badge container as second param (optionnal). The class attribute "badge" is auto added to the badge container.

Button group : TwbBundle\View\Helper\TwbBundleButtonGroup

Button group helper can be called in a view with the view helper service buttonGroup(array $aButtons = null, array $aButtonGroupOptions = null) :

This helper accepts an array of buttons as first param, and attributes for button group container as second param (optionnal). The buttons can be instance of \Zend\Form\Element\Button or array containing data to build an element with the \Zend\Form\Factory

Glyphicon : TwbBundle\View\Helper\TwbBundleGlyphicon

Glyphicon helper can be called in a view with the view helper service glyphicon($sGlyphicon = null, array $aGlyphiconAttributes = null) :

This helper accepts an icon name as first param (e.g. "star", "search" ...), and attributes for glyphicon element as second param (optionnal). The class attribute "glyphicon" is auto added to the glyphicon container.

FontAwesome : TwbBundle\View\Helper\TwbBundleFontAwesome

FontAwesome helper can be called in a view with the view helper service fontAwesome($sFontAwesome = null, array $aFontAwesomeAttributes = null) :

This helper accepts an icon name as first param (e.g. "star", "search" ...), and attributes for fontAwesome element as second param (optionnal). The class attribute "fa" is auto added to the fontAwesome container.

Dropdown : TwbBundle\View\Helper\TwbBundleDropDown

Dropdown helper can be called in a view with the view helper service dropdown(array $aDropdownOptions = null) :

This helper accepts dropdown configuration as first param :

  • attributes (array) : attributes for the dropdown container (optionnal)
  • label (scalar) : Label content (will be translated), may be empty (optionnal)
  • toggle_attributes (array) : attributes for the dropdown toggle container (optionnal)
  • items (array) : list of items, should contains :
    • scalar :
    • \TwbBundle\View\Helper\TwbBundleDropDown::TYPE_ITEM_DIVIDER : display a divider
    • text : display a text (translated) into a link (anchor attribute is the same as content)
    • array : the item options :
    • type (string) : the type of item
    • \TwbBundle\View\Helper\TwbBundleDropDown::TYPE_ITEM_HEADER : render an item as header It needs the following option :
      • label (scalar) content text (translated) of the item
      • \TwbBundle\View\Helper\TwbBundleDropDown::TYPE_ITEM_DIVIDER : render a divider
      • \TwbBundle\View\Helper\TwbBundleDropDown::TYPE_ITEM_LINK : render an item as a link <a ...> It needs the following option :
      • label (scalar) content text (translated) of the item
      • item_attributes (array) : attributes for the item container (optionnal)
    • attributes (array) : the attributes of the item container
  • list_attributes (array) : attributes for the dropdown list container (optionnal)

Label : TwbBundle\View\Helper\TwbBundleLabel

Label helper can be called in a view with the view helper service label($sLabelMessage = null, array $aLabelAttributes = 'label-default') :

This helper accepts a message as first param, and attributes for label container as second param (optionnal). The class attribute "label" is auto added to the label container and "label-default" is no attributes is given. Default label container is a span, but it can be changed by passing the tag name in the attributes array :

Ignore custom view helpers

By default, this module tries to add form-control class to every form element. There are some elements, like checkboxes, radios and buttons, that does not use that class in bootstrap. This config allows you to tell the render method to ignore your custom form view helper and do NOT add that class.

return [
    'twbbundle' => [
        'ignoredViewHelpers' => [
            'viewhelpername'
        ]
    ]
];

Elements

TwbBundle provides new elements to supports Twitter Bootstrap potential.

StaticElement : TwbBundle\Form\Element\StaticElement

Static element is a form element witch provides Static control and should be rendered by static form helper

modified by hamichen


All versions of zf2-twb-bundle with dependencies

PHP Build Version
Package Version
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package hamichen/zf2-twb-bundle contains the following files

Loading the files please wait ....