Input Controls Types and Parameters
Contents
- 1 Text Area
- 2 Textarea with Presets
- 3 Rich Edit Text Area
- 4 Text Field
- 5 Multiple text field
- 6 Text field with presets
- 7 Select Box
- 8 Radio button
- 9 Date
- 10 Check box
- 11 Multiple Checkboxes
- 12 Multiple Selectbox
- 13 Two boxes
- 14 File upload
- 15 Related Item Window
- 16 Do not show
- 17 Hierarchical constants
- 18 Password and Change password
- 19 Hidden field
- 20 Local URL picker
Text Area
Text area with 60 columns
Parameters:
| name | type | description | example |
| row count | (integer number) | 20 |
Textarea with Presets
Text area with values names list. When you choose a name from the list, the appropriate value is printed in the text area Parameters:
| name | type | description | example |
| rows | (integer number) | Textarea rows | 4 |
| cols | (integer number) | Text area columns | 60 |
Rich Edit Text Area
Rich edit text area. This operates the same way as Text Area in browsers which don't support the Microsoft TriEdit library. In IE 5.0 and higher and in Netscape 4.76 and higher (after installing the necessary features) it uses the TriEdit to provide an incredibly powerful HTML editor. Another possibility is to use the iframe version which should work in IE on Windows and Mac (set the 3rd parameter to "iframe"). The code for this editor is taken from the Wysiwyg open project (http://www.unica.edu/uicfreesoft/) and changed to fullfill our needs. See http://www.unica.edu/uicfreesoft/wysiwyg_web_edit/Readme_english.txt on details how to prepare Netscape. The javascript code needed to provide the editor is saved in two HTML files, so that the user doesn't have to load it every time she reloads the Itemedit web page. Parameters:
| name | type | description | example |
| row count | (integer number) | 10 | |
| column count | (integer number) | 70 | |
| type | type: class (default) / iframe | class |
Text Field
A text field. Parameters:
| name | type | description | example |
| max characters | (integer number) | max count of characters entered (maxlength parameter) | 254 |
| width | (integer number) | width of the field in characters (size parameter) | 30 |
Multiple text field
Text field input type which allows you to enter more than one (multiple) values into one field (just like if you select multiple values from Multiple Selectbox). The new values are filled by popup box. Parameters:
| name | type | description | example |
| Show Actions | (any text) | Which action buttons to show: M - Move (up and down) D - Delete value, A - Add new value C - Change the value Use 'MDAC' (default), 'DAC', just 'M' or any other combination. The order of letters M,D,A,C is not important. | MDAC |
| Row count | (integer number) | Number of rows (values) displayed at once | 6 |
Text field with presets
Text field with values names list. When you choose a name from the list, the appropriate value is printed in the text field Parameters:
| name | type | description | example |
| max characters | (integer number) | max count of characteres entered in the text field (maxlength parameter) | 254 |
| width | (integer number) | width of the text field in characters (size parameter) | 20 |
| slice field | (field id) | field (or format string) that will be displayed in select box (from related slice). if not specified, in select box are displayed headlines. you can use also any AA formatstring here (like: _#HEADLINE - _#PUB_DATE). (only for constants input type: slice) | category........ |
| use name | (boolean: 0=false,1=true) | if set (=1), then the name of selected constant is used, insted of the value. Default is 0 | |
| adding | (boolean: 0=false,1=true) | adding the selected items to input field comma separated | |
| secondfield | (field id) | field_id of another text field, where value of this selectbox will be propagated too (in main text are will be text and there will be value) | source_href..... |
| add2constant | (boolean: 0=false,1=true) | if set to 1, user typped value in inputform is stored into constants (only if the value is not already there) | |
| Show items from bins | (integer number) | (for slices only) To show items from selected bins, use following values: Active bin - '1' Pending bin - '2' Expired bin - '4' Holding bin - '8' Trash bin - '16' Value is created as follows: eg. You want show headlines from Active, Expired and Holding bins. Value for this combination is counted like 1+4+8 = 13 | 3 |
| Filtering conditions | (any text) | (for slices only) Conditions for filtering items in selection. Use conds[] array. | conds[0][category.......1]=Enviro&conds[1][switch.........2]=1 |
| Sort by | (any text) | (for slices only) Sort the items in specified order. Use sort[] array | sort[0][headline........]=a&sort[1][publish_date....]=d |
Select Box
A selectbox field with a values list. It uses the Constants select box - if you choose a constant group there, the constants of this group will be printed, if you choose a slice name, the headlines of all items will be printed (used for related stories or for setting relation to another slice, usually with the f_v alias function) Parameters:
| name | type | description | example |
| slice field | (field id) | field (or format string) that will be displayed in select box (from related slice). if not specified, in select box are displayed headlines. you can use also any AA formatstring here (like: _#HEADLINE - _#PUB_DATE). (only for constants input type: slice) | category........ |
| use name | (boolean: 0=false,1=true) | if set (=1), then the name of selected constant is used, insted of the value. Default is 0 | |
| Show items from bins | (integer number) | (for slices only) To show items from selected bins, use following values: Active bin - '1' Pending bin - '2' Expired bin - '4' Holding bin - '8' Trash bin - '16' Value is created as follows: eg. You want show headlines from Active, Expired and Holding bins. Value for this combination is counted like 1+4+8 = 13 | 3 |
| Filtering conditions | (any text) | (for slices only) Conditions for filtering items in selection. Use conds[] array. | conds[0][category.......1]=Enviro&conds[1][switch.........2]=1 |
| Sort by | (any text) | (for slices only) Sort the items in specified order. Use sort[] array | sort[0][headline........]=a&sort[1][publish_date....]=d |
Radio button
Radio button group - the user may choose one value of the list. It uses the Constants select box - if you choose a constant group there, the constants of this group will be printed, if you choose a slice name, the headlines of all items will be printed (used for related stories or for setting relation to another slice - it is obviously used with f_v alias function then) Parameters:
| name | type | description | example |
| Columns | (integer number) | Number of columns. If unfilled, the checkboxes are all on one line. If filled, they are formatted in a table. | 3 |
| Move right | (boolean: 0=false,1=true) | Should the function move right or down to the next value? | 1 |
| Slice field | (field id) | Field (or format string) that will be displayed as radiobuton's option (from related slice). if not specified, in select box are displayed headlines. you can use also any AA formatstring here (like: _#HEADLINE - _#PUB_DATE). (only for constants input type: slice) | category........ |
| Show items from bins | (integer number) | (for slices only) To show items from selected bins, use following values: Active bin - '1' Pending bin - '2' Expired bin - '4' Holding bin - '8' Trash bin - '16' Value is created as follows: eg. You want show headlines from Active, Expired and Holding bins. Value for this combination is counted like 1+4+8 = 13 | 3 |
| Filtering conditions | (any text) | (for slices only) Conditions for filtering items in selection. Use conds[] array. | conds[0][category.......1]=Enviro&conds[1][switch.........2]=1 |
| Sort by | (any text) | (for slices only) Sort the items in specified order. Use sort[] array | sort[0][headline........]=a&sort[1][publish_date....]=d |
Date
you can choose an interval from which the year will be offered Parameters:
| name | type | description | example |
| Starting Year | (integer number) | The (relative) start of the year interval | 1 |
| Ending Year | (integer number) | The (relative) end of the year interval | 10 |
| Relative | (boolean: 0=false,1=true) | If this is 1, the starting and ending year will be taken as relative - the interval will start at (this year - starting year) and end at (this year + ending year). If this is 0, the starting and ending years will be taken as absolute. | 1 |
| Show time | (boolean: 0=false,1=true) | show the time box? (1 means Yes, undefined means No) | 1 |
Check box
Multiple Checkboxes
Multiple choice checkbox group. It uses the Constants select box - if you choose a constant group there, the constants of this group will be printed, if you choose a slice name, the headlines of all items will be printed (used for related stories or for setting relation to another slice - it is obviously used with f_v alias function then) Parameters:
| name | type | description | example |
| Columns | (integer number) | Number of columns. If unfilled, the checkboxes are all on one line. If filled, they are formatted in a table. | 3 |
| Move right | (boolean: 0=false,1=true) | Should the function move right or down to the next value? | 1 |
| Slice field | (field id) | Field (or format string) that will be displayed as checbox options (from related slice). if not specified, in select box are displayed headlines. you can use also any AA formatstring here (like: _#HEADLINE - _#PUB_DATE). (only for constants input type: slice) | category........ |
| Show items from bins | (integer number) | (for slices only) To show items from selected bins, use following values: Active bin - '1' Pending bin - '2' Expired bin - '4' Holding bin - '8' Trash bin - '16' Value is created as follows: eg. You want show headlines from Active, Expired and Holding bins. Value for this combination is counted like 1+4+8 = 13 | 3 |
| Filtering conditions | (any text) | (for slices only) Conditions for filtering items in selection. Use conds[] array. | conds[0][category.......1]=Enviro&conds[1][switch.........2]=1 |
| Sort by | (any text) | (for slices only) Sort the items in specified order. Use sort[] array | sort[0][headline........]=a&sort[1][publish_date....]=d |
Multiple Selectbox
Multiple choice select box. It uses the Constants select box - if you choose a constant group there, the constants of this group will be printed, if you choose a slice name, the headlines of all items will be printed (used for related stories or for setting relation to another slice - it is obviously used with f_v alias function then) Parameters:
| name | type | description | example |
| Row count | (integer number) | 5 | |
| Slice field | (field id) | field (or format string) that will be displayed in select box (from related slice). if not specified, in select box are displayed headlines. you can use also any AA formatstring here (like: _#HEADLINE - _#PUB_DATE). (only for constants input type: slice) | category........ |
| Show items from bins | (integer number) | (for slices only) To show items from selected bins, use following values: Active bin - '1' Pending bin - '2' Expired bin - '4' Holding bin - '8' Trash bin - '16' Value is created as follows: eg. You want show headlines from Active, Expired and Holding bins. Value for this combination is counted like 1+4+8 = 13 | 3 |
| Filtering conditions | (any text) | (for slices only) Conditions for filtering items in selection. Use conds[] array. | conds[0][category.......1]=Enviro&conds[1][switch.........2]=1 |
| Sort by | (any text) | (for slices only) Sort the items in specified order. Use sort[] array | sort[0][headline........]=a&sort[1][publish_date....]=d |
Two boxes
Two Boxes. It uses the Constants select box - if you choose a constant group there, the constants of this group will be printed, if you choose a slice name, the headlines of all items will be printed (used for related stories or for setting relation to another slice - it is obviously used with f_v alias function then) Parameters:
| name | type | description | example |
| Row count | (integer number) | 5 | |
| Title of "Offer" selectbox | (any text) | Our offer | |
| Title of "Selected" selectbox | (any text) | Selected | |
| Slice field | (field id) | field (or format string) that will be displayed in the boxes (from related slice). if not specified, in select box are displayed headlines. you can use also any AA formatstring here (like: _#HEADLINE - _#PUB_DATE). (only for constants input type: slice) | category........ |
| Show items from bins | (integer number) | (for slices only) To show items from selected bins, use following values: Active bin - '1' Pending bin - '2' Expired bin - '4' Holding bin - '8' Trash bin - '16' Value is created as follows: eg. You want show headlines from Active, Expired and Holding bins. Value for this combination is counted like 1+4+8 = 13 | 3 |
| Filtering conditions | (any text) | (for slices only) Conditions for filtering items in selection. Use conds[] array. | conds[0][category.......1]=Enviro&conds[1][switch.........2]=1 |
| Sort by | (any text) | (for slices only) Sort the items in specified order. Use sort[] array | sort[0][headline........]=a&sort[1][publish_date....]=d |
File upload
File upload - a text field with the file find button Parameters:
| name | type | description | example |
| Allowed file types | (any text) | image/* | |
| Label | (any text) | To be printed before the file upload field | File: |
| Hint | (any text) | appears beneath the file upload field | You can select a file ... |
Related Item Window
List of items connected with the active one - by using the buttons Add and Delete you show a window, where you can search in the items list Parameters:
| name | type | description | example |
| Row count | (integer number) | Row count in the list | 15 |
| Buttons to show | (any text) | Defines, which buttons to show in item selection: A - Add M - add Mutual B - Backward Use 'AMB' (default), 'MA', just 'A' or any other combination. The order of letters A,M,B is important. | AMB |
| Admin design | (boolean: 0=false,1=true) | If set (=1), the items in related selection window will be listed in the same design as in the Item manager - 'Design - Item Manager' settings will be used. Only the checkbox will be replaced by the buttons (see above). It is important that the checkbox must be defined as: <input type=checkbox name="chb[x_#ITEM_ID#]" value="1"> (which is default). If unset (=0), just headline is shown (default). | |
| Tag Prefix | (any text) | Selects tag set ('AMB' / 'GYR'). Ask Mitra for more details. | AMB |
| Show Actions | (any text) | Which action buttons to show: M - Move (up and down) D - Delete relation, R - add Relation to existing item N - insert new item in related slice and make it related E - Edit related item Use 'DR' (default), 'MDRNE', just 'N' or any other combination. The order of letters M,D,R,N,E is not important. | MDR |
| Show headlines from selected bins | (integer number) | To show headlines in related window from selected bins. Use this values for bins: Active bin - '1' Pending bin - '2' Expired bin - '4' Holding bin - '8' Trash bin - '16' Value is created as follows: eg. You want show headlines from Active, Expired and Holding bins. Value for this combination is counted like 1+4+8 = 13 | 3 |
| Filtering conditions - unchangeable | (any text) | Conditions for filtering items in related items window. This conds user can't change. | |
| Filtering conditions - changeable | (any text) | Conditions for filtering items in related items window. This conds user can change. | |
| Slice field | (field id) | field (or format string) that will be displayed in the boxes (from related slice). if not specified, in select box are displayed headlines. you can use also any AA formatstring here (like: _#HEADLINE - {publish_date....}). | publish_date.... |
Do not show
This option hides the input field.
Hierarchical constants
A view with level boxes allows to choose constants. Parameters:
| name | type | description | example |
| Level count | (integer number) | Count of level boxes | 3 |
| Box width | (integer number) | Width in characters | 60 |
| Size of target | (integer number) | Lines in the target select box | 5 |
| Horizontal | (boolean: 0=false,1=true) | Show levels horizontally | 1 |
| First selectable | (integer number) | First level which will have a Select button | |
| Level names | Names of level boxes, separated by tilde (~). Replace the default Level 0, Level 1, ... | Top level~Second level~Keyword |
Password and Change password
Password input boxes allowing to send password (for password-protected items) and to change password (including the "Retype password" box). When a user fills new password, it is checked against the retyped password, MD5-encrypted so that nobody may learn it and stored in the database. If the field is not Required, shows a 'Delete Password' checkbox. Parameters:
| name | type | description | example |
| Field size | (integer number) | Size of the three fields | 60 |
| Label for Change Password | (any text) | Replaces the default 'Change Password' | Change your password |
| Label for Retype New Password | (any text) | Replaces the default "Retype New Password" | Retype the new password |
| Label for Delete Password | (any text) | Replaces the default "Delete Password" | Delete password (set to empty) |
| Help for Change Password | (any text) | Help text under the Change Password box (default: no text) | To change password, enter the new password here and below |
| Help for Retype New Password | (any text) | Help text under the Retype New Password box (default: no text) | Retype the new password exactly the same as you entered into "Change Password". |
Hidden field
The field value will be shown as <input type='hidden'. You will probably set this filed by javascript trigger used on any other field.
Local URL picker
You can use this window to browse your local web site and pick the URL that you want to use. Parameters:
| name | type | description | example |
| URL | (any text) | The URL of your local web server from where you want to start browsing for a particular URL. | http#://www.ecn.cz/articles/solar.shtml |
