Webform Module

Last updated November 10, 2011. Created by LinL on December 3, 2007.
Edited by gpk, quicksketch, chrisshattuck, whitingx. Log in to edit this page.

Webform is a module that aids in making various one-off forms such as contact forms, surveys, order forms, reservations, CRM requests, and more.

To install the module, download the module and add it to your sites/all/modules directory. Enable it under /admin/build/modules.

You will now have a new node type called "Webform". From there you simply give the webform a title, description, confirmation message, set up email settings and the like.

Finally, you can add several components (think fields). There are several component types available: fieldset, pagebreaks, grid, textarea, textfield, select (checkboxes, pulldown lists), email addresses and more.

The checkboxes under the "E-mail" header should be checked for each field you want to be included in the email that is sent when the form is submitted. This checkbox does not have to do with validating that field as an email address; that is handled by choosing "email" in the "Type" column.

NOTE: In order to add components, you must first “save” the Webform. Then, under the “Edit” tab, you will see a “Form components” sub-tab; this is how you build your form. Remark: depending on your CSS files, some of these sub-tabs may be invisible, although your cursor would show the link when passing over them.

Screencasts

• View a screencast on how to use the Webform module.
• Another Screencast by Adam Jensen from UNT
• 4 video tutorials on 1) How to create a web form, 2) How the different components work, 3) How to create a single-checkbox input (i.e. for a newsletter) and 4) How to set up e-mail templates
• Un excelente (y largo) screencast en Español

Webform vs. CCK (or D7 Field module)

Webform is not meant to be a competitor or replacement for CCK. It is designed to be used where each Webform node gets its own set of custom fields. This is different from the CCK approach, where it creates content type forms that produce nodes. In fact, you can even combine CCK and Webform to add additional fields to webform nodes! Think of Webform as a solution when you want your end-users (often anonymous) to be able to submit data that you want emailed to a few email addresses or saved to a CSV file.

Webform typically is used when performing data collection that is a one-way communication, that is, many users submitting values to a very small set of administrators. Webform is not a front end for letting users create custom nodes. Webform submissions are not nodes. This means that you can't use Views with submissions, setup custom access permissions to submissions, or do just about anything with them outside of what Webform provides for you.

Webform Components

Webform components are basically the equivalent of CCK fields. You can add any number of fields to a node that an end-user can fill out. All components are included with the Webform module. These include:

• date
• email
• fieldset
• file
• grid
• hidden
• markup
• pagebreak
• select
• textarea
• textfield
• time

To read how to make checkboxes, radio buttons/groups, and menus/lists then read the Webform Field Types portion of this doc.

Theming

The THEMING.txt file included with the module package has guidelines for theming with instructions on how to customize submitted e-mails, confirmation pages, and the display of the form itself.