DotAdmin User Guide

Form Editor: Config Section

These are the basic options of the form, which affect how the overall form is displayed, and how it will be handled by the form processor.

The Config Section.

Config settings:

ID

The unique identifier of this particular form. The id can only contain lower-case letters, numbers, and the underscore character: “_”.

Template

An HTML template (from CMS > Templates > Form) is used to translate your form as displayed in the editor into a form for use on the website. A default template is provided, but you may have alternative templates for special kinds of form.

Notify

A comma separated list of usernames or email addresses of dotAdmin users to whom the form data should be emailed. Each user must be valid dotAdmin CMS user with privilege higher than “cleared”. If this field is not provided, or remains blank, then form submissions will not be emailed. This value would normally be provided as a hidden field:

Form Group

Stored data from more than one page or form can optionally be grouped together under "datagroups", The IDs for which are entered in this field (see Form Data Collection for more details). The value of this field must consist a comma separated list of group IDs; each group name must contain lowercase letters and numbers only, with no spaces or other characters. If the value in this field complies with this requirement, then the data from the form will be filed under each group ID in the "By Group" heading of the form data collection interface. This value would normally be provided as a hidden field:

Caption Col Size

A numeric value, this is the pixel width of the caption fields in the form.

Field Col Size

A numeric value, this is the default pixel width of the form fields themselves. Individual pixel widths (and in some cases heights) can also be set on individual form elements, which take precedence over this value.