This document describes the tree representation of categories. With this hierarchical structure the shop manager can assign categories to different artifacts in the back office in one step.
The Catalog Category Tree Component is implemented as an ISML module for easy reuse. The module is called "CategoryTree" and is located in the sld_enterprise_app cartridge.
The Catalog Category Tree Component is based on the jQuery Dynatree Plugin.
The ID of the tree.
Defines if checkboxes or radio buttons are used. Possible values are single/multiple/multiplehier. When single is chosen, a tree with radio buttons is displayed. Values multiple and multiplehier will render a tree with checkboxes. When multiplehier is chosen, clicking the checkbox besides category will also select the category's child categories.
Number of levels that are not expandable, default 1.
Title of the tree, e.g. "Standard Catalog".
Defines if selected sub-categories of a category are displayed as disabled.
Defines if sub-categories of selected categories will also be selected.
An iterator with Catalog Categories to be displayed.
An iterator that contains the UUIDs of categories already assigned to the object.
An iterator of UUIDs representing categories that should be displayed disabled.
The pipeline (PipelineName-PipelineNodeName) which views the category details page.
The name of the parameter that holds the category UUID.
The name of the parameter which are added to the category URL.
The value of the parameter which are added to the category URL.
An iterator of category UUIDs that are marked as lazy-loaded. If a category is marked as lazy-loaded, its child categories are not loaded when the tree is initialized.
For more information consult the documentation.
It is possible to make the category node a link. When the parameter disabledcategories is set, the li tag that represents the category node contains a tag that points to a pipeline defined in disabledcategories.
When a category has a large number of sub-categories, the loading of this category takes time and results in a large HTML file. To reduce the time for loading the page with the tree it is possible to mark the category as lazy-loaded. This is done by adding marker class lazy to the li element representing the category. The user of the CategoryTree module should pass an iterator of categories. See Configurations.
When a category is marked as lazy-loaded, the Dynatree will not create its children nodes. The children categories will be created only when the user expands the category. By expanding an Ajax request to dedicated pipeline is made. Details about this Ajax request are given in tree options (see Use of jQuery Dynatree Plugin) by defining onLazyRead.
The UUIDs of all selected categories are submitted by default. If the parameter autoselectdisablesubcategories is set to true, only UUIDs of parent categories are submitted. This behavior is managed by jQuery delegate set to form element (see CategoryTree.isml).