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">
                &lt;
            </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