Same filename and directory in other branches
  1. 4.6.x modules/profile.module

Support for configurable user profiles.

File

modules/profile.module
View source
<?php

/**
 * @file
 * Support for configurable user profiles.
 */

/**
 * Flags to define the visibility of a profile field.
 */
define('PROFILE_PRIVATE', 1);
define('PROFILE_PUBLIC', 2);
define('PROFILE_PUBLIC_LISTINGS', 3);
define('PROFILE_HIDDEN', 4);

/**
 * Implementation of hook_help().
 */
function profile_help($section) {
  switch ($section) {
    case 'admin/help#profile':
      $output = '<p>' . t('The profile module allows you to define custom fields (such as country, real name, age, ...) in the user profile. This permits users of a site to share more information about themselves, and can help community-based sites to organize users around profile fields.') . '</p>';
      $output .= t('<p>The following types of fields can be added to the user profile:</p>
<ul>
<li>single-line textfield</li>
<li>multi-line textfield</li>
<li>checkbox</li>
<li>list selection</li>
<li>freeform list</li>
<li>URL</li>
<li>date</li>
</ul>
');
      $output .= t('<p>You can</p>
<ul>
<li>view user <a href="%profile">profiles</a>.</li>
<li>administer profile settings: <a href="%admin-settings-profile">administer &gt;&gt; settings &gt;&gt; profiles</a>.</li>
</ul>
', array(
        '%profile' => url('profile'),
        '%admin-settings-profile' => url('admin/settings/profile'),
      ));
      $output .= '<p>' . t('For more information please read the configuration and customization handbook <a href="%profile">Profile page</a>.', array(
        '%profile' => 'http://drupal.org/handbook/modules/profile/',
      )) . '</p>';
      return $output;
    case 'admin/modules#description':
      return t('Supports configurable user profiles.');
    case 'admin/settings/profile':
      return t('<p>Here you can define custom fields that users can fill in in their user profile (such as <em>country</em>, <em>real name</em>, <em>age</em>, ...).</p>');
  }
}

/**
 * Implementation of hook_menu().
 */
function profile_menu($may_cache) {
  $items = array();
  if ($may_cache) {
    $items[] = array(
      'path' => 'profile',
      'title' => t('user list'),
      'callback' => 'profile_browse',
      'access' => user_access('access user profiles'),
      'type' => MENU_SUGGESTED_ITEM,
    );
    $items[] = array(
      'path' => 'admin/settings/profile',
      'title' => t('profiles'),
      'callback' => 'profile_admin_overview',
    );
    $items[] = array(
      'path' => 'admin/settings/profile/add',
      'title' => t('add field'),
      'callback' => 'profile_field_form',
      'type' => MENU_CALLBACK,
    );
    $items[] = array(
      'path' => 'admin/settings/profile/edit',
      'title' => t('edit field'),
      'callback' => 'profile_field_form',
      'type' => MENU_CALLBACK,
    );
    $items[] = array(
      'path' => 'admin/settings/profile/delete',
      'title' => t('delete field'),
      'callback' => 'profile_field_delete',
      'type' => MENU_CALLBACK,
    );
  }
  return $items;
}

/**
 * Implementation of hook_block().
 */
function profile_block($op = 'list', $delta = 0, $edit = array()) {
  if ($op == 'list') {
    $blocks[0]['info'] = t('Author information');
    return $blocks;
  }
  else {
    if ($op == 'configure' && $delta == 0) {

      // Compile a list of fields to show
      $fields = array();
      $result = db_query('SELECT name, title, weight, visibility FROM {profile_fields} WHERE visibility IN (%d, %d) ORDER BY weight', PROFILE_PUBLIC, PROFILE_PUBLIC_LISTINGS);
      while ($record = db_fetch_object($result)) {
        $fields[$record->name] = check_plain($record->title);
      }
      $fields['user_profile'] = t('Link to full user profile');
      $form['profile_block_author_fields'] = array(
        '#type' => 'checkboxes',
        '#title' => t('Profile fields to display'),
        '#default_value' => variable_get('profile_block_author_fields', NULL),
        '#options' => $fields,
        '#description' => t('Select which profile fields you wish to display in the block. Only fields designated as public in the <a href="%profile-admin">profile field configuration</a> are available.', array(
          '%profile-admin' => url('admin/settings/profile'),
        )),
      );
      return $form;
    }
    else {
      if ($op == 'save' && $delta == 0) {
        variable_set('profile_block_author_fields', $edit['profile_block_author_fields']);
      }
      else {
        if ($op == 'view') {
          if (user_access('access user profiles')) {
            if (arg(0) == 'node' && is_numeric(arg(1)) && arg(2) == NULL) {
              $node = node_load(arg(1));
              $account = user_load(array(
                'uid' => $node->uid,
              ));
              if ($use_fields = variable_get('profile_block_author_fields', array())) {

                // Compile a list of fields to show.
                $fields = array();
                $result = db_query('SELECT name, title, type, visibility, weight FROM {profile_fields} WHERE visibility IN (%d, %d) ORDER BY weight', PROFILE_PUBLIC, PROFILE_PUBLIC_LISTINGS);
                while ($record = db_fetch_object($result)) {

                  // Ensure that field is displayed only if it is among the defined block fields and, if it is private, the user has appropriate permissions.
                  if (isset($use_fields[$record->name]) && $use_fields[$record->name]) {
                    $fields[] = $record;
                  }
                }
              }
              if ($fields) {
                $fields = _profile_update_user_fields($fields, $account);
                $output .= theme('profile_block', $account, $fields, true);
              }
              if (isset($use_fields['user_profile']) && $use_fields['user_profile']) {
                $output .= '<div>' . l(t('View full user profile'), 'user/' . $account->uid) . '</div>';
              }
            }
            if ($output) {
              $block['subject'] = t('About %name', array(
                '%name' => check_plain($account->name),
              ));
              $block['content'] = $output;
              return $block;
            }
          }
        }
      }
    }
  }
}

/**
 * Implementation of hook_user().
 */
function profile_user($type, &$edit, &$user, $category = NULL) {
  switch ($type) {
    case 'load':
      return profile_load_profile($user);
    case 'register':
      return profile_form_profile($edit, $user, $category);
    case 'update':
    case 'insert':
      return profile_save_profile($edit, $user, $category);
    case 'view':
      return profile_view_profile($user);
    case 'form':
      return profile_form_profile($edit, $user, $category);
    case 'validate':
      return profile_validate_profile($edit, $category);
    case 'categories':
      return profile_categories();
    case 'delete':
      db_query('DELETE FROM {profile_values} WHERE uid = %d', $user->uid);
  }
}

/**
 * Menu callback: Generate a form to add/edit a user profile field.
 */
function profile_field_form($arg = NULL) {
  if (arg(3) == 'edit') {
    if (is_numeric($arg)) {
      $fid = $arg;
      $edit = db_fetch_array(db_query('SELECT * FROM {profile_fields} WHERE fid = %d', $fid));
      if (!$edit) {
        drupal_not_found();
        return;
      }
      drupal_set_title(t('edit %title', array(
        '%title' => check_plain($edit['title']),
      )));
      $form['fid'] = array(
        '#type' => 'value',
        '#value' => $fid,
      );
      $type = $edit['type'];
    }
    else {
      drupal_not_found();
      return;
    }
  }
  else {
    $types = _profile_field_types();
    if (!isset($types[$arg])) {
      drupal_not_found();
      return;
    }
    $type = $arg;
    drupal_set_title(t('add new %type', array(
      '%type' => $types[$type],
    )));
    $edit = array(
      'name' => 'profile_',
    );
    $form['type'] = array(
      '#type' => 'value',
      '#value' => $type,
    );
  }
  $form['fields'] = array(
    '#type' => 'fieldset',
    '#title' => t('Field settings'),
  );
  $form['fields']['category'] = array(
    '#type' => 'textfield',
    '#title' => t('Category'),
    '#default_value' => $edit['category'],
    '#description' => t('The category the new field should be part of. Categories are used to group fields logically. An example category is "Personal information".'),
    '#required' => TRUE,
  );
  $form['fields']['title'] = array(
    '#type' => 'textfield',
    '#title' => t('Title'),
    '#default_value' => $edit['title'],
    '#description' => t('The title of the new field. The title will be shown to the user. An example title is "Favorite color".'),
    '#required' => TRUE,
  );
  $form['fields']['name'] = array(
    '#type' => 'textfield',
    '#title' => t('Form name'),
    '#default_value' => $edit['name'],
    '#description' => t('The name of the field. The form name is not shown to the user but used internally in the HTML code and URLs.
Unless you know what you are doing, it is highly recommended that you prefix the form name with <code>profile_</code> to avoid name clashes with other fields. Spaces or any other special characters except dash (-) and underscore (_) are not allowed. An example name is "profile_favorite_color" or perhaps just "profile_color".'),
    '#required' => TRUE,
  );
  $form['fields']['explanation'] = array(
    '#type' => 'textarea',
    '#title' => t('Explanation'),
    '#default_value' => $edit['explanation'],
    '#description' => t('An optional explanation to go with the new field. The explanation will be shown to the user.'),
  );
  if ($type == 'selection') {
    $form['fields']['options'] = array(
      '#type' => 'textarea',
      '#title' => t('Selection options'),
      '#default_value' => $edit['options'],
      '#description' => t('A list of all options. Put each option on a separate line. Example options are "red", "blue", "green", etc.'),
    );
  }
  $form['fields']['weight'] = array(
    '#type' => 'weight',
    '#title' => t('Weight'),
    '#default_value' => $edit['weight'],
    '#delta' => 5,
    '#description' => t('The weights define the order in which the form fields are shown. Lighter fields "float up" towards the top of the category.'),
  );
  $form['fields']['visibility'] = array(
    '#type' => 'radios',
    '#title' => t('Visibility'),
    '#default_value' => isset($edit['visibility']) ? $edit['visibility'] : PROFILE_PUBLIC,
    '#options' => array(
      PROFILE_HIDDEN => t('Hidden profile field, only accessible by administrators, modules and themes.'),
      PROFILE_PRIVATE => t('Private field, content only available to privileged users.'),
      PROFILE_PUBLIC => t('Public field, content shown on profile page but not used on member list pages.'),
      PROFILE_PUBLIC_LISTINGS => t('Public field, content shown on profile page and on member list pages.'),
    ),
  );
  if ($type == 'selection' || $type == 'list' || $type == 'textfield') {
    $form['fields']['page'] = array(
      '#type' => 'textfield',
      '#title' => t('Page title'),
      '#default_value' => $edit['page'],
      '#description' => t('To enable browsing this field by value, enter a title for the resulting page. The word <code>%value</code> will be substituted with the corresponding value. An example page title is "People whose favorite color is %value". This is only applicable for a public field.'),
    );
  }
  else {
    if ($type == 'checkbox') {
      $form['fields']['page'] = array(
        '#type' => 'textfield',
        '#title' => t('Page title'),
        '#default_value' => $edit['page'],
        '#description' => t('To enable browsing this field by value, enter a title for the resulting page. An example page title is "People who are employed". This is only applicable for a public field.'),
      );
    }
  }
  $form['fields']['required'] = array(
    '#type' => 'checkbox',
    '#title' => t('The user must enter a value.'),
    '#default_value' => $edit['required'],
  );
  $form['fields']['register'] = array(
    '#type' => 'checkbox',
    '#title' => t('Visible in user registration form.'),
    '#default_value' => $edit['register'],
  );
  $form['submit'] = array(
    '#type' => 'submit',
    '#value' => t('Save field'),
  );
  return drupal_get_form('profile_field_form', $form);
}

/**
 * Validate profile_field_form submissions.
 */
function profile_field_form_validate($form_id, $form_values) {

  // Validate the 'field name':
  if (eregi('[^a-z0-9_-]', $form_values['name'])) {
    form_set_error('name', t('The specified form name contains one or more illegal characters. Spaces or any other special characters expect dash (-) and underscore (_) are not allowed.'));
  }
  if (in_array($form_values['name'], user_fields())) {
    form_set_error('name', t('The specified form name is reserved for use by Drupal.'));
  }

  // Validate the category:
  if (!$form_values['category']) {
    form_set_error('category', t('You must enter a category.'));
  }
  if ($form_values['category'] == 'account') {
    form_set_error('category', t('The specified category name is reserved for use by Drupal.'));
  }
  $args1 = array(
    $form_values['title'],
    $form_values['category'],
  );
  $args2 = array(
    $form_values['name'],
  );
  $query_suffix = '';
  if (isset($form_values['fid'])) {
    $args1[] = $args2[] = $form_values['fid'];
    $query_suffix = ' AND fid != %d';
  }
  if (db_result(db_query("SELECT fid FROM {profile_fields} WHERE title = '%s' AND category = '%s'" . $query_suffix, $args1))) {
    form_set_error('title', t('The specified title is already in use.'));
  }
  if (db_result(db_query("SELECT fid FROM {profile_fields} WHERE name = '%s'" . $query_suffix, $args2))) {
    form_set_error('name', t('The specified name is already in use.'));
  }
}

/**
 * Process profile_field_form submissions.
 */
function profile_field_form_submit($form_id, $form_values) {
  if (!isset($form_values['fid'])) {
    db_query("INSERT INTO {profile_fields} (title, name, explanation, category, type, weight, required, register, visibility, options, page) VALUES ('%s', '%s', '%s', '%s', '%s', %d, %d, %d, %d, '%s', '%s')", $form_values['title'], $form_values['name'], $form_values['explanation'], $form_values['category'], $form_values['type'], $form_values['weight'], $form_values['required'], $form_values['register'], $form_values['visibility'], $form_values['options'], $form_values['page']);
    drupal_set_message(t('The field has been created.'));
    watchdog('profile', t('Profile field %field added under category %category.', array(
      '%field' => theme('placeholder', $form_values['title']),
      '%category' => theme('placeholder', $form_values['category']),
    )), WATCHDOG_NOTICE, l(t('view'), 'admin/settings/profile'));
  }
  else {
    db_query("UPDATE {profile_fields} SET title = '%s', name = '%s', explanation = '%s', category = '%s', weight = %d, required = %d, register = %d, visibility = %d, options = '%s', page = '%s' WHERE fid = %d", $form_values['title'], $form_values['name'], $form_values['explanation'], $form_values['category'], $form_values['weight'], $form_values['required'], $form_values['register'], $form_values['visibility'], $form_values['options'], $form_values['page'], $form_values['fid']);
    drupal_set_message(t('The field has been updated.'));
  }
  cache_clear_all();
  return 'admin/settings/profile';
}

/**
 * Menu callback; deletes a field from all user profiles.
 */
function profile_field_delete($fid) {
  $field = db_fetch_object(db_query("SELECT title FROM {profile_fields} WHERE fid = %d", $fid));
  if (!$field) {
    drupal_not_found();
    return;
  }
  $form['fid'] = array(
    '#type' => 'value',
    '#value' => $fid,
  );
  $form['title'] = array(
    '#type' => 'value',
    '#value' => $field->title,
  );
  return confirm_form('profile_field_delete', $form, t('Are you sure you want to delete the field %field?', array(
    '%field' => theme('placeholder', $field->title),
  )), 'admin/settings/profile', t('This action cannot be undone. If users have entered values into this field in their profile, these entries will also be deleted. If you want to keep the user-entered data, instead of deleting the field you may wish to <a href="%edit-field">edit this field</a> and change it to a %hidden-field so that it may only be accessed by administrators.', array(
    '%edit-field' => url('admin/settings/profile/edit/' . $fid),
    '%hidden-field' => theme('placeholder', t('hidden profile field')),
  )), t('Delete'), t('Cancel'));
}

/**
 * Process a field delete form submission.
 */
function profile_field_delete_submit($form_id, $form_values) {
  db_query('DELETE FROM {profile_fields} WHERE fid = %d', $form_values['fid']);
  db_query('DELETE FROM {profile_values} WHERE fid = %d', $form_values['fid']);
  cache_clear_all();
  drupal_set_message(t('The field %field has been deleted.', array(
    '%field' => theme('placeholder', $form_values['title']),
  )));
  watchdog('profile', t('Profile field %field deleted.', array(
    '%field' => theme('placeholder', $form_values['title']),
  )), WATCHDOG_NOTICE, l(t('view'), 'admin/settings/profile'));
  return 'admin/settings/profile';
}

/**
 * Menu callback; display a listing of all editable profile fields.
 */
function profile_admin_overview() {
  $result = db_query('SELECT * FROM {profile_fields} ORDER BY category, weight');
  $rows = array();
  while ($field = db_fetch_object($result)) {
    $rows[] = array(
      check_plain($field->title),
      check_plain($field->name),
      _profile_field_types($field->type),
      $field->category,
      l(t('edit'), "admin/settings/profile/edit/{$field->fid}"),
      l(t('delete'), "admin/settings/profile/delete/{$field->fid}"),
    );
  }
  if (count($rows) == 0) {
    $rows[] = array(
      array(
        'data' => t('No fields defined.'),
        'colspan' => '6',
      ),
    );
  }
  $header = array(
    t('Title'),
    t('Name'),
    t('Type'),
    t('Category'),
    array(
      'data' => t('Operations'),
      'colspan' => '2',
    ),
  );
  $output = theme('table', $header, $rows);
  $output .= '<h2>' . t('Add new field') . '</h2>';
  $output .= '<ul>';
  foreach (_profile_field_types() as $key => $value) {
    $output .= '<li>' . l($value, "admin/settings/profile/add/{$key}") . '</li>';
  }
  $output .= '</ul>';
  return $output;
}

/**
 * Menu callback; display a list of user information.
 */
function profile_browse() {
  $name = arg(1);
  list(, , $value) = explode('/', $_GET['q'], 3);
  $field = db_fetch_object(db_query("SELECT DISTINCT(fid), type, title, page, visibility FROM {profile_fields} WHERE name = '%s'", $name));
  if ($name && $field->fid) {

    // Only allow browsing of fields that have a page title set.
    if (empty($field->page)) {
      drupal_not_found();
      return;
    }

    // Do not allow browsing of private fields by non-admins.
    if (!user_access('administer users') && $field->visibility == PROFILE_PRIVATE) {
      drupal_access_denied();
      return;
    }

    // Compile a list of fields to show.
    $fields = array();
    $result = db_query('SELECT name, title, type, weight, page FROM {profile_fields} WHERE fid != %d AND visibility = %d ORDER BY weight', $field->fid, PROFILE_PUBLIC_LISTINGS);
    while ($record = db_fetch_object($result)) {
      $fields[] = $record;
    }

    // Determine what query to use:
    $arguments = array(
      $field->fid,
    );
    switch ($field->type) {
      case 'checkbox':
        $query = 'v.value = 1';
        break;
      case 'textfield':
      case 'selection':
        $query = "v.value = '%s'";
        $arguments[] = $value;
        break;
      case 'list':
        $query = "v.value LIKE '%%%s%%'";
        $arguments[] = $value;
        break;
      default:
        drupal_not_found();
        return;
    }

    // Extract the affected users:
    $result = pager_query("SELECT u.uid, u.access FROM {users} u INNER JOIN {profile_values} v ON u.uid = v.uid WHERE v.fid = %d AND {$query} AND u.access != 0 AND u.status != 0 ORDER BY u.access DESC", 20, 0, NULL, $arguments);
    $output = '<div id="profile">';
    while ($account = db_fetch_object($result)) {
      $account = user_load(array(
        'uid' => $account->uid,
      ));
      $profile = _profile_update_user_fields($fields, $account);
      $output .= theme('profile_listing', $account, $profile);
    }
    $output .= theme('pager', NULL, 20);
    if ($field->type == 'selection' || $field->type == 'list' || $field->type == 'textfield') {
      $title = strtr($field->page, array(
        '%value' => $value,
      ));
    }
    else {
      $title = $field->page;
    }
    $output .= '</div>';
    drupal_set_title(check_plain($title));
    return $output;
  }
  else {
    if ($name && !$field->fid) {
      drupal_not_found();
    }
    else {

      // Compile a list of fields to show.
      $fields = array();
      $result = db_query('SELECT name, title, type, weight, page FROM {profile_fields} WHERE visibility = %d ORDER BY category, weight', PROFILE_PUBLIC_LISTINGS);
      while ($record = db_fetch_object($result)) {
        $fields[] = $record;
      }

      // Extract the affected users:
      $result = pager_query('SELECT uid, access FROM {users} WHERE uid > 0 AND status != 0 AND access != 0 ORDER BY access DESC', 20, 0, NULL);
      $output = '<div id="profile">';
      while ($account = db_fetch_object($result)) {
        $account = user_load(array(
          'uid' => $account->uid,
        ));
        $profile = _profile_update_user_fields($fields, $account);
        $output .= theme('profile_listing', $account, $profile);
      }
      $output .= '</div>';
      $output .= theme('pager', NULL, 20);
      drupal_set_title(t('user list'));
      return $output;
    }
  }
}
function profile_load_profile(&$user) {
  $result = db_query('SELECT f.name, f.type, v.value FROM {profile_fields} f INNER JOIN {profile_values} v ON f.fid = v.fid WHERE uid = %d', $user->uid);
  while ($field = db_fetch_object($result)) {
    if (empty($user->{$field->name})) {
      $user->{$field->name} = _profile_field_serialize($field->type) ? unserialize($field->value) : $field->value;
    }
  }
}
function profile_save_profile(&$edit, &$user, $category) {
  if (arg(0) == 'user' && arg(1) == 'register' || arg(0) == 'admin' && arg(1) == 'user' && arg(2) == 'create') {
    $result = db_query('SELECT fid, name, type FROM {profile_fields} WHERE register = 1 AND visibility != %d ORDER BY category, weight', PROFILE_HIDDEN);
  }
  else {
    $result = db_query("SELECT fid, name, type FROM {profile_fields} WHERE LOWER(category) = LOWER('%s') AND visibility != %d", $category, PROFILE_HIDDEN);

    // Use LOWER('%s') instead of PHP's strtolower() to avoid UTF-8 conversion issues.
  }
  while ($field = db_fetch_object($result)) {
    if (_profile_field_serialize($field->type)) {
      $edit[$field->name] = serialize($edit[$field->name]);
    }
    db_query("DELETE FROM {profile_values} WHERE fid = %d AND uid = %d", $field->fid, $user->uid);
    db_query("INSERT INTO {profile_values} (fid, uid, value) VALUES (%d, %d, '%s')", $field->fid, $user->uid, $edit[$field->name]);

    // Mark field as handled (prevents saving to user->data).
    $edit[$field->name] = NULL;
  }
}
function profile_view_field($user, $field) {

  // Only allow browsing of private fields for admins, if browsing is enabled,
  // and if a user has permission to view profiles. Note that this check is
  // necessary because a user may always see their own profile.
  $browse = user_access('access user profiles') && (user_access('administer users') || $field->visibility != PROFILE_PRIVATE) && !empty($field->page);
  if ($value = $user->{$field->name}) {
    switch ($field->type) {
      case 'textarea':
        return check_markup($value);
      case 'textfield':
      case 'selection':
        return $browse ? l($value, 'profile/' . $field->name . '/' . $value) : check_plain($value);
      case 'checkbox':
        return $browse ? l($field->title, 'profile/' . $field->name) : check_plain($field->title);
      case 'url':
        return '<a href="' . check_url($value) . '">' . check_plain($value) . '</a>';
      case 'date':
        $format = substr(variable_get('date_format_short', 'm/d/Y - H:i'), 0, 5);

        // Note: Avoid PHP's date() because it does not handle dates before
        // 1970 on Windows. This would make the date field useless for e.g.
        // birthdays.
        $replace = array(
          'd' => sprintf('%02d', $value['day']),
          'j' => $value['day'],
          'm' => sprintf('%02d', $value['month']),
          'M' => map_month($value['month']),
          'Y' => $value['year'],
          'H:i' => null,
          'g:ia' => null,
        );
        return strtr($format, $replace);
      case 'list':
        $values = split("[,\n\r]", $value);
        $fields = array();
        foreach ($values as $value) {
          if ($value = trim($value)) {
            $fields[] = $browse ? l($value, 'profile/' . $field->name . '/' . $value) : check_plain($value);
          }
        }
        return implode(', ', $fields);
    }
  }
}
function profile_view_profile($user) {
  profile_load_profile($user);

  // Show private fields to administrators and people viewing their own account.
  if (user_access('administer users') || $GLOBALS['user']->uid == $user->uid) {
    $result = db_query('SELECT * FROM {profile_fields} WHERE visibility != %d ORDER BY category, weight', PROFILE_HIDDEN);
  }
  else {
    $result = db_query('SELECT * FROM {profile_fields} WHERE visibility != %d AND visibility != %d ORDER BY category, weight', PROFILE_PRIVATE, PROFILE_HIDDEN);
  }
  while ($field = db_fetch_object($result)) {
    if ($value = profile_view_field($user, $field)) {
      $description = $field->visibility == PROFILE_PRIVATE ? t('The content of this field is private and only visible to yourself.') : '';
      $title = $field->type != 'checkbox' ? check_plain($field->title) : NULL;
      $item = array(
        'title' => $title,
        'value' => $value,
        'class' => $field->name,
      );
      $fields[$field->category][] = $item;
    }
  }
  return $fields;
}
function _profile_form_explanation($field) {
  $output = $field->explanation;
  if ($field->type == 'list') {
    $output .= ' ' . t('Put each item on a separate line or separate them by commas. No HTML allowed.');
  }
  if ($field->visibility == PROFILE_PRIVATE) {
    $output .= ' ' . t('The content of this field is kept private and will not be shown publicly.');
  }
  return $output;
}
function profile_form_profile($edit, $user, $category) {
  if (arg(0) == 'user' && arg(1) == 'register') {
    $result = db_query('SELECT * FROM {profile_fields} WHERE visibility != %d AND register = 1 ORDER BY category, weight', PROFILE_HIDDEN);
  }
  elseif (arg(0) == 'admin' && arg(1) == 'user' && arg(2) == 'create') {
    $result = db_query('SELECT * FROM {profile_fields} WHERE register = 1 ORDER BY category, weight');
  }
  elseif (user_access('administer users')) {
    $result = db_query("SELECT * FROM {profile_fields} WHERE LOWER(category) = LOWER('%s') ORDER BY weight", $category);
  }
  else {
    $result = db_query("SELECT * FROM {profile_fields} WHERE visibility != %d AND LOWER(category) = LOWER('%s') ORDER BY weight", PROFILE_HIDDEN, $category);

    // Use LOWER('%s') instead of PHP's strtolower() to avoid UTF-8 conversion issues.
  }
  $w = 1;
  while ($field = db_fetch_object($result)) {
    $category = $field->category;
    if (!isset($fields[$category])) {
      $fields[$category] = array(
        '#type' => 'fieldset',
        '#title' => check_plain($category),
        '#weight' => $w++,
      );
    }
    switch ($field->type) {
      case 'textfield':
      case 'url':
        $fields[$category][$field->name] = array(
          '#type' => 'textfield',
          '#title' => check_plain($field->title),
          '#default_value' => $edit[$field->name],
          '#maxlength' => 255,
          '#description' => _profile_form_explanation($field),
          '#required' => $field->required,
        );
        break;
      case 'textarea':
        $fields[$category][$field->name] = array(
          '#type' => 'textarea',
          '#title' => check_plain($field->title),
          '#default_value' => $edit[$field->name],
          '#description' => _profile_form_explanation($field),
          '#required' => $field->required,
        );
        break;
      case 'list':
        $fields[$category][$field->name] = array(
          '#type' => 'textarea',
          '#title' => check_plain($field->title),
          '#default_value' => $edit[$field->name],
          '#description' => _profile_form_explanation($field),
          '#required' => $field->required,
        );
        break;
      case 'checkbox':
        $fields[$category][$field->name] = array(
          '#type' => 'checkbox',
          '#title' => check_plain($field->title),
          '#default_value' => $edit[$field->name],
          '#description' => _profile_form_explanation($field),
          '#required' => $field->required,
        );
        break;
      case 'selection':
        $options = $field->required ? array() : array(
          '--',
        );
        $lines = split("[,\n\r]", $field->options);
        foreach ($lines as $line) {
          if ($line = trim($line)) {
            $options[$line] = $line;
          }
        }
        $fields[$category][$field->name] = array(
          '#type' => 'select',
          '#title' => check_plain($field->title),
          '#default_value' => $edit[$field->name],
          '#options' => $options,
          '#description' => _profile_form_explanation($field),
          '#required' => $field->required,
        );
        break;
      case 'date':
        $fields[$category][$field->name] = array(
          '#type' => 'date',
          '#title' => check_plain($field->title),
          '#default_value' => $edit[$field->name],
          '#description' => _profile_form_explanation($field),
          '#required' => $field->required,
        );
        break;
    }
  }
  return $fields;
}

/**
 * Helper function: update an array of user fields by calling profile_view_field
 */
function _profile_update_user_fields($fields, $account) {
  foreach ($fields as $key => $field) {
    $fields[$key]->value = profile_view_field($account, $field);
  }
  return $fields;
}
function profile_validate_profile($edit, $category) {
  if (arg(0) == 'user' && arg(1) == 'register') {
    $result = db_query('SELECT * FROM {profile_fields} WHERE visibility != %d AND register = 1 ORDER BY category, weight', PROFILE_HIDDEN);
  }
  elseif (arg(0) == 'admin' && arg(1) == 'user' && arg(2) == 'create') {
    $result = db_query('SELECT * FROM {profile_fields} WHERE register = 1 ORDER BY category, weight');
  }
  elseif (user_access('administer users')) {
    $result = db_query("SELECT * FROM {profile_fields} WHERE LOWER(category) = LOWER('%s') ORDER BY weight", $category);
  }
  else {
    $result = db_query("SELECT * FROM {profile_fields} WHERE visibility != %d AND LOWER(category) = LOWER('%s') ORDER BY weight", PROFILE_HIDDEN, $category);

    // Use LOWER('%s') instead of PHP's strtolower() to avoid UTF-8 conversion issues.
  }
  while ($field = db_fetch_object($result)) {
    if ($edit[$field->name]) {
      if ($field->type == 'url') {
        if (!valid_url($edit[$field->name], true)) {
          form_set_error($field->name, t('The value provided for %field is not a valid URL.', array(
            '%field' => theme('placeholder', $field->title),
          )));
        }
      }
    }
    else {
      if ($field->required && !user_access('administer users')) {
        form_set_error($field->name, t('The field %field is required.', array(
          '%field' => theme('placeholder', $field->title),
        )));
      }
    }
  }
  return $edit;
}
function profile_categories() {
  $result = db_query("SELECT DISTINCT(category) FROM {profile_fields}");
  while ($category = db_fetch_object($result)) {
    $data[] = array(
      'name' => $category->category,
      'title' => $category->category,
      'weight' => 3,
    );
  }
  return $data;
}
function theme_profile_block($account, $fields = array()) {
  $output .= theme('user_picture', $account);
  foreach ($fields as $field) {
    if ($field->value) {
      if ($field->type == 'checkbox') {
        $output .= "<p>{$field->value}</p>\n";
      }
      else {
        $output .= '<p><strong>' . check_plain($field->title) . "</strong><br />{$field->value}</p>\n";
      }
    }
  }
  return $output;
}
function theme_profile_listing($account, $fields = array()) {
  $output = "<div class=\"profile\">\n";
  $output .= theme('user_picture', $account);
  $output .= ' <div class="name">' . theme('username', $account) . "</div>\n";
  foreach ($fields as $field) {
    if ($field->value) {
      $output .= " <div class=\"field\">{$field->value}</div>\n";
    }
  }
  $output .= "</div>\n";
  return $output;
}
function _profile_field_types($type = NULL) {
  $types = array(
    'textfield' => t('single-line textfield'),
    'textarea' => t('multi-line textfield'),
    'checkbox' => t('checkbox'),
    'selection' => t('list selection'),
    'list' => t('freeform list'),
    'url' => t('URL'),
    'date' => t('date'),
  );
  return isset($type) ? $types[$type] : $types;
}
function _profile_field_serialize($type = NULL) {
  return $type == 'date';
}

Functions

Namesort descending Description
profile_admin_overview Menu callback; display a listing of all editable profile fields.
profile_block Implementation of hook_block().
profile_browse Menu callback; display a list of user information.
profile_categories
profile_field_delete Menu callback; deletes a field from all user profiles.
profile_field_delete_submit Process a field delete form submission.
profile_field_form Menu callback: Generate a form to add/edit a user profile field.
profile_field_form_submit Process profile_field_form submissions.
profile_field_form_validate Validate profile_field_form submissions.
profile_form_profile
profile_help Implementation of hook_help().
profile_load_profile
profile_menu Implementation of hook_menu().
profile_save_profile
profile_user Implementation of hook_user().
profile_validate_profile
profile_view_field
profile_view_profile
theme_profile_block
theme_profile_listing
_profile_field_serialize
_profile_field_types
_profile_form_explanation
_profile_update_user_fields Helper function: update an array of user fields by calling profile_view_field

Constants

Namesort descending Description
PROFILE_HIDDEN
PROFILE_PRIVATE Flags to define the visibility of a profile field.
PROFILE_PUBLIC
PROFILE_PUBLIC_LISTINGS