Forms

This module enables non technical users to create and edit forms. The forms can be inserted into any HTML field using the insert object button in the toolbar of the HTML editor.

Form definition

The forms are defined in the forms module:

 The first time you go to the module, there is only one button. "New webform":

When you add a new form, you're shown the following screen:

Form settings

There are a lot of settings for the forms you define. From behaviour to how it looks; almost everything can be customized. The settings are split into different categories (tabs):

• The "Web form" tab contains the basic settings and confirmation and notification settings.
  
  
• The Settings tab contains a lot of detailed information on how to render the html.
  
  
• The Templates tab contains the template code used to render the form. These templates can be overridden to get your desired look and functionality.
  
  
• The Definitions tab contains the field definitions of the form.

Fields

 There are a number of different field types you can create when you have defined a form. 

If you switch to the "Fields" tab:

Click on the "Add new form field" button to add a new field. You get a dialog where you have to choose the field type. The types available are:

If you select the "Text box" field type, you get the following:

When you create new fields, they are listed on the left:

Preview

When you open a form, you can click the preview icon on the blade to preview and test your form without publishing it on any pages. Note that the styling and look might be different than what you'll see in a real web page, due to the fact that different css rules may apply to the fields. The preview is very plain.

Inbox

The inbox displays the submissions of the current form. This is a copy of the content sent in an email to the notification email addresses. 

You can click on any of the submissions to read them:

Using forms

Forms can be used inside the html editor in Relatude, and the forms can be rendered inside content without any programming required:

1. First, click on the "Insert or edit object" button in the editor:
   
   
   
2. In the dialog that opens, select the "Form" button:
   
   
   
3. That opens a dialog that lists all the forms in the current site. Select the one you want to show:
   
   
   
4. The inserted forms is rendered as a placeholder. The placeholder makes it easy to move the form around in the text content:
   
   
   

For the visitor, the inserted form can look something like this:

Rendering forms programmatically

The most common way of using forms have traditionally been to insert the forms in the editor. But with the popularity of modular page architecture, many new sites are composing pages using modules. On those situations, it is common to create a "Forms module", with a node parent relation on the module where you can select a form. In the code that renders the module, you can do the following to render a form: 

WebForm form = module.Form.Get();
string formHtml = form.GetFormHtml(httpContext.Request.Params);