Fields

To add field set to the form press Add Field button in the form edit screen.

add field

After that you will be redirected to Field edit screen.

Field parameters

Information

Name

Field name displayed in the form.

Comment

Html text displayed under the input. To display comment as a tooltip please use {{tooltip}}...{{/tooltip}} code or {{tooltip val="Option text"}}...{{/tooltip}} to display the tooltip near the Select / Checkbox or Select / Radio field option.

Result label

Field name displayed in the results grid and admin notification letters.

Code

Code is used to identify field in CSS (.webforms-fields-/code/) and custom PHP code.

Type

Set type of the field. See this page for complete list of available field types. It is possible to extend field types with custom types using Magento event system.

Field set

Assign field to required field set. If no field set selected field will be rendered in field set with empty label.

Field value(s)

Field values are used as default value in input field. Field types may have different format of values.

Use as e-mail subject

Add submitted field value to the e-mail subject. Useful when you use subject Select field in the form.

Position

Field position relative to other fields inside the field set. Less value puts field set higher.

Required

Make field required and validate input that its not empty.

Status

Toggle field display.

Design

Size

Set field size. Following preset options are available:

  • Standard. Two neighbour fields will be merged in one row.

  • Wide. Field will be wide and single in a row

Additional CSS classes

Assign additional CSS class to input element of the field. You can also use it for additional field validation (see Prototype validation classes).

Additional CSS style

Assign additional CSS style to input element of the field.

Results / Notifications

Display

Display field in notification letters and published results.

Validation

Minimum length

Set minimum field length validation.

Maximum length

Set maximum field length validation.

Validation RegEx

Set custom validation RegEx expression or value to validate. If validation fails Validation error message will be displayed.

Validation error message

Displayed text if validation of specified RegEx or value fails.

Fields management

To manage existing fields select Fields tab in the form edit page.

manage fields tab

Actions

Delete

Delete fields and loose the fraction of submitted data.

Change status

Change fields status to Enabled / Disabled.

Change field set

Assign field set to selected fields.

Duplicate

Duplicate fields. All duplicates will have Disabled status.