Wallogit.com
2017 © Pedro Peláez
Allow you to decorate Silverstripe Forms before displaying, adding extra functionality
Due to some limitations, this may not work the way I want it, so the API will be changing frequently until I am happy with it. Please use with caution if you must use it at all., (*1)
Zen Forms is a module that allows changes on Silverstripe Forms and Validators using the decorator pattern. Name stolen from some other awesome Silverstripe Developers @sheadawson and @unclecheese, (*2)
The decorator pattern works by wrapping other objects in with new methods, simply by passing them as the constructor. You can wrap as many decorators as you like around the same object. It is also great for separating some of your logic from your model, so model classes don't get cluttered., (*3)
An example of this within the Silverstripe Framework is the way the SS_ListDecorator works., (*4)
You could use this pattern in more than just a form. You could wrap DataObjects who only need temporary functionality that you can easily inject/change without changing the underlying model class., (*5)
Extensions are great, but sometimes not every Object will need that extension (for example, I wouldn't need a form within the CMS to use Twitter Bootstrap templates and functionality)., (*6)
Decorators work on a per instance rather than on a per class basis, and sometimes that is what you really need., (*7)
If you prefer the extensions version, unclecheese offers the bootstrap-form extension by @unclecheese., (*8)
The default Silverstripe validator does not support JS validation at this stage, so I use the zen validator by @sheadawson. I have included some constraints that work nicely with the FormFieldBootstrapper decorator., (*9)
Add the following to your composer.json file, (*10)
"require" : { "milkyway-multimedia/silverstripe-zen-forms": "dev-master" }
It is quite simple to use and easy to make your own. For example, if you would like a Form confirming to the Twitter Bootstrap layout scheme, you would do the following when defining your form:, (*11)
// $form now has FormBootstrapper methods attached, as well as the underlying form methods $form = new FormBootstrapper(new Form($controller, $name, $fields, $actions));
You can also wrap as many as you need to:, (*12)
$form = new ModaliseForm(new FormBootstrapper(new Form($controller, $name, $fields, $actions)));
Below are some of the decorators that come with the module. There is more documentation for each one in the docs/ folder, (*13)
To make your own, you can simply extend the specific Decorator, the BaseDecorator or implement \Milkyway\ZenForms\Contracts\Decorator., (*14)
class TreatDataObjectSpecial extends BaseDecorator { // Do something special with the decorator, and you can refer to original object using $this->original(); } class TreatFormFieldSpecial extends FormFieldDecorator { // Do something special with the decorator, and you can refer to original object using $this->original(); }
This module automatically pulls in the Silverstripe ZenValidator module, since it adds new constraints., (*15)
When you wrap the ConfirmedPasswordField, it allows you to use the password measure helper and password generator. It only works properly when wrapped with the FormFieldBootstrapper though, and you must include jquery.complexify.js in your scripts for it to work (it is not included with the module)., (*16)
Allow you to decorate Silverstripe Forms before displaying, adding extra functionality
MIT
bootstrap forms mwm
Allow you to decorate Silverstripe Forms before displaying, adding extra functionality
MIT
bootstrap forms mwm