Download the PHP package stroker/form without Composer
On this page you can find all versions of the php package stroker/form. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package form
Short Description ZF2 module for extending forms with live clientside validation
License MIT
Informations about the package form
StrokerForm
ZF2 module for extending forms with live clientside validation without need to write js validation code. You only need to define your validation rules server side with ZF2 and this module automaticaly adds the same rules with jQueryValidate. In case a client side version of the validation rule doesn't exist a fallback is done using ajax. For basic usage examples see the sandbox project StrokerFormSandbox.
BC Breaks since 1.0.0
- Support for PHP versions lower than 5.6 is dropped.
StrokerForm\Renderer\JqueryValidate\Rule\RuleInterface
has been extended with a new methodcanHandle
. This method is called on a rule to check if it can process a certain validator. When you have some custom rules you'll need to update them to implement this new method.
BC Breaks since 0.1.0
For the new version you need to copy config/strokerform.global.php.dist
to your projects config/autoload
dir.
Installation
Installation of StrokerForm uses composer. For composer documentation, please refer to getcomposer.org.
cd my/project/directory
-
create or modify the
composer.json
file within your ZF2 application file with following contents: - install composer via
curl -s https://getcomposer.org/installer | php
(on windows, download https://getcomposer.org/installer and execute it with PHP). Then runphp composer.phar install
-
open
my/project/directory/configs/application.config.php
and add the following key to yourmodules
: - copy the file
config/strokerform.global.php.dist
fromvendor\stroker\zf2-form
to your projectsconfig/autoload
directory and rename it tostrokerform.global.php
. - copy the assets to your public folder (my/project/directory/public).
Usage
First we need to make sure jquery is loaded by our application and the headScript() and inlineScript() view helpers are called. If you already have this in place you can skip this step.
For the ajax validation to work inputfilters needs to be hooked to the form. We need to create a serviceFactory and register it with a unique alias to the formManager (this is an pluginManager). If the inputFilters are already set to the form (i.e. in your form constructor) it's enough to register the form as an invokable
Now let's add our new factory to the formManager.
Last thing we need to do is invoking the StrokerFormPrepare view helper where you are rendering your form. This view helper add all the needed javascripts to the headScript view helper
Renderers
A renderer should implement the RendererInterface and is responsible for modifying the form rendering (setting inline javascript, modifying the form element attributes, view helpers etc.). Currently only the jqueryValidate renderer is available. Support for other validation libraries can be implemented as a seperate renderer.
JqueryValidate
Options
include_assets
: Whether you want the view helper to include the needed assets or you like to do it yourself using a asset manageruse_twitter_bootstrap
: Set this to true if you are using twitter bootstrap.validate_options
: Options for the jquery validate plugin. See jqueryValidate options for all possible options. i.e. if you also want to validate on keypress you can set onkeyup to true.disable_ajax_fallback
: Disables AJAX fallback for non available client side validators
Styling
If you are using twitter bootstrap and the recommended form structure the styling works out of the box.
When you are using the ZF2 view helpers for your form you could style the input fields error
and valid
classes which are added on the fly by the jquery plugin.
Excluding elements from clientside validation
You can set the option strokerform-exclude
on a form element
All versions of form with dependencies
zendframework/zend-eventmanager Version ~2
zendframework/zend-form Version ~2
zendframework/zend-http Version ~2
zendframework/zend-json Version ~2
zendframework/zend-mvc Version ~2
zendframework/zend-cache Version ~2
zendframework/zend-config Version ~2
zendframework/zend-i18n Version ~2
zendframework/zend-i18n-resources Version ~2
zendframework/zend-inputfilter Version ~2
zendframework/zend-servicemanager Version ~2
zendframework/zend-validator Version ~2
zendframework/zend-view Version ~2