|
|
Fields tab |
|
|
|
|
|
Fields tab |
|
|
|
|
|
|
Fields tab |
|
|
|
|
|
Fields tab |
|
|
|
|
|
|
||
On this tab, you can define fields that will be used in the form. The following actions are available:
•Move up (
) - moves the field up, which changes its position in the form.
•Move down (
) - moves the field down, which changes its position in the form.
•New category (
) - creates a new category for fields. Fields belonging to a category are grouped together and displayed under a header in the form.
•New attribute (
) - adds a new field.
•Delete item (
) - deletes the currently selected field.
Column name |
Name of the database table column. |
Show on public form |
If unchecked, this attribute will be displayed only in CMS Desk (not on the form on the live site). |
Field caption |
Text displayed next to the field. |
Field type |
Defines input type for this field. |
Maximum length |
Maximum length of the field value. |
Allow empty value |
If unchecked, validation check for empty value in the field will be performed when the form is submitted. |
Default value |
Default value of the field that will be pre-filled when the form is displayed. |
The properties available under the Field settings section depend on the selected Field type. Please see the property tooltips for more information.
Please note: Not all options may be available depending on the selected Attribute type.
Database |
|
Column name |
The name that will be used for the database column storing the values of the field. It will also serve to identify the field. |
Attribute type |
Type of value that the field should contain. |
Attribute size |
Sets the maximum amount of characters that can be entered into the field. Only available if the Attribute type is set to Text. |
Allow empty value |
Enable this if you do not wish the field to be checked for empty values. If not enabled, an asterisk (*) will be displayed next to the attribute. |
Default value |
Default value of the field that will be pre-filled when the form is displayed. |
Display attribute in the editing form |
If you uncheck this property, then the given field will not be available for editing. |
Field appearance |
|
Field caption |
Text displayed next to the field. |
Form control type |
Filters the options available in the Form control drop-down list below according to their type. |
Form control |
Sets the specific form control that should be used in the form to interact with the given field. |
Field description |
Tooltip which will be displayed if a user hovers over the field. |
Has depending fields |
Indicates that other fields may be updated dynamically depending on the value of the given field. |
Depends on another field |
Indicates that the behaviour (e.g. the available selection options) of the given field can be affected depending on the value of some other field. |
Editing control settings |
|
The settings in this section are used to perform additional configuration of the selected Form control, which affects the behaviour or appearance of the field. Please see individual tooltips for more information. |
|
Validation |
|
Regular expression |
This regular expression will be used by the validator of the field. Only available if the selected Attribute type is Text or Long text. |
Min/Max length |
Sets the minimum/maximum length for entered values. Only available if the selected Attribute type is Text or Long text. |
Min/Max value |
Sets the minimum/maximum value that can be entered. Only available if the selected Attribute type is numerical. |
From/To |
Can be used to specify a time interval into which the entered value must belong. Only available if the selected Attribute type is Date and time. |
Error message |
Error message displayed if a user enters invalid input into the field and attempts to save the form. |
CSS styles |
|
Caption style |
Used to set CSS styles for the caption of the given field. |
Input style |
Used to set CSS styles for the input entered into the field. |
Control CSS class |
Name of the CSS class used to style the field. |
Any changes to field settings must be confirmed by clicking the 
Save field button at the top.
Detailed information about the Forms module can be found in Developer's Guide -> Modules -> Forms. Please refer to Developer's Guide -> Development -> Form controls to learn more about form fields and their configuration.