webform_confirm_email.api.php in Webform Confirm Email Address 7

File

webform_confirm_email.api.php

<?php

/**
 * @file
 */

/**
 * React on an email that was confirmed when the user clicked
 * the confirmation link
 *
 * @param $node
 *   The node object of the webform for which an email was confirmed
 *
 * @param $submission
 *   The submission object of the webform submission where the user
 *   just confirmed his/her email address
 */
function hook_webform_confirm_email_email_confirmed($node, $submission) {
  db_query('INSERT INTO {my_confirmed_submission_list} ' . '  VALUES (:nid, :sid) ', array(
    ':nid' => $node->nid,
    ':sid' => $submission->sid,
  ));
}

/**
 * React on an email confirmation request that has expired according
 * to the maximum request lifetime that the admin had set
 *
 * @param $expired_submissions
 *   An associative array of submissions that have expired. It's indexed
 *   by nid's (node ID's), it's values are subarrays containing the sid's
 *   (webform submission ID's) that have expired for this nid
 */
function hook_webform_confirm_email_request_expired($expired_submissions) {
  $report = count($expired_submissions) . ' confirmation request have expired.';
  drupal_mail('example', 'notice', '[e-mail]', language_default(), array(
    'subject' => 'Report expired submissions',
    'body' => $report,
  ), '[e-mail]');
}

/**
 * Alter the redirect after a successful confirmation.
 *
 * @param $redirect
 *  An associative representing the redirect. Using the following keys.
 *   - 'path': The path argument for drupal_goto().
 *   - 'code': The code argument for drupal_goto().
 *   The other keys are identical with the options argument for drupal_goto().
 * @param $node
 *   The node object of the webform for which an email was confirmed.
 * @param $submission
 *   The submission object of hereby confirmed submission.
 */
function hook_webform_confirm_email_confirmation_redirect_alter(&$redirect, $node, $submission) {

  // Add a share=node/{nid} as query-parameter to the URL.
  $redirect['query']['share'] = "node/{$node->nid}";
}

Functions

Name	Description
hook_webform_confirm_email_confirmation_redirect_alter	Alter the redirect after a successful confirmation.
hook_webform_confirm_email_email_confirmed	React on an email that was confirmed when the user clicked the confirmation link
hook_webform_confirm_email_request_expired	React on an email confirmation request that has expired according to the maximum request lifetime that the admin had set