Webform 7.x-4.x and 7.x-3.x

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

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

Basic Usage

Go to the Administration Content page (URL: /admin/content) . To the far right of the toolbar is the "Web Form" button and the location of all the "Web Form" goodness (URL: /admin/content/webform)

Also under Content>Add content, will be a new node type called "Webform". From there, you can begin to create a new form, by clicking on "Webform."

First, you will be able to fill out the title and configure basic settings for your form.

After pressing "save" you will be able to add the fields (components) you would like to include on your webform.

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

Note:

  • The checkboxes under the "Email" header should be checked for each field you want to include 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.
  • 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

  • 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 setup custom access permissions to submissions or do just about anything with them outside of what Webform provides for you without using additional modules. For example in D7, using the Data module and the Webform MySQL Views module, you can use Views to display webform submissions (see d.o. post Display Webform submission data in Views and a screencast: Display Webform submission data in Views).

Additional webform component
Matrix/Table Component(Webform matrix component)

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.

Additional Resources

Resources for Webform 7.x-4.x and 7.x-3.x

Webform Code Snippets (for developers)

Webform 7.x-4.x and 7.x-3.x API and coding documentation for developers.

Webform FAQ and Common Problems

This page lists (very) common problems users encounter with Webform. If the question you have is not answered here, please submit an issue

Webform Related Projects

There are many modules which extend Webform, including integration with third-party software.

Webform Theming (for themers)

Documentation for theming Webform 7.x-4.x and 7.x-3.x.

Webform Tutorials (for site builders)

Subscription Based Tutorials for sale to site builders using Webform 7.x-4.x and .7x-3.x

Guide maintainers

LinL's picture