You are here

user_import.inc in User Import 6.2

File

supported/user_import.inc
View source
<?php

/**
 * Implementation of hook_user_import_form_fieldsets().
 * Add fieldsets to an import settings form. 
 */
function user_import_user_import_form_fieldset($import, $collapsed) {
  $form = array();
  _user_import_edit_template_fields($form, $import);
  _user_import_edit_settings_fields($form, $import, $collapsed);
  _user_import_edit_remove_fields($form, $import);
  return $form;
}

/**
 * Implementation of hook_user_import_after_save().
 */
function user_import_user_import_after_save($settings, $account, $password, $fields, $updated, $update_setting_per_module) {
  if (!empty($settings['send_email']) && !$updated) {
    $subscribed = isset($settings['subscribed']) ? $settings['subscribed'] : NULL;
    _user_import_send_email($account, $password, $fields, $settings['subject'], $settings['message'], $settings['message_format'], $settings['message_css'], $subscribed);
  }
}

// Send email when account is created
function _user_import_send_email($account, $password, $profile, $subject, $body, $format, $css, $subscribed) {
  global $base_url;

  // All system mails need to specify the module and template key (mirrored from
  // hook_mail()) that the message they want to send comes from.
  $module = 'user_import';
  $key = 'welcome';

  // Specify 'to' and 'from' addresses.
  $to = $account->mail;
  $from = variable_get('site_mail', NULL);
  $params = array(
    '!username' => $account->name,
    '!uid' => $account->uid,
    '!site' => variable_get('site_name', 'drupal'),
    '!login_url' => user_pass_reset_url($account),
    '!password' => $password,
    '!uri' => $base_url,
    '!uri_brief' => drupal_substr($base_url, drupal_strlen('http://')),
    '!mailto' => $account->mail,
    '!date' => format_date(time()),
    '!login_uri' => url('user', array(
      'absolute' => TRUE,
    )),
    '!edit_uri' => url('user/' . $account->uid . '/edit', array(
      'absolute' => TRUE,
    )),
    'subject' => $subject,
    'body' => $body,
    'email_format' => $format,
    'css' => $css,
  );
  _user_import_publication_email($params, $account, $subscribed, $format);

  // import info to profile
  if (module_exists('profile') && is_array($profile)) {
    $profile_name = _user_import_profile('fid', 'name');
    foreach ($profile_name as $fid => $field_name) {
      $params['!' . $field_name] = $profile[$fid];
    }
  }
  $language = user_preferred_language($account);

  // Whether or not to automatically send the mail when drupal_mail() is
  // called. This defaults to TRUE, and is normally what you want unless you
  // need to do additional processing before drupal_mail_send() is called.
  $send = TRUE;
  $sent = drupal_mail($module, $key, $to, $language, $params, $from, $send);
  return;
}

/**
 * Implementation of hook_mail().
 */
function user_import_mail($key, &$message, $params) {
  switch ($key) {
    case 'welcome':
      $message['subject'] = empty($params['subject']) ? _user_mail_text('register_admin_created_subject', $message['language'], $params) : strtr($params['subject'], $params);
      $body = empty($params['body']) ? _user_mail_text('register_admin_created_body', $message['language'], $params) : strtr($params['body'], $params);
      if ($params['email_format'] == 1) {
        $message['headers']['Content-Type'] = 'text/html; charset=UTF-8';
        $body_head = '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
	            <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
	            <head>
	            <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />';
        if (!empty($params['css'])) {
          $body_head .= '<style type="text/css">' . check_plain($params['css']) . '</style>';
        }
        $message['body'][] = $body_head . '</head><body>' . $body . '</body></html>';
      }
      else {
        $message['body'][] = $body;
      }
      break;
  }
}
function _user_import_edit_settings_fields(&$form, $import, $collapsed) {
  $form['optional'] = array(
    '#type' => 'fieldset',
    '#title' => t('Options'),
    '#weight' => -85,
    '#collapsible' => TRUE,
    '#collapsed' => $collapsed,
  );
  $form['optional']['first_line_skip'] = array(
    '#type' => 'checkbox',
    '#title' => t('Ignore First Line'),
    '#default_value' => isset($import['first_line_skip']) ? $import['first_line_skip'] : 0,
    '#description' => t('If the first line is the names of the data columns, set to ignore first line.'),
  );

  /**
   * @todo move contact options to a separate contact.inc support file
   */
  $form['optional']['contact'] = array(
    '#type' => 'checkbox',
    '#title' => t('Contact'),
    '#default_value' => isset($import['contact']) ? $import['contact'] : 0,
    '#description' => t("Set each user's personal contact form to 'allowed'."),
  );
  $form['optional']['send_email'] = array(
    '#type' => 'checkbox',
    '#title' => t('Send Email'),
    '#default_value' => isset($import['send_email']) ? $import['send_email'] : 0,
    '#description' => t('Send email to users when their account is created.'),
  );
  $form['optional']['username_space'] = array(
    '#type' => 'checkbox',
    '#title' => t('Username Space'),
    '#default_value' => isset($import['username_space']) ? $import['username_space'] : 0,
    '#description' => t("Include spaces in usernames, e.g. 'John' + 'Smith' => 'John Smith'."),
  );
  $form['optional']['activate'] = array(
    '#type' => 'checkbox',
    '#title' => t('Activate Accounts'),
    '#default_value' => isset($import['activate']) ? $import['activate'] : 0,
    '#description' => t("User accounts will not be visible to other users until their owner logs in. Select this option to make all imported user accounts visible. <strong>Note - one time login links in welcome emails will no longer work if this option is enabled.</strong>"),
  );
  $form['optional']['delimiter'] = array(
    '#type' => 'textfield',
    '#title' => t('File Delimiter'),
    '#size' => 4,
    '#default_value' => isset($import['delimiter']) ? $import['delimiter'] : ',',
    '#description' => t("The column delimiter for the file. Use '/t' for Tab."),
  );
  return;
}
function _user_import_edit_template_fields(&$form, $import) {

  // settings template update controls
  if (empty($import['name'])) {

    // new settings template save controls
    $form['save'] = array(
      '#type' => 'fieldset',
      '#title' => t('Save Settings'),
      '#description' => t('Save settings for re-use on other imports.'),
      '#weight' => 90,
      '#collapsible' => TRUE,
      '#collapsed' => FALSE,
    );
    $form['save']['name'] = array(
      '#type' => 'textfield',
      '#title' => t('Settings Name'),
      '#size' => 26,
      '#maxlength' => 25,
      '#description' => t('Name to identify these settings by.'),
    );
    $form['save'][] = array(
      '#type' => 'submit',
      '#value' => t('Save'),
      '#validate' => array(
        'user_import_template_has_name_validate',
        'user_import_template_unique_name_validate',
        'user_import_edit_form_validate',
      ),
      '#submit' => array(
        'user_import_template_new_submit',
      ),
    );
  }
  else {
    $form['save'] = array(
      '#type' => 'fieldset',
      '#title' => t('Saved Settings'),
      '#description' => t("If changes have neen made to the settings since they where last saved you can update the saved template, or save them as a new template."),
      '#weight' => 90,
      '#collapsible' => TRUE,
      '#collapsed' => TRUE,
    );
    $form['#current_template'] = $import['name'];
    $form['save']['update'] = array(
      '#type' => 'fieldset',
      '#title' => t('Update'),
      '#description' => t("Update '%name' settings template", array(
        '%name' => $import['name'],
      )),
    );
    $form['save']['update']['submit'] = array(
      '#type' => 'submit',
      '#value' => t('Update'),
      '#validate' => array(
        'user_import_edit_form_validate',
      ),
      '#submit' => array(
        'user_import_template_update_submit',
      ),
    );
    $form['save']['new'] = array(
      '#type' => 'fieldset',
      '#title' => t('Create New'),
      '#description' => t("Save as new settings template"),
    );
    $form['save']['new']['name'] = array(
      '#type' => 'textfield',
      '#title' => t('Save As New'),
      '#size' => 30,
      '#maxlength' => 25,
      '#description' => t('Name to identify these settings by.'),
    );
    $form['save']['new'][] = array(
      '#type' => 'submit',
      '#value' => t('Save As New'),
      '#validate' => array(
        'user_import_template_has_name_validate',
        'user_import_template_unique_name_validate',
        'user_import_edit_form_validate',
      ),
      '#submit' => array(
        'user_import_template_new_submit',
      ),
    );
  }
  return;
}

/**
 * Validate that a template has a name.
 */
function user_import_template_has_name_validate($form, &$form_state) {
  $template_name = trim($form_state['values']['name']);
  if (empty($template_name)) {
    form_set_error('name', t('A name needs to be set to save this settings template.'));
  }
}

/**
 * Validate that a template has a unique name.
 */
function user_import_template_unique_name_validate($form, &$form_state) {
  $template_name = trim($form_state['values']['name']);
  $unique_name = db_result(db_query("SELECT COUNT(import_id) FROM {user_import} WHERE name = '%s'", $template_name));
  if (!empty($unique_name)) {
    form_set_error('name', t("'!name' is already in use by another settings template.", array(
      '!name' => $template_name,
    )));
  }
}
function _user_import_edit_remove_fields(&$form, $import) {
  $form['remove'] = array(
    '#type' => 'fieldset',
    '#title' => t('Use Different CSV File'),
    '#description' => t('Remove file to use a different file. All settings on this page will be deleted.'),
    '#weight' => -100,
    '#collapsible' => TRUE,
    '#collapsed' => TRUE,
  );
  $form['remove']['file'] = array(
    '#type' => 'item',
    '#title' => t('Uploaded file'),
    '#value' => $import['filename'],
  );
  $form['remove']['submit'] = array(
    '#type' => 'submit',
    '#value' => t('Remove file'),
    '#validate' => array(
      'user_import_edit_remove_file_validate',
    ),
  );
  return;
}

/**
 *  Delete settings and uploaded file
 */
function user_import_edit_remove_file_validate($form, &$form_state) {
  $settings = _user_import_settings_select($form_state['values']['import_id']);
  _user_import_settings_deletion($form_state['values']['import_id']);
  _user_import_file_deletion($settings['filepath'], $settings['filename'], $settings['oldfilename'], $settings['options']['ftp']);
  drupal_goto('admin/user/user_import/add');
}
function _user_import_publication_email(&$variables, $account, $subscribed, $format) {
  if (!module_exists('publication') || !module_exists('schedule') || !module_exists('identity_hash')) {
    return;
  }
  $id_hash = identity_hash_select_hash($account->uid);
  $variables['!id_hash'] = $id_hash->hash;
  while (list($type, $subscriptions) = each($subscribed)) {
    while (list($publication_id, $shedule) = each($subscriptions)) {
      if (!empty($shedule[0])) {
        $publication = publication_select_publications($type, $publication_id);
        $update_link = url('subscribed/preferences/' . $publication_id . '/' . $id_hash->hash, array(
          'absolute' => TRUE,
        ));
        $unsubscribe_link = url('subscribed/delete/' . $publication_id . '/' . $id_hash->hash, array(
          'absolute' => TRUE,
        ));
        if ($format == 1) {
          $variables['!subscribed_links'] .= '<strong>' . $publication->title . '</strong><br />' . '<a href="' . $update_link . '">' . t('Update Preferences') . '</a> | <a href="' . $unsubscribe_link . '">' . t('Unsubscribe') . '</a><br />';
        }
        else {
          $variables['!subscribed_links'] .= $publication->title . "\n" . ' - ' . t('Update Preferences') . ' ' . $update_link . '\\n' . ' - ' . t('Unsubscribe') . ' ' . $unsubscribe_link . '\\n';
        }
      }
    }
  }
}

Functions

Namesort descending Description
user_import_edit_remove_file_validate Delete settings and uploaded file
user_import_mail Implementation of hook_mail().
user_import_template_has_name_validate Validate that a template has a name.
user_import_template_unique_name_validate Validate that a template has a unique name.
user_import_user_import_after_save Implementation of hook_user_import_after_save().
user_import_user_import_form_fieldset Implementation of hook_user_import_form_fieldsets(). Add fieldsets to an import settings form.
_user_import_edit_remove_fields
_user_import_edit_settings_fields
_user_import_edit_template_fields
_user_import_publication_email
_user_import_send_email