Club Drupal

This module adds a webform content type to your Drupal site.

A webform can be a questionnaire, contact or request form. These can be used

by visitor to make contact or to enable a more complex survey than polls

provide. Submissions from a webform are saved in a database table and

can optionally be mailed to e-mail addresses upon submission.

1. Copy the entire webform directory the Drupal sites/all/modules directory.

2. Login as an administrator. Enable the module in the "Administer" -> "Modules"

4. Create a webform node at node/add/webform.

Note that you must be running the latest 3.x version of Webform (for either

Drupal 6 or Drupal 7) before upgrading to Webform 4.x.

4. Run update.php (at http://www.example.com/update.php).

Please use the issue queue for filing bugs with this module at

http://drupal.org/project/issues/webform

Webform supports theming similar to the CCK or Views modules. Any webform may be

themed on the server side, though doing so may require a reasonable amount of

knowledge about the Drupal Form API. More information about the Form API may be

found at: http://api.drupal.org/api/file/developer/topics/forms_api.html

The default e-mails sent by webform are fairly basic. If you like, you may

customize the display of e-mails sent by each individual webform.

- To get a better idea of what variables are available to you, you can include

  the print_r function in your email. Simply include the line:

  <?php print_r($submission) ?>

  to get a listing of all the available fields you can use in your mail.

- Advanced Webform e-mail Theming: Theming the e-mail headers may also be done

  Just copy the code out of webform.module and change as necessary in your

  template.php file. This allows you to customize the e-mail headers.

After a user submits a webform, they are directed to a page that contains the

confirmation message set in the webform node settings (assuming the form doesn't

- Open the new file and change it's contents to the your liking. Here's an

  example that inserts some additional HTML around the confirmation message and

  gives links to edit the submission.

  <?php /* Begin sample webform confirmation page */ ?>

  <div class="confirmation-message">

    <?php print $confirmation_message ?>

  </div>

  <ul>

    <li><a href="<?php print url('node/' . $node->nid . '/submission/' . $sid)?>">View your submission</a></li>

    <li><a href="<?php print url('node/' . $node->nid . '/submission/' . $sid . '/edit')?>">Edit your submission</a></li>

  </ul>

  <?php /* End sample webform confirmation page */ ?>

- You may edit the webform-confirmation.tpl.php file in your theme directory,

  this will affect all the webform mails sent by your entire site. Or, if you

- Visit admin/settings/performance and click the "Clear cached data" button.

Theming a webform can be useful for rearranging elements or customizing the

appearance of multiple components at once. This tutorial assumes usage

  you have good reason to do so (like you're forwarding your webform to a custom

  PHP or PERL script).

Theming the display of a webform submission works the same way as theming a

webform form. Webform uses Drupal "renderable" style arrays for the display of

 * Element validation for Webform date fields.

 */

function webform_validate_date($element, $form_state) {

  // Determine if the user has specified a date. Hidden parts of the date will

  // be submitted automatically.

      $field_found = TRUE;

    }

  }

  if (isset($field_found)) {

    // Check that each part of the date has been filled in.

        $missing_fields = TRUE;

      }

    }

    }

    // Ensure date is made up of integers.

      $element[$date_part]['#value'] = (int) $element[$date_part]['#value'];

    }

    '#size' => 60,

    '#maxlength' => 127,

    '#weight' => 0,

    '#id' => 'email-value',

  );

  $form['user_email'] = array(

.webform-container-inline.webform-component-textarea .form-textarea-wrapper {

  display: inline-block;

}

.webform-component-textarea .grippie {

  display: block;

}

  );

  // Add each component to the form:

  $component_types = webform_components(TRUE);

  foreach ($component_types as $key => $component) {

    $form['components'][$key] = array(

    '#description' => t('When mapping emails addresses to a select component, limit the choice to components with less than the amount of options indicated. This is to avoid flooding the email settings form.'),

  );

  $form = system_settings_form($form);

  $form['#theme'] = 'webform_admin_settings';

  array_unshift($form['#submit'], 'webform_admin_settings_submit');

 * Field name validation for the webform unique key. Must be alphanumeric.

 */

function webform_component_edit_form_validate($form, &$form_state) {

  if (!preg_match('/^[a-z0-9_]+$/i', $form_state['values']['form_key'])) {

    form_set_error('form_key', t('The form key %form_key is invalid. Please include only lowercase alphanumeric characters and underscores.', array('%form_key' => $form_state['values']['form_key'])));

 * Insert a conditional rule group into the database.

 */

function webform_conditional_insert($conditional) {

  drupal_write_record('webform_conditional', $conditional);

  foreach ($conditional['rules'] as $rid => $rule) {

    $rule['nid'] = $conditional['nid'];

 * Update a conditional setting in the database.

 */

function webform_conditional_update($node, $conditional) {

  webform_conditional_delete($node, $conditional);

  webform_conditional_insert($conditional);

}

 * Delete a conditional rule group.

 */

function webform_conditional_delete($node, $conditional) {

  db_delete('webform_conditional')

    ->condition('nid', $node->nid)

    ->condition('rgid', $conditional['rgid'])

/**

 * Generate a Excel-readable CSV file containing all submissions for a Webform.

 *

 *

 * @return array|null

 *   The array of export info or null if the file could not be opened.

/**

 * Returns rows of downloadable webform data.

 *

 * @param $node

 *   The webform node on which to generate the analysis.

 * @param array $options

 *   An array of rows built according to the provided $serial_start and

 *   $pager_count variables. Note that the current page number is determined

 *   by the super-global $_GET['page'] variable.

 */

function webform_results_download_rows($node, array $options, $serial_start = 0, &$last_sid = NULL) {

  // Get all the required submissions for the download.

/**

 * Given a set of range options, retrieve a set of SIDs for a webform node.

 *

 */

function webform_download_sids($nid, $range_options, $uid = NULL) {

  return webform_download_sids_query($nid, $range_options, $uid)

 *   The existing submission SID.

 */

function webform_submission_update($node, $submission) {

  // Allow other modules to modify the submission before saving.

  foreach (module_implements('webform_submission_presave') as $module) {

    $function = $module . '_webform_submission_presave';

 *   The new submission SID.

 */

function webform_submission_insert($node, $submission) {

  // The submission ID may already be set if being called as an update.

  if (!isset($submission->sid) && (!isset($submission->is_new) || $submission->is_new == FALSE)) {

    // Allow other modules to modify the submission before saving.

 *   The webform submission object to be deleted from the database.

 */

function webform_submission_delete($node, $submission) {

  // Iterate through all components and let each do cleanup if necessary.

  foreach ($node->webform['components'] as $cid => $component) {

    if (isset($submission->data[$cid])) {

  // Determine the mode in which we're displaying this submission.

  $mode = ($format != 'form') ? 'display' : 'form';

    $mode = 'print';

  }

    $mode = 'pdf';

  }

}

/**

 */

function webform_submission_render($node, $submission, $email, $format, $excluded_components = NULL) {

  $component_tree = array();

    if ($uid === 0) {

      $submissions = isset($_SESSION['webform_submission']) ? $_SESSION['webform_submission'] : NULL;

      if ($submissions) {

      }

      else {

        // Intentionally never match anything if the anonymous user has no

      // Prevent the calendar button from submitting the form.

      $calendar.click(function (event) {

      });

    });

  };

   */

  Drupal.webform.conditionalCheck = function (e) {

    var $triggerElement = $(e.target).closest('.webform-component');

    var $form = $triggerElement.closest('form');

    var triggerElementKey = $triggerElement.attr('class').match(/webform-component--[^ ]+/)[0];

    var settings = e.data.settings;

          case 'require':

            var $requiredSpan = $target.find('.form-required, .form-optional').first();

            if (actionResult != $requiredSpan.hasClass('form-required')) {

              // Rather than hide the required tag, remove it so that other

              // jQuery can respond via Drupal behaviors.

              Drupal.detachBehaviors($requiredSpan);

<?php print ($email['html'] ? '<p>' : '') . t('Submitted by anonymous user: [submission:ip-address]') . ($email['html'] ? '</p>' : ''); ?>

<?php endif; ?>

[submission:values]

    $this->drupalLogin($this->webform_users['admin']);

    $this->webformReset();

    $this->webformSubmissionExecute('sample');

    $this->drupalLogout();

  }

  /**

      $actual_value = $actual_submission->data[$cid];

      $result = $this->assertEqual($stable_value, $actual_value, t('Component @form_key data integrity check when using @type values.', array('@form_key' => $component['form_key'], '@type' => $value_type)), t('Webform'));

      if (!$result || $result === 'fail') {

      }

    }

  }

   * {@inheritdoc}

   */

  public function setUp($added_modules = array()) {

    parent::setUp(array_merge($modules, $added_modules));

    // Create a profile field to test [user:?] tokens.

          'pid' => '0',

          'weight' => '-15',

        ),

        'database values' => array('bar'),

      ),

      'textfield_profile' => array(

        'component' => array(

        ),

        'sample values' => 'Female',

        'database values' => array('Female'),

      ),

      // Test time components.

    parent::options_submit($form, $form_state);

    _webform_views_options_submit($form, $form_state);

    $options =& $form_state['values']['options'];

                                        ? $node->webform['components'][$options['webform_cid']]['form_key']

                                        : NULL;

    // Drop PHP reference.

 * presented when the webform is displayed to that user. To allow multiple

 * drafts, implement this alter function to set the $sid to NULL, or use your

 * application's business logic to determine whether a new draft or which of

 *

 * @param int $sid

 *   The id of the most recent submission to be presented for editing. Change

files[] = tests/WebformPermissionsTestCase.test

files[] = tests/WebformSubmissionTestCase.test

files[] = tests/WebformTestCase.test

core = "7.x"

project = "webform"

    'indexes' => array(

      'nid' => array('nid'),

      'sid_nid' => array('sid', 'nid'),

    ),

  );

  variable_del('webform_default_format');

  variable_del('webform_format_override');

  variable_del('webform_email_select_max');

  variable_del('webform_node_types_primary');

  variable_del('webform_date_type');

  variable_del('webform_export_format');

  }

  // Begin a transaction for updating the serial numbers. The transaction will

  // Delete stray entries from the Webform tables before adding serial numbers.

  db_query("DELETE FROM {webform_submissions} WHERE nid NOT IN (SELECT nid FROM {webform})");

      ->execute();

  }

  // Commit the transaction.

  // Now that every submission has a serial number, make serial numbers required.

  $spec['not null'] = TRUE;

 * causes no problem, this update removes the schema module's warning.

 */

function webform_update_7418() {

  db_update('webform_emails')

    ->fields(array('extra' => ''))

    ->isNull('extra')

    ->execute();

  $spec = array(

    'description' => 'A serialized array of additional options for the e-mail configuration, including excluded components and value mapping for the TO and FROM addresses for select lists.',

    'type' => 'text',

}

/**

 */

function webform_update_7423() {

  // Create webform_condtional_actions table.

    db_create_table('webform_conditional_actions', $schema['webform_conditional_actions']);

  }

  $select = db_select('webform_conditional', 'c')

    ->fields('c', array('nid', 'rgid', 'action', 'target_type', 'target'))

    ->orderBy('nid')->orderBy('rgid');

    ->execute();

  // Commit the insert.

  // Remove unneeded columns from webform_conditional.

  foreach (array('action', 'target_type', 'target') as $fieldname) {

    }

  }

  registry_rebuild();

  return t('Webform database tables were successfully adjusted to allow more than one action for each conditional.');

}

/**

 */

function webform_update_7427() {

  // Create new timestamp columns.

    }

  }

  // Copy submitted to completed for non-draft submissions.

  db_update('webform_submissions')

    ->expression('completed', 'submitted')

    ->condition('is_draft', 0)

    ->execute();

  // Commit the update.

  // Start another transaction.

  db_update('webform_submissions')

    ->expression('modified', 'submitted')

    ->execute();

  // Commit the update.

  // Clear the views cache since to see the completed and modified views fields.

  cache_clear_all('*', 'cache_views', TRUE);

}

/**

 */

function webform_update_7429() {

  // Add highest_valid_page column to webform_submissions.

    $message = t('Submissions for this form are closed.');

  }

  elseif ($node->webform['confidential'] && user_is_logged_in()) {

  }

  // If open and not allowed to submit the form, give an explanation.

  elseif (array_search(TRUE, $allowed_roles) === FALSE && $user->uid != 1) {

  // Merge any stored submission data for multistep forms.

  $original_values = is_array($form_state['values']['submitted']) ? $form_state['values']['submitted'] : array();

  if (isset($form_state['storage']['submitted'])) {

    $original_values += $form_state['storage']['submitted'];

  }

    $variables['element']['#id'] = NULL;

  }

  switch ($element['#title_display']) {

    case 'inline':

      $output .= $description[$above];

    case 'before':

    case 'invisible':

    case 'after':

      break;

  }

  $output .= "\n";

  $output .= $description[!$above];

  $output .= "</div>\n";

  return $output;

}

/**

 *

 */

function _webform_filter_values($string, $node = NULL, $submission = NULL, $email = NULL, $strict = TRUE) {

  $output = webform_replace_tokens($string, $node, $submission, $email, $strict);

    }

  }

  $parsed_redirect_url['fragment'] = webform_replace_tokens($parsed_redirect_url['fragment'], $node, $submission);

  $parsed_redirect_url['#webform_external'] = url_is_external($parsed_redirect_url['path']);

  foreach (array(NULL, TRUE, FALSE) as $https) {

    if (stripos($parsed_redirect_url['path'], url('', array('absolute' => TRUE, 'https' => $https))) === 0) {

}

/**

 *

 */

function _webform_filter_descriptions($string, $node = NULL, $submission = NULL) {

  return webform_filter_descriptions($string, $node, $submission);

}

/**

 *

 */

function _webform_filter_xss($string) {

  return webform_filter_xss($string);

    case 'webform_disabled_components':

      $result = variable_get('webform_disabled_components', array());

      break;

  }

  return $result;

}

  }

  foreach ($address as $key => $individual_address) {

    $individual_address = webform_replace_tokens($individual_address, $node, $submission);

    $email_parts = webform_parse_email_address($individual_address);

    if ($format == 'long' && !empty($name[$key]) && !strlen($email_parts['name'])) {

  if ($submission) {

    $breadcrumb = menu_get_active_breadcrumb();

    $active_trail = menu_get_active_trail();

    $last_active = end($active_trail);

    $breadcrumb[] = $last_active['href'] === $node_path && !empty($last_active['in_active_trail'])

    // Date/Time formatting characters

    // WHAT           REQUIRED (at least 1) OPTIONAL (allowed but insufficient)

    // Day-of-week                          DlNw

    // Day            dj                    Stz

    // Month          FmMn

    // Year           oYy                   L

    //

    //                NOT ALLOWED

    // Time           aABgGhHisueIOPTZ

    // Special        /.,-: <space>

    //

  // a transaction. The return value of db_transaction() must be assigned or the

  // transaction will commit immediately. The transaction will commit when $txn

  // goes out-of-scope.

  // Get the next_serial value.

  $next_serial = db_select('webform', 'w')

    $form['#input_var_waring_parent'] = $parent_key;

  }

  if (!empty($form_state['input']) && array_key_exists($detect_key, $form_state['input']) && !array_key_exists('form_id', $form_state['input'])) {

    $subs = array(

      '@count' => webform_count_terminals($_POST),

      '@limit' => (int) ini_get('max_input_vars'),

  // Determine the limit on input vars for this server configuration.

  $limit = ini_get('max_input_vars');

  if ($limit) {

    $count = 1 + webform_count_input_vars($element);

    if ($count > $limit * 0.95) {

      $subs = array(