Controls
Available controls
The table below lists the available controls within the Smartsite 7 manager.
| Name | Description |
|---|---|
| binaryfield | Renders an upload control to select a file. The file's data will be stored within the binary field. |
| checkbox | Renders a checkbox. |
| checkboxlist | Renders a list of checkboxes allowing the user to choose one or more values. |
| codemirror | Renders a Code Mirror control. |
| customlinkinput | Renders as a text box with a single button, which opens the configured library to select a record. |
| customlistinput | Renders a list input control with a single (select) button, which opens the configured library to select one or more record(s). |
| datepicker | Renders a date picker control. |
| datetimepicker | Renders a date picker control which also includes a time picker element. |
| dropdowncombo | Renders a combo box allowing the user to either choose a value from the list, or enter a free text value. |
| dropdownlist | Renders a drop down list allowing the user to choose a single value. |
| duallist | Renders a dual list that allows the user to select multiple entries. Selected entries are shown on the right, unselected entries on the left. |
| fileinput | Renders as a text box with 1 button to choose a link using the File explorer. |
| filelistinput | Renders a list control with a button to select files. |
| geolistinput | Renders a geo list input, which allows the user to create and edit a list of geographic locations, which can be pointed out on a map in a sub-action using Google Maps. |
| imagebox | Renders a file upload control for images. |
| imagecropper | Renders the image cropper control, which allows a user to crop an image selected in a different control to an optional given aspect ratio, minimum and maximum size. |
| iteminput | Renders as a text box with 3 buttons to choose a link using the Content tree, Content Library or the Media Library. |
| itemlistinput | The item list input control is like the list input control, but it does not allow free text input for entries. |
| label | Renders the specified text as a label. |
| linkinput | Renders as a text box with 4 buttons to choose a link using the Content tree, Content Library, Media Library or the File explorer. |
| linklistinput | Renders a list control with buttons to select items and/or files. |
| listbox | Renders a simple list box that allows the user to select multiple entries. |
| listinput |
Renders a list input control, which allows users to manipulate a list of entries. Entries can be added, removed or updated. |
| mediacontrol | Renders a control which allows the user to select (and deselect) multiple images or videos from the Media Library. |
| output | Renders an output control. |
| password | Renders a password control. |
| radiobuttonlist | Renders a list of radio buttons allowing the user to choose a single value. |
| sxmleditor | Renders the Sxml Editor. |
| textbox | Renders a textbox. |
| textarea | Renders a textarea. |
| thesauruscontrol | Renders a list input control and a single (select) button, which opens the appropriate thesterms library to select one or more thesterms from. |
| tinymce | Renders a TinyMCE editor. |
| userinput | Renders a textbox and a select button, which opens the User library to select an user |
| youtubeinput | Renders as a text box with 1 button to choose a link using the YouTube plugin. |
Auto-detecting control type
As mentioned below, the control type for a specific contenttype field can be set using the cms:control contenttype field property. When this ctfp has not been specified, auto detection is used to determine the appropriate control type for a specific contenttype field.
The following "rules" are applied when finding an appropriate control type:
| Datatype | Additional/other condition | EditProgId (case insensitive) | Control type |
|---|---|---|---|
| Boolean | N/A | Checkbox | |
| String | SixSWE.WebEditor | HtmlEdit | SixSmartUI.HtmlEdit | TinyMCE | |
| String | SXmlEditor | SixSmartUI.SXmlEditor | SxmlEditor | |
| String | LinkInput | SixSmartUI.LinkInput | LinkInput | |
| String | ListInput | SixSmartUI.ListInput | ListInput | |
| String |
any of the following ctfps
|
ListInput | SixSmartUI.ListInput | GeoListInput |
| String | cust:cropping_sourcefield ctfp | N/A | ImageCropper |
| String |
Maxlength for the contenttype field <= 500 (database definition or ctrl:MaxLength ctfp) |
N/A | Textbox |
| String |
Maxlength for the contenttype field > 500 (database definition or ctrl:MaxLength ctfp) |
N/A | TextArea |
| N/A | cms:LookupQuery or LookupQuery ctfp | DropdownList | SixSmartUI.DropdownList | DropdownList |
| N/A | cms:LookupQuery or LookupQuery ctfp | DropdownCombo | SixSmartUI.DropdownCombo | DropdownCombo |
| N/A | cms:LookupQuery or LookupQuery ctfp | Any other EditProgId | |
| DateTime | N/A | ||
| Base64Binary | N/A | ||
| N/A | LookupList relation | N/A |
(when the lookup list represents a bit pattern: CheckBoxList) |
| N/A | 1-m relation | N/A | |
| N/A |
m-m relation, and ContentRelation = "IMAGES" or "VIDEO" or "MOVIE" or "MOVIES" |
SixSmartUI.ItemListInput | |
| N/A | m-m relation, any other ContentRelation | SixSmartUI.ItemListInput | ItemListInput |
| N/A | m-m relation | SixSmartUI.DropdownList | DropdownList |
| N/A | m-m relation | Any other EditProgId | DualList |
When no control type could be determined applying above "rules", the control type is set to TextBox.
Notice
As of Smartsite 8.0, the EditProgId ctfp plays no part anymore, in fact it has been replaced with an appropriate cms:control ctfp.
However, when there's no cms:control available on a specific field, auto-detecting the control type will still be used based on the other "rules" stated above.