Webform

A webform allows you to collect submitted data from users, then access and download that data later. They are built slightly differently in Next-Gen UNLcms, with the form part of the page constructed as a different component that is then "attached" to a Webform page. 

This change allows you to use the same collection fields on different pages, while also keeping that collected data separate. For instance, if you always collect the same registration information for events, you'd only need to build one webform component, then attach it to multiple webform pages.

Add Webform Fields

1. Go to Structure> Webforms> Form> +Add webform
2. Click “+Add element” to add your fields and apply field settings
3. Click the “Settings” tab if you’d like to setup which emails submissions are sent to ("Emails / Handlers"), change the default messages that display, or change settings like whether or not the progress bar displays. There are a lot of setting options, most are fine just using the default.

Adding Webform Fields To a Page

There are two options for adding webforms to a site. The first is to attach it to a basic webform page (which will display the fields centered down the middle of the page no matter what device someone is on), which allows the addition of a text block with basic formatting above the embedded webform. To do this: 

1. Create a Webform page by going to Content> Add Content> Webform
2. Title your new Webform page and optionally add any specific copy above what will be the embedded webform within the "body" field.
3. On the "Webform" field, select the Webform Fields that you created above. 
4. By default a newly created Webform page will be Open for submissions, but submission status can be modified by clicking on the "Webform Settings" dropdown.
5. Click the Save button to finalize Webform creation.

The second option is to add it to a section within a Builder Page. This will allow you to add additional layout components (like a Display Banner) above the webform or as part of a multi-column layout. To do this:

1. Create a layout builder page to put the form on.
2. Content> Add Content> Builder Page
3. Select “Layout”
4. Click “+Add section”
5. Click “One column (DCF)” then “Add section”
6. Click “+Add component” then click “More…” to open up the options on the right.
7. Click “Webform”, uncheck “Display title, search for the name of the webform you created and click “Add block”

Accessing Webform Submissions

To access webform submissions, go to the webform page you created (can be found by clicking "Content") and then click the "Results" tab once you have opened that Webform. From there, you have the option to view the results in your browser window, download those results in various formats, or clear the data (do NOT clear the data unless you have already downloaded it first, as there is no way to retrieve it once it has been deleted).