mzcategoryselection

Description

Category selection data type for eZ publish

This is a branch for eZ publish 4.1

By default, eZ publish only supports selection data type. But selection data type doesn't relate to each other, which means your selection of one "selection" field won't affect other "selection" fields. Sometimes, you need define dependencies between "selection" fields. For example, you might need define three fields (country, city and area) in a content class and define the dependencies between them. The city field depends on country and area field depends on city field.

ezcategoryselection extension was developed to fulfill such requirements. It introduced a new data type - ezcategoryselection which allows you to bind one or more categories to options of an ezcategoryselection attribute.

The categories may come from:

- selection attributes defined in same content class
- ezcategoryselection attributes defined in same content class
- selection attributes defined in other content class
- ezcategoryselection attributes defined in other content class

You can also bind a combination of categories (category and its values) to a group of options. For example, you may bind color [ 'red' | 'black' ] and size ['large' | 'medium' | 'small' ] to option 1 to option 10 of the 'product' attribute (which is ezcategoryselection data type).

The following illustration and description explains how to use ezcategoryselection data type:

1. threshold - this field holds an integer which can be used as a threshold for different purposes

2. description - this field holds the description for current ezcategoryselection attribute.

3. cross class - specifying if current ezcategoryselection attribute may be binded to external categories or not. 'No' by default, which means you can only bind categories defined in current content class to this attribute. If you set it to 'Yes', a 'class drop down' list will show up to allow you specify external categories.
Note:
When editing content object or submitting information collection form, external category binds will be ignored and won't affect the visibilities of ezcategoryselection options.

4. attribute drop down list - lists attributes with 'selection' or 'ezcategoryselection' data type

5. category drop down list - lists option values of the selected category attribute in the attribute drop down list.

6. remove selected category - select categories with the check boxes and click on “remove selected” button to remove the selected categories.

7. refresh category - click the “refresh category” button to re-load attribute list and category list.

8. bind category
* select options with its check boxes. (please refer to item 11.)
* select categories with category check boxes.
* select category values with category drop down list. (please refer to item 5)
* click “bind category” to bind selected categories and values to selected options.

9. new category - click the “new category” button to add a new category. After the category is added, you need click “refresh category” (item 7) to re-load attribute drop down list and category drop down list.

10. option label - display information of the binded categories and values

11. option id - display the system id of each option. Each option has an unique id, the id does not change with the order of each option. So please note option id is different with option index.

12. moving options up/down - click on 'down' or 'up' button to move option down or up in same group.

13. remove selected option - select options with check boxes and click “remove selected” button to remove selected options.

14. new option - click this button to add a new option.