NAME
Strehler::FormFu::Element::Category - FormFu Element for Strehler Category Selector.
DESCRIPTION
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.
SYNOPSIS
In article form:
- type: "+Strehler::FormFu::Element::Category"
PARAMETERS
- label
-
The label displayed for the field. "Category" is the default value.
- name
-
The name of the field containing information about the category (the ID). "category" is the default value.
- not_required
-
Category is usually mandatory on categorized entities. If you want a category field NOT required set this parameter to 1.
GENERATED HTML
<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.
YAML CONFIGURATION
For the complete configuration see in the package: forms/admin/elements/category_multi.yml