Note: All
field types have common field properties
which are described separately.CommunityZero®Help
Select lists allow members to choose from a variety of options on the add and update record form. The field may be presented as a single select list where only one of the presented options may be chosen, or as a multi-select list where several options may be chosen.
For single select lists, the field layout may be configured as a drop-down menu or a series of radio buttons. Multi-select lists on the other hand may be configured as a multi-select box or presented as a series of check boxes.
When configuring select list fields, it is important to consider the common field properties, field specific properties, and select list option properties that are available for use. The field specific and select list option properties are defined below.
Note: All
field types have common field properties
which are described separately.
This set of properties is used specifically for configuring select list fields.
Selection Type
Select if users are to choose only one option or can select multiple options from the selection list. Minimum and maximum selections can be defined in the their respective fields if desired.
Minimum Selections
Enter the minimum number of selections that must be made. If this field is required, at least one selection must be made regardless of this setting.
Maximum Selections
Enter the maximum number of selections that can be made. Leave this field blank to not enforce a limit.
Option Listing/Drop-down selection box
Select the type of selection list desired: option listing shows each option on the page in one or more columns, while drop-down selection box places options in a single form element (options are browsed in a smaller area). The option listing setting is easiest to use but takes up more space on the form.
Display as "x" Columns of options
Enter the number of columns used to display the options on the add and update record forms.
Note:
This option
does not apply to nested select lists. Select lists with
nested options will only be displayed in one column.
Input Width
Enter a number that represents the desired width or space provided to enter content for this field on the form (i.e. enter 50 for 50 pixels).
Input Height
Enter a number that represents the number of visible rows of options displayed in the drop-down selection box.
This set of properties is used for configuring the available list of options presented to users on the add and update record forms.
Language
The language drop-down menu only appears if multilingual support has been enabled for the site. It is used in conjunction with the display label. Select a language from the drop-down menu and complete the field ( note that this field is not required). The text entered for the field will appear in the database tool when the respective community display language has been selected. Select another language and complete the field if multilingual support is desired.
Adding Options
Type or copy-paste into the area a list of possible options for selection. Enter one option per line. Options can be further customized after they are created.
Allow Dynamic All Option
Check this box to include an option in the select list, which permits choosing all options by selecting only one option from the list. When used with nested select lists, all nested sub-level select list options will be chosen as well. If this box is checked, an "All" option will only appear while "Adding and Updating Records", it will not appear in the "Selection Options" box.
All Option Label
When "Allow Dynamic All Option" is selected, a text box will appear allowing a custom label to be entered for the dynamic all option. For example, if the select list contains a list of countries, a more descriptive label such as "Global" may be entered. If no text is entered, a default of "All" will appear while "Adding and Updating Records".
This box is used to display the list of selectable
options that will be available on the add and update record forms.
Select lists support up to three nested levels of options (e.g. "Country
> State/Province > City" or "Product > Edition >
Version"). To configure selectable options as nested, highlight an
option in the box, and press the add indent button (button with two arrows
pointing to the right). The selectable option will move one position to
the right.
Display Label
Each option may have a display label (one for each supported language). If the label is not defined, the key will appear.
Note:
If
the display label is completed in only one language, the text entered
will be displayed for each language the community supports.
Option Key
Each option must have a key value (language independent). If a display label is defined, the key will not appear. The key is the value included in database exports.
Trigger
Each selection option has the capability of making the record hidden or unhidden. Once a record has become hidden, only members with the view hidden record permission will be able to see the record in the database. To apply a Trigger to a selection option, highlight the option in the left hand table, then select one of the three Triggers to apply. Select "Do Nothing" to leave the record's hidden setting unmodified, "Hide Record" to hide the record from members without the view hidden record permission, or "Unhide Record" to make the record viewable to all members.
Note:
If a Trigger has been set for a selection option, the hide
record checkbox will be removed from the add and update record forms.
If field
sets have been used to split record entry into multiple pages, the
hide record checkbox will appear on the last page, assuming the select
list option does not exist on the last page as well.
Move Up
Select an option and press the button labeled "Move Up" to reposition the item relative to other positions.
Move Down
Select an option and press the button labeled "Move Down" to reposition the item relative to other positions.
Remove
Deletes a chosen option from the list of selectable items. Changes will not take effect until the button labeled "Apply Changes" is pressed.
Default
Marks the chosen option from the list of selectable items as a default selection. Default selections are indicated with a "+" to the left of their key name.
This set of options will appear if at least one nested select list option has been added in the selection options box. These options are provided to further configure nested select lists. For example if a select list is created, which contains three levels of options, the following text may be provided to further describe the field (e.g. "Country > State/Province > City").This text would appear directly above the select list while "Adding and Updating Records". Using this example, "Country" would be entered in the "Label #1" field, "State/Province" in the "Label #2" field, and "City" would be entered in the "Label #3" field.
Language
The language drop-down menu only appears if multilingual support has been enabled for the site. It is used in conjunction with the Label options. Select a language from the drop-down menu and complete the fields (note these fields are not required). The text entered for these fields will appear in the database tool when the respective community display language has been selected. Select another language and complete the fields if multilingual support is desired.
Label #1
Enter optional text to be displayed above the select list while adding and updating records. This label represents the top-most option of a nested select list, and can be added to provide further description.
Label #2
Enter optional text to be displayed above the select list while adding and updating records. This label represents the second option of a nested select list, and can be added to provide further description.
Label #3
Enter optional text to be displayed above the select list while adding and updating records. This label represents the innermost option of a nested select list, and can be added to provide further description.
Hide on Summary
Selecting this checkbox will remove the associated nested option from the summary table. Using the example above, hiding "Label #2" would result in all city selections being hidden on the database summary table.
Level of selection required
Choose the level of nested selection that is required by members while adding and updating records. If "1st" is selected, only the top-most nested selection option is required. If "3rd" is selected, all three levels of options must be selected before a record can be added or updated. The default selection is "None".