Strehler::FormFu::Element::Category - FormFu Element for Strehler Category Selector.
A FormFu element to encapsulate all the frontend logic for category selection. It's just a Block element with a particular configuration file hard-coded in it. Category selector needs to be identified in a clear way and needs a fixed structure because it has to interact with Strehler javascript library.
This element hasn't the standard HTML::FormFu elements namespace because it makes sense only in a Strehler system.
In article form:
- type: "+Strehler::FormFu::Element::Category"
The label displayed for the field. "Category" is the default value.
The name of the field containing information about the category (the ID). "category" is the default value.
Category is usually mandatory on categorized entities. If you want a category field NOT required set this parameter to 1.
<fieldset class="category-widget"> <div class="sel-category-input"> <div> <label>Category</label> <input name="category-name" type="text" class="sel-category-name"> </div> <button class="btn btn-warning sel-category-back" type="button"> < </button> <img class="sel-category-loader" src="/strehler/images/ajax-loader.gif" style="display: none;"> </div> <div> <select name="category-combo" class="sel-category-combo"> <option value="1">cat1</option> <option value="2">cat2</option> </select> </div> <input name="category" type="hidden" value="22" class="sel-category-id" id="category"> <input name="category-parent" type="hidden" class="sel-category-parent" value=""> </fieldset>
Options are inserted dinamically during form generation. Sub-category display attributed is managed by javascript.
For the complete configuration see in the package: forms/admin/elements/category_multi.yml
To install Strehler, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Strehler
CPAN shell
perl -MCPAN -e shell install Strehler
For more information on module installation, please visit the detailed CPAN module installation guide.