Form Paragraphs

The standard installation of Magnolia includes two templates that allow you to create web forms. These are the Contact Form and the Public Users Management templates.

Contact Form Template

The Contact Form template can be used to create any type of form and is not limited to contact forms per se. The form and its behavior is configured in the Form Settings paragraph and the individual fields are grouped together within Field Set paragraphs. Each Field Set paragraph can contain any number of individual fields.

Demo-project - Service - Contact page

When you create a new page based on the Contact Form template, the Form Settings paragraph is created automatically, the Edit Form Settings button displays at the top of the main area and the New Field Set button directly below it.

Demo-project - Members Area - New Contact Form page (created)

The Field Set paragraph allows you to provide a title for a set of individual field paragraphs and a number of Field Set paragraphs may be included in any form.

Demo-project - Members Area - New Contact Form page (created)

Once a Field Set paragraph has been created, individual field paragraphs are inserted by clicking on the New Field button.

When you click on the New Field button, the Create new paragraph dialog opens, where you can select the paragraph type to be inserted. The individual field paragraphs available on the Contact Form template are the Text Field, Password Field, Hidden Field, Text Field Group, Selection, File and Submit Button paragraphs.


Public Users Management Template

Whereas the Contact Form template is limited to only a single form per page, the Public Users Management template allows you to include multiple forms, each with their own settings and behaviors, on a single page, if appropriate, or on individual pages. In addition to the available form paragraphs, there is an introductory header paragraph and it is possible to insert Text and Image, Link List and Members Area paragraphs in the main area.

When you create a new page based on the Public Users Management template, the Article Header paragraph is created automatically and the New Content button displays below the Article Header paragraph.

Demo-project - Members Area - New Public Users Management page (created)

When you click on the New Content button, the Create new paragraph dialog opens, where you can select the individual form paragraphs, among others.

The individual form paragraphs available on the Public Users Management template are:

  • Login Form paragraph;

  • User Registration Form paragraph;

  • Users Profile Update Form paragraph;

  • Password Retrieval Form paragraph;

  • Logout Form paragraph.

In addition to these paragraphs, Text and Image, Link List and Members Area paragraphs are also available.

When selected each form paragraphs creates an individual form, which includes a Form Settings, one or more Field Set and individual Field paragraphs.

If you select any of the form paragraphs, for example the Login Form paragraph, the Form dialog, in which the Form Settings are established, opens,

When you save the contents of the Form dialog, the Form Settings paragraph is created and the New Field Set button appears directly below it.

Demo-project - Members Area - New Public Users Management page (created)

From this point on, the procedure and sequence for creating forms on the Contact Form template and the Public Users Management template is the same, in that each form consists of a Form Settings, Field Set/s and individual field paragraphs.

The individual field paragraphs available on the Public Users Management template in the Create new paragraph dialog, accessed by clicking on the New Field button in the Field Set paragraph, vary. All offer a Text, Password and Submit Button Field, but the behavior of the Submit Button is unique to each paragraph and adapts to suit the type of form. The Logout Form paragraph additionally offers a Hidden Field paragraph.

The screenshot below shows the available individual field in the Create new paragraph dialog of the Logout Form paragraph.

Public Users Management Form Paragraphs

The form paragraphs available on the Public Users Management Template allow you to create all the forms necessary to establish and manage user registration on your website.

Login Form Paragraph

The Login Form paragraph allows you to create a login form.

Demo-project - Members Area - Login page - Public instance

The Text Field and Password Field paragraphs display on the page irrespective of the user's login status, but the Submit button only displays when a user is logged out.

Demo-project - Members Area - Login page - Author instance - edit mode

When you click on the Edit Form Settings button, the Form dialog, where you configure the form settings and behavior opens. This paragraph is common to all forms and is collectively discussed in Form Settings Paragraphs.

The Field Set paragraph is the main paragraph in which individual field paragraphs are grouped. This paragraph is common to all forms and is collectively discussed in Field Set Paragraphs.

Within each Field Set paragraph, three individual paragraphs are available in the Create new paragraph dialog. These paragraphs are the Text field, Password field and Submit button for Login, Profile registration or Password retrieval fields, and their use is discussed in Field Paragraphs - Text Field, Password Field and Submit Button Paragraphs.

User Registration Form Paragraph

The User Registration Form paragraph allows you to create a user registration form.

Demo-project - Members Area - Registration page - Public instance

The Text Field and Password Field paragraphs display on the page irrespective of the user's login status, but the Submit button only displays if the user is logged out.

Demo-project - Members Area - Registration page - Author instance - edit mode

When you click on the Edit Form Settings button, the Form dialog, where you configure the form settings and behavior opens. This paragraph is common to all forms and is collectively discussed in Form Settings Paragraphs.

The Field Set paragraph is the main paragraph in which individual field paragraphs are grouped. This paragraph is common to all forms and is collectively discussed in Field Set Paragraphs.

Within each Field Set paragraph, three individual paragraphs are available in the Create new paragraph dialog. These are the Text field, Password field and Submit button for Login, Profile registration or Password retrieval field, and their use is discussed in Field Paragraphs - Text Field, Password Field and Submit Button Paragraphs.

Users Profile Update Form Paragraph

The Users Profile Update Form paragraph allows you to create a user profile update form.

Demo-project - Members Area - User Profile Update page - Public instance

The Text Field and Password Field paragraphs display on the page irrespective of the user's login status, but the Submit button only displays if the user is logged in.

Demo-project - Members Area - User Profile Update page - Author instance - edit mode

When you click on the Edit Form Settings button, the Form dialog, where you configure the form settings and behavior opens. This paragraph is common to all forms and is collectively discussed in Form Settings Paragraphs.

The Field Set paragraph is the main paragraph in which individual field paragraphs are grouped. This paragraph is common to all forms and is collectively discussed in Field Set Paragraphs.

Within each Field Set paragraph, three individual paragraphs are available in the Create new paragraph dialog. These are the Text field, Password field and Submit button for Profile update and Logout field, and their use is discussed in Field Paragraphs - Text Field, Password Field and Submit Button Paragraphs.

Password Retrieval Form Paragraph

The Password Retrieval Form paragraph allows you to create a password retrieval form.

Demo-project - Members Area - Password Reminder page - Public instance

The Text Field paragraph display on the page irrespective of the user's login status, but the Submit button only displays if the user is logged out.

Demo-project - Members Area - Password Reminder page - Author instance - edit mode

When you click on the Edit Form Settings button, the Form dialog, where you configure the form settings and behavior opens. This paragraph is common to all forms and is collectively discussed in Form Settings Paragraphs.

The Field Set paragraph is the main paragraph in which individual field paragraphs are grouped. This paragraph is common to all forms and is collectively discussed in Field Set Paragraphs.

Within each Field Set paragraph, three individual paragraphs are available in the Create new paragraph dialog. These are the Text field, Password field and Submit button for Login, Profile registration or Password retrieval field, and their use is discussed in Field Paragraphs - Text Field, Password Field and Submit Button Paragraphs.

Logout Form Paragraph

The Logout Form paragraph allows you to create a logout form.

Demo-project - Members Area - Logout page (created) - Author instance - edit mode

The Text Field and Password Field paragraphs, if any, display on the page irrespective of the user's login status, but the Submit button only displays if the user is logged in. This type of page would normally only be accessible to logged in user's and the screenshot below is included to demonstrate the behavior of the Submit Button paragraph.

Demo-project - Members Area - Logout page (created) - Public instance

When you click on the Edit Form Settings button, the Form dialog, where you configure the form settings and behavior opens. This paragraph is common to all forms and is collectively discussed in Form Settings Paragraphs.

The Field Set paragraph is the main paragraph in which individual field paragraphs are grouped. This paragraph is common to all forms and is collectively discussed in Field Set Paragraphs.

Within each Field Set paragraph, four individual paragraphs are available in the Create new paragraph dialog: Text field, Password field, Hidden field and Submit button for Profile update and Logout field, and their use is discussed in Field Paragraphs - Text Field, Password Field, Hidden Field and Submit Button Paragraphs.

Form Settings Paragraphs

All forms have a Form Setting Paragraph, which allows you to set the behavior of the form.

The tab areas available in the Form Settings dialog vary from form to form, and depend on the purpose and outputs for which the template or form paragraph was designed. The Form Settings paragraph dialog of the:

  • Contact Form Template has Form, Submit Settings, Email and Confirmation Email tab areas.

  • User Registration Form and Password Retrieval Paragraphs have Form, Submit Settings and Confirmation Email tab areas.

  • Login Form, User Profile Update and Logout Form Paragraphs have Form and Submit Settings tab areas.

The Email and/or Confirmation Email tab areas are unnecessary in the Login Form, Profile Update and Logout paragraphs and are therefore omitted.

To define the form settings on any form, either click on the Edit Form Settings button on the Contact Form template or select any of the form paragraphs in the Create new paragraph dialog on the Public Users Management template. In either case, the Form dialog relevant to the template or paragraph you are working on will open.

In our examples, we will use the Form dialog which is accessed by clicking of the Edit Form Settings button on the Contact Form template as this dialog contains all possible tab areas. The available fields and their use in each tab area are identical, irrespective of the Form Settings paragraph that you are working on.

Form Tab Area

The Form tab area is included in all Form Settings dialogs and allows you to include a title and introductory text for your form, and to set the required field marker and text.

Title Field

The Title field allows you to include a form title.

To include a title, insert it into the Title field.

In the editing window, the title displays at the top of the paragraph.

Demo-project - New Contact Form page (created)

Form Name Field

The Form Name field allows you to reference the form using JavaScript.

To include a form name, insert it into the Form Name field.

Text Field

The Text field allows you to include introductory text for you form.

To include an introduction, insert it into the Text field.

In the editing window, the contents of the Text field displays below the title.

Demo-project - New Contact Form page (created)

Marker for Required Fields Field

The Marker for Required Fields field allows you to determine the symbol that will indicate required fields in your form. This symbol displays next to the title of each required field in the Field Set paragraph of the form. It is customary to use an asterisk (*), but any character may be used.

To include the marker, insert it into the Marker for Required Fields field.

In the editing window, the symbol displays next to each required field.

Demo-project - New Contact Form page (created)

In the Form dialog of the Field Set paragraph there is an option to display the marker in the Form Settings paragraph. If this option is selected, the marker and marker text displays in the Form Settings paragraph. This option is discussed in Field Set Paragraphs - Display Marker for Required Fields Field.

Text for Required Symbol Field

The Text for Required Symbol field allows you to include explanatory text next to the symbol indicating a required field. This text only displays in the Form Settings paragraph if the option to display the marker is selected in the Field Set paragraph/s of the form.

To include text in addition to a symbol, insert it into the Text for Required Symbol field.

In the editing window, the text displays next to the symbol in the Field Settings paragraph.

Demo-project - New Contact Form page (created)

Submit Settings Tab Area

The Submit Settings tab area is included in all Form Settings dialogs and allows you to determine the information that displays on the web page after the form is submitted.

Error Title Field

The Error Title field allows you to include the text displayed if the form is not submitted correctly, for example if a required field is omitted.

To include the error text, insert it into the Error Title field.

In the editing window, if there is a submission error, the error text and reason will display at the top of the form.

Demo-project - New Contact Form page (created)

Success Title Field

The Success Title field allows you to include the text that displays when the form is submitted successfully.

To include the successful submission text, insert it into the Success Title field.

In the editing window, the success title text displays on the top of the page when the form is submitted successfully.

Text Field

The Text field allows you to include additional text below the Success Title text.

To include additional text, insert it into the Text field.

In the editing window, this text displays below the success title text when the form is submitted successfully.

Page Displayed After Submission Field

The Page displayed after submission field allows you to direct the visitor to another page of your site after the successful submission of the form. If you leave this field blank, the current page remains open.

To direct to a different page, insert the file path of the page into the Page displayed after submission field.

How to use the Internal Link function to link to an internal page is discussed in Linking Internally - Linking to Internal Pages.

In the editing window, the selected page will display when the form is submitted successfully.

Track Mail Field

The Track mail field allows you to create a record of the emails in a csv file. If enabled, a csv file will be written to the Magnolia log folder.

To enable the Track mail option, select the Enable log file based mail tracking option by clicking within the small square and a green tick will indicate your selection.

Email Tab Area

The Email tab area is included in Contact Form - Form Settings dialog and allows you to configure the email settings for the email containing the form information. This email will be sent to an email address within your organization to collect form data.

From Field

The From field allows you to record the email address of the person who submitted the form. You can use a form field, i.e. a field name included in any of the individual field paragraphs in the Field Set paragraph/s to generate the information automatically, and FreeMarker tags must be used.

For example, if you have set up a field for the user's email address named "email", your would insert ${email} and if you named the field "user", you would insert ${user} into the From field. How to create the individual field paragraphs fields within a Field Set paragraph is discussed in Field Paragraphs.

To include the user's email address, insert the relevant information into the From field.

To Field

The To field allows you to set the email address that the form information is sent to. This will normally be an email address within your organization.

To include the email address to which the form information is sent, insert it into the To Field.

Subject Field

The Subject field allows you to include a subject line for the email. If appropriate, you can use a form field i.e. a field name included in any of the individual field paragraphs in the Field Set paragraph/s. If you use a form field, FreeMarker tags should be used. Alternatively, you can simply enter suitable text that allows you to identify the form.

To include a subject, insert it into the Subject field.

Type Field

The Type field allows you to choose the type of email sent. There are two options, HTML and plain text.

To access the options, click on the small down-arrow on the right of the field and the list will appear. Make your selection by clicking on the relevant option and it will be inserted into the field.

Text Field

The Text field allows you to include the body content of the email. You can include form fields i.e. field names included in any of the individual field paragraphs in the Field Set paragraph/s, with FreeMarker tags to automatically generate the information.

To include the content of the email, insert it into the Text field.

Confirmation E-mail Tab Area

The Confirmation Email tab area is included in the Contact Form, User Registration Form and Password Retrieval Form Settings dialogs and allows you to configure the confirmatory email, if any, to be sent to the user on successful submission of the form.

Send Confirmation Field

The Send Confirmation field allows you to elect to send an email to the user.

To send a confirmation email, select the Send a confirmation email option by clicking within the small square and a green tick will indicate your selection.

From Field

The From field allows you to include the email address that will appear in the From field of the email.

To include this email address, insert it into the From field.

To Field

The To field allows you to include the user's email address. You can include form fields i.e. field names included in any individual Field paragraphs in the Field Set paragraph/s, with FreeMarker tags to automatically generate the information

To include user's email address, insert it into the To field.

Subject Field

The Subject field allows you to include a subject line in the email. You can include form fields i.e. field names included in any of the individual Field paragraphs in the Field Set paragraph, with FreeMarker tags to automatically generate the information

To include a subject line, insert it into the Subject field.

Type Field

The Type field allows you to choose the type of email sent. There are two options, HTML and plain text.

To access the options, click on the small down-arrow on the right of the field and the list will appear. Make your selection by clicking on the relevant option and it will be inserted into the field.

Text Field

The Text field allows you to include the body content of the email. You can include form fields i.e. field names included in any of the individual Field paragraphs in the Field Set paragraph/s, with FreeMarker tags to automatically generate the information.

To include the content of the email, insert it into the Text field.

Field Set Paragraphs

All forms contain a Field Set paragraph, which creates a main paragraph into which a group of individual field paragraphs fall. More than one field set can be created on any of the forms.

When you create a new page based on the Contact Form template, the New Field Set button appears below the Edit Form Settings button.

Demo-project - New Contact Form page (created)

When you create any of the Form paragraphs available on the Public Users Management template, the New Field Set button appears directly below the Form Settings paragraph once it has been created.

Demo-project - Contact Form page (created)

To create a field set, click on the New Field Set button and the Form dialog will open.

The Form dialog has a single tab area: Field Set.

Demo-project - Contact Form page (created) - Form dialog

Field Set Tab Area

Title Field

The Title field allows you to include a title for the field set to distinguish it from other sets on the page.

To include a title, insert it into the Title field.

In the editing window, the title displays at the top of the Field Set paragraph.

Demo-project - Contact Form page (created)

Display Marker for Required Fields Field

The Display Marker for Required Fields field allows you to display the marker and text inserted in the Marker for Required Fields and Text for Required Symbol fields of the Form Settings paragraph.

To display the marker, click within the small square and a green tick will indicate your selection.

When you select this option the marker and text display in the Form Settings paragraph and not in the Field Set paragraph.

Demo-project - Contact Form page (created)

When you save the Field Set paragraph, the New Field button appears below the field set title.

Demo-project - Contact Form page (created)

To insert the individual fields of the field set, click on the New Field button and the Create New paragraph dialog will open.

The content of the Create new paragraph dialog depends on the form that you are creating. In total, across the different forms, the available paragraphs are the Text Field, Text Field Group, Selection, File and various types of Submit Button paragraphs.

To include the individual form field paragraphs, select the paragraph type by either clicking within the small circle next to each option or on the text link that appears when you mouse over the paragraph name.

When you select a paragraph type, the Create new paragraph dialog closes and the dialog of the selected paragraph opens. The paragraph content is inserted in this second dialog and each paragraph type is discussed in individual sections below.

When the first field paragraph has been inserted, a New Field button will appear below this first paragraph, allowing you to insert a subsequent field paragraph. You may insert as many field paragraphs as you like.

Demo-project - Contact Form page (created)

Field Paragraphs

Text Field Paragraph

The Text Field paragraph displays a single input field. The size of the field varies from a single line to a large text area.

Demo-project - Services - Contact page

The Text Field paragraph is available within the Field Set paragraph on the Contact Form template and in all the form paragraphs on the Public Users Management template.

When you select the Text Field paragraph in the Create new paragraph dialog, the Edit dialog opens.

The Edit dialog has a single tab area: Input field.

Input Field Tab Area

The Input Field tab area allows you to set the properties for the field.

Field Label Field

The Field Label field allows you to give the field a label or title. In the editing window, this text appears above the field. The field label should not be confused with the field name, which is used in the Form Settings paragraph to reference the field.

To include the field label, insert it into the Field Label field.

In the editing window, the field label appears above the field.

Demo-project - Services - New Contact Form page (created)

Field Name Field

The Field Name field is used in the Form Settings paragraph to reference the field. When including information in any field that allows for the use of FreeMarker tabs, the field name should be included as follows: ${field name}. This allows for the automatic generation of information in form emails and data.

To include the field name, insert it into the Field Name field.

Description Field

The Description field allows you to elaborate about the field by adding a description or comment.

To include a description, insert it into the Description field.

In the editing window, the description displays below the field.

Demo-project - Services - New Contact Form page (created)

Mandatory Field

The Mandatory field allows you to determine whether the field is mandatory or not.

To make the field mandatory, select the Field is mandatory option by clicking within the small square and a green tick will indicate your selection.

In the editing window, mandatory fields are indicated by the symbol inserted in the Marker for Required Fields field of Field Settings paragraph.

Demo-project - Services - New Contact Form page (created)

Validation Field

The Validation field allows you to verify that that the information inserted into the field is valid. For example, if the field requires an email address or only numbers, input that does not include the @ sign or contains letters is unacceptable. Passwords and usernames are also verifiable using this field. If a user inserts invalid information, they will receive an error message advising them that their input is invalid.

There are five validation options: none, email, number, password and username.

To access the options, click on the small down-arrow on the right of the field and the list will appear. Make you selection by clicking on the relevant option and it will be inserted into the field.

In the editing window, if a user inserts invalid information, the error text inserted in the Error Title field of the Form Settings paragraph and the specifics of the error will appear at the top of the page.

Demo-project - Services - New Contact Form page (created)

Lines Field

The Lines field allows you to determine the size of the input field.

There are three options: single line, small area and large area.

To select an option, click with the small circle next to the appropriate option and the radio button will indicate your selection.

The selection made in the Lines field reflects in the editing window.

Demo-project - Services - New Contact Form page (created)

Password Field Paragraph

The Password Field paragraph is identical to the Text Field paragraph, except that the input entered into the field is not visible on the page and in hidden by a series of black dots.

The Password Field paragraph displays a single input field, the size of which can vary from a single line to a large text area.

Demo-project - Members Area - Users Profile Update page

The Password Field paragraph is available within the Field Set paragraph on the Contact Form template and in all the form paragraphs on the Public Users Management template.

When you select the Password Field paragraph in the Create new paragraph dialog, the Edit dialog opens.

The Edit dialog of the Password Field paragraph is identical to that of the Text Field paragraph and is discussed in Text Field Paragraph - Input Field Tab Area.

Hidden Field Paragraph

Hidden fields do not display on the web page and no field as such is provided for a user to enter information. They are used to pass on values to the forms processor in the same way as any other data entered by a user.

The Hidden Field paragraph is available within the Field Set paragraph on the Contact Form template and in the Logout Form paragraph on the Public Users Management template.

When you select the Hidden Field paragraph in the Create new paragraph dialog, the Hidden dialog opens.

The Hidden dialog has a single tab area: Input field.

Input Field Tab Area

Field Name Field

The Field Name field is a mandatory field and is used to reference the hidden field.

To include a field name, insert it into the Field Name field.

Value field

The Value field allows you to include the value for the field.

To include the field value, insert it into the Value Field.

In the editing window, the paragraph is created but no content is displayed.

Demo-project - New Contact Form page (created)

Text Field Group Paragraph

The Text Field Group paragraph displays multiple single-line fields within the same paragraph.

The Text Field Group paragraph is available within the Field Set paragraph on the Contact Form template.

When you select the Text Field Group paragraph in the Create new paragraph dialog, the Form Group dialog opens.

The Form Group dialog has a single tab area: Text fields group.

Text Fields Group Tab Area

Group Name Field

The Group Name field is used in the Form Settings paragraph to reference the field group and does not display in the paragraph. When including information in any field that allows for the use of FreeMarker tabs, the field name should be included as follows: ${group name}. This allows for the automatic generation of information in form emails and data.

To include the group name, insert it into the Group Name field.

When you save the contents of the Form Group dialog, the Text Field Group paragraph is created in the editing window and a New button appears below the edit bar.

Demo-project - Services - New Contact Form page (created)

Adding Fields

To add the first form field, click on the New button in the editing window and the Edit dialog will open.

The Edit dialog has a single tab area: Input field.

Input Field Tab Area

The Field Label, Field Name Mandatory and Validation fields of the Text Field Group paragraph are identical to those of the Text Field paragraph and are discussed in Text Field Paragraph - Input Field Tab Area.

To create the first field, include appropriate content in these fields.

Length Field

The Length field allows you to determine the length of the field. There are three options: small, medium and long.

To access the options, click on the small down-arrow on the right of the field and the list will appear. Make you selection by clicking on the relevant option and it will be inserted into the field.

In the editing window, the first field displays at the top of the paragraph and the New button appears below it. .

Demo-project - Services - New Contact Form page (created) - edit mode

Due to space limitations in edit mode, the layout of the Text Field Group paragraph is best viewed in preview mode.

Demo-project - Services - New Contact Form page (created) - preview mode

To add further fields to the group, click on the New button and repeat the procedure described above.

The layout of the paragraph is rendered automatically to best suit the available space. Smaller fields appear together in the same line, where possible.

Demo-project - Services - New Contact Form page (created) - edit mode

Demo-project - Services - New Contact Form page (created) - preview mode

Selection Paragraph

The Selection paragraph displays fields containing radio buttons, checkboxes or select boxes. Whereas radio buttons allow for a selection of a single option, checkboxes allow for the selection of multiple options.

The Selection paragraph is available within the Field Set paragraph on the Contact Form template.

When you select the Selection paragraph in the Create new paragraph dialog, the Selection dialog opens.

The Section dialog has a single tab area: Selection.

Selection Tab Area

The Selection tab area allows you to set the properties for the field.

Label Field

The Label field allows you to give the field a label or title. The field label should not be confused with the field name, which is used in the Form Settings paragraph to reference the field.

To include the label, insert it into the Label field.

In the editing window, the label displays above the field.

Demo-project - Services - New Contact Form page (created)

Field Name Field

The Field Name field is used in the Form Settings paragraph to reference the field. When including information in any field that allows for the use of FreeMarker tabs, the field name should be included as follows: ${field name}. This allows for the automatic generation of information in form emails and data.

To include the field name, insert it into the Field Name field.

Legend Field

The Legend field allows you to insert hidden text that enables the field to be identified. This text does not display in the paragraph.

In the Legend field, insert text that will allow you to identify the field.

Control Type Field

The Control Type field allows you to select the control type.

There are three options: select box, radio buttons and checkboxes.

To make your selection, click within the small circle next to the relevant option and the radio button will indicate your selection.

The selected control type reflects in the editing window.

Demo-project - Services - New Contact Form page (created)

Orientation Field

The Orientation field is only applicable to radio buttons and checkboxes. The field allows you to display the options either vertically or horizontally. By default, the radio buttons and checkboxes display vertically.

To display the radio buttons and checkboxes horizontally, select the Horizontal option by clicking within the small square and a green tick will indicate your selection.

In the editing window, the radio buttons and checkboxes will display horizontally.

Demo-project - Services - New Contact Form page (created)

Multiple Field

The Multiple field is only applicable to select boxes. This field allows you to make more than one option available for selection in the select box.

To select this option, click within the small square and a green tick will indicate your selection.

In the editing window, the select box no longer has a drop-down arrow and all the options display in an enlarged box. Multiple options can be selected by using the Ctrl key.

Demo-project - Services - New Contact Form page (created)

Labels and Values Field

The Labels and Values field allows you to assign the options or values that will be available in the selection. You can include as many values as you like.

To assign the values, insert each one on a separate line in the Labels and Values field.

In the editing window, the values display as the options available in the selection.

Demo-project - Services - New Contact Form page (created)

Default Value Field

The Default Values field allows you to assign a default value to the field. This is the value that will be visible in the select box and will be automatically selected in the radio button and checkbox options.

To include a default value, insert it into the Default value field.

In the editing window, the default value displays in the visible section of the select box and is automatically selected in the checkbox and radio button options.

Demo-project - Services - New Contact Form page (created)

File Paragraph

The File paragraph displays an upload function that allows users to upload a file.

The File paragraph is available within the Field Set paragraph on the Contact Form template.

When you select the File paragraph in the Create new paragraph dialog, the Label dialog opens.

The Label dialog has a single tab area: File field.

File Field Tab Area

Label Field

The Label field allows you to give the field a label or title. The field label should not be confused with the field name, which is used in the Form Settings paragraph to reference the field.

To include the label, insert it into the Label field.

In the editing window, the label displays above the upload function and users can click on the Browse button to locate a file to upload.

Demo-project - Services - New Contact Form page (created)

Field Name Field

The Field Name field is used in the Form Settings paragraph to reference the field. When including information in any field that allows for the use of FreeMarker tabs, the field name should be included as follows: ${field name}. This allows for the automatic generation of information in form emails and data.

To include the field name, insert it into the Field Name field.

Submit Button Paragraphs

The Submit Button paragraph displays a button that allows users to submit a form.

Demo-project - Service - Contact page

Submit Button paragraphs are included as an option in all forms, but their behavior differs from form to form. The available Submit Button paragraphs and the templates/paragraphs in which they are available are:

  • Submit button paragraph on the Contact Form template;

  • Submit button for Login, Profile registration or Password retrieval paragraph in the Login, Profile Registration and Password Retrieval Form paragraphs;

  • Submit button for Profile update or Logout paragraph in the Profile Update and Logout Form paragraphs.

The submission process happens automatically and it is only necessary to include a Submit Button paragraph to facilitate it. The process that will take place after the submit button is clicked is determined in the Submit Settings and/or Email and Confirmation tab area of the various Form Settings paragraphs.

On the Contact Form template, the submit button is always displayed, but in the form paragraphs available on the Public Users Management template, whether the submit button displays in the paragraph or not, depends of the user's login status. This behavior is rendered automatically by the paragraph. In addition, if appropriate, explanatory text automatically displays advising the user of their login status and its consequences, if any.

In the Login Form, Users Profile Update Form and Password Retrieval Form paragraphs, the button displays only when the user is not logged in.

Demo-project - Members Area - Login page - Public instance

Demo-project - Members Area - Login page - Public instance

In the User Registration Form and Logout Form paragraphs, the button is displayed only when the user is logged in.

Demo-project - Members Area - User Profile Update page (modified) - Public instance

Demo-project - Members Area - User Profile Update page (modified) - Public instance


The manner, and dialogs, in which the various Submit Button paragraphs are created on the various forms is identical.

When you select any of the Submit Button paragraph in the Create new paragraph dialog, the Form Submit dialog opens.

The Submit dialog has a single tab area: Submit.

Submit Tab Area

Label Field

The Label field allows you to name the submit button. The text included in this field appears within the button.

To include the button name, insert it into the Label field.

In the editing window, the label displays in the button.

Demo-project - Services - New Contact Form page (created)

Your label can span the entire main area of the page and the button will resize to accommodate the content.

Demo-project - Services - New Contact Form page (created)