user.module 130 KB
Newer Older
Dries Buytaert's avatar
   
Dries Buytaert committed
1
2
3
<?php
// $Id$

Dries Buytaert's avatar
   
Dries Buytaert committed
4
5
6
7
8
/**
 * @file
 * Enables the user registration and login system.
 */

9
10
11
define('USERNAME_MAX_LENGTH', 60);
define('EMAIL_MAX_LENGTH', 64);

12
13
14
/**
 * Invokes hook_user() in every module.
 *
15
 * We cannot use module_invoke() for this, because the arguments need to
16
17
 * be passed by reference.
 */
18
function user_module_invoke($type, &$array, &$user, $category = NULL) {
Dries Buytaert's avatar
   
Dries Buytaert committed
19
20
  foreach (module_list() as $module) {
    $function = $module .'_user';
21
22
23
    if (function_exists($function)) {
      $function($type, $array, $user, $category);
    }
Dries Buytaert's avatar
   
Dries Buytaert committed
24
25
26
  }
}

27
28
29
30
31
32
33
/**
 * Implementation of hook_theme()
 */
function user_theme() {
  return array(
    'user_picture' => array(
      'arguments' => array('account' => NULL),
34
      'template' => 'user-picture',
35
36
    ),
    'user_profile' => array(
37
      'arguments' => array('account' => NULL),
38
      'template' => 'user-profile',
39
40
41
    ),
    'user_profile_category' => array(
      'arguments' => array('element' => NULL),
42
      'template' => 'user-profile-category',
43
44
45
    ),
    'user_profile_item' => array(
      'arguments' => array('element' => NULL),
46
      'template' => 'user-profile-item',
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
    ),
    'user_list' => array(
      'arguments' => array('users' => NULL, 'title' => NULL),
    ),
    'user_admin_perm' => array(
      'arguments' => array('form' => NULL),
    ),
    'user_admin_new_role' => array(
      'arguments' => array('form' => NULL),
    ),
    'user_admin_account' => array(
      'arguments' => array('form' => NULL),
    ),
    'user_filter_form' => array(
      'arguments' => array('form' => NULL),
    ),
    'user_filters' => array(
      'arguments' => array('form' => NULL),
    ),
66
67
68
    'user_signature' => array(
      'arguments' => array('signature' => NULL),
    ),
69
70
71
  );
}

Dries Buytaert's avatar
   
Dries Buytaert committed
72
function user_external_load($authname) {
Dries Buytaert's avatar
   
Dries Buytaert committed
73
  $result = db_query("SELECT uid FROM {authmap} WHERE authname = '%s'", $authname);
Dries Buytaert's avatar
   
Dries Buytaert committed
74

75
  if ($user = db_fetch_array($result)) {
Dries Buytaert's avatar
   
Dries Buytaert committed
76
    return user_load($user);
Dries Buytaert's avatar
   
Dries Buytaert committed
77
78
79
80
81
82
  }
  else {
    return 0;
  }
}

83
/**
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
 * Perform standard Drupal login operations for a user object.  The
 * user object must already be authenticated. This function verifies
 * that the user account is not blocked/denied and then performs the login,
 * updates the login timestamp in the database, invokes hook_user('login'),
 * regenerates the session, etc.
 *
 * @param $account
 *    An authenticated user object to be set as the currently logged
 *    in user.
 * @param $edit
 *    The array of form values submitted by the user, if any.
 * @return boolean
 *    TRUE if the login succeeds, FALSE otherwise.
 */
function user_external_login($account, $edit = array()) {
99
100
  $form = drupal_get_form('user_login');

101
102
103
104
105
  $state['values'] = $edit;
  if (empty($state['values']['name'])) {
    $state['values']['name'] = $account->name;
  }

106
107
108
109
110
111
112
113
114
115
  user_login_name_validate($form, $state, (array)$account);
  if (form_get_errors()) {
    return FALSE;
  }
  global $user;
  $user = $account;
  user_login_submit($form, $state, (array)$account);
  return TRUE;
}

116
117
118
119
120
/**
 * Fetch a user object.
 *
 * @param $array
 *   An associative array of attributes to search for in selecting the
121
 *   user, such as user name or e-mail address.
122
123
 *
 * @return
124
 *   A fully-loaded $user object upon successful user load or FALSE if user cannot be loaded.
125
 */
Dries Buytaert's avatar
   
Dries Buytaert committed
126
function user_load($array = array()) {
127
  // Dynamically compose a SQL query:
128
  $query = array();
129
  $params = array();
130

131
132
133
  if (is_numeric($array)) {
    $array = array('uid' => $array);
  }
134
135
136
  elseif (!is_array($array)) {
    return FALSE;
  }
137

Dries Buytaert's avatar
   
Dries Buytaert committed
138
  foreach ($array as $key => $value) {
139
140
    if ($key == 'uid' || $key == 'status') {
      $query[] = "$key = %d";
141
      $params[] = $value;
142
    }
143
144
145
146
    else if ($key == 'pass') {
      $query[] = "pass = '%s'";
      $params[] = md5($value);
    }
Dries Buytaert's avatar
   
Dries Buytaert committed
147
    else {
148
      $query[]= "LOWER($key) = LOWER('%s')";
149
      $params[] = $value;
Dries Buytaert's avatar
   
Dries Buytaert committed
150
151
    }
  }
152
  $result = db_query('SELECT * FROM {users} u WHERE '. implode(' AND ', $query), $params);
Dries Buytaert's avatar
   
Dries Buytaert committed
153

154
  if ($user = db_fetch_object($result)) {
155
    $user = drupal_unpack($user);
Dries Buytaert's avatar
   
Dries Buytaert committed
156

157
    $user->roles = array();
158
159
160
161
162
163
    if ($user->uid) {
      $user->roles[DRUPAL_AUTHENTICATED_RID] = 'authenticated user';
    }
    else {
      $user->roles[DRUPAL_ANONYMOUS_RID] = 'anonymous user';
    }
164
165
166
167
    $result = db_query('SELECT r.rid, r.name FROM {role} r INNER JOIN {users_roles} ur ON ur.rid = r.rid WHERE ur.uid = %d', $user->uid);
    while ($role = db_fetch_object($result)) {
      $user->roles[$role->rid] = $role->name;
    }
168
    user_module_invoke('load', $array, $user);
169
170
  }
  else {
171
    $user = FALSE;
Dries Buytaert's avatar
   
Dries Buytaert committed
172
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
173
174
175
176

  return $user;
}

177
/**
178
 * Save changes to a user account or add a new user.
179
180
 *
 * @param $account
181
182
 *   The $user object for the user to modify or add. If $user->uid is
 *   omitted, a new user will be added.
183
184
185
 *
 * @param $array
 *   An array of fields and values to save. For example array('name' => 'My name');
186
 *   Setting a field to NULL deletes it from the data column.
187
188
189
190
 *
 * @param $category
 *   (optional) The category for storing profile information in.
 */
191
function user_save($account, $array = array(), $category = 'account') {
192
  // Dynamically compose a SQL query:
193
  $user_fields = user_fields();
194
  if (is_object($account) && $account->uid) {
195
    user_module_invoke('update', $array, $account, $category);
196
    $query = '';
197
    $data = unserialize(db_result(db_query('SELECT data FROM {users} WHERE uid = %d', $account->uid)));
Dries Buytaert's avatar
   
Dries Buytaert committed
198
    foreach ($array as $key => $value) {
199
      if ($key == 'pass' && !empty($value)) {
Dries Buytaert's avatar
   
Dries Buytaert committed
200
201
        $query .= "$key = '%s', ";
        $v[] = md5($value);
Dries Buytaert's avatar
   
Dries Buytaert committed
202
      }
203
      else if ((substr($key, 0, 4) !== 'auth') && ($key != 'pass')) {
204
        if (in_array($key, $user_fields)) {
205
          // Save standard fields
Dries Buytaert's avatar
   
Dries Buytaert committed
206
207
          $query .= "$key = '%s', ";
          $v[] = $value;
Dries Buytaert's avatar
   
Dries Buytaert committed
208
        }
Dries Buytaert's avatar
   
Dries Buytaert committed
209
        else if ($key != 'roles') {
210
          // Roles is a special case: it used below.
211
          if ($value === NULL) {
212
213
214
215
216
            unset($data[$key]);
          }
          else {
            $data[$key] = $value;
          }
Dries Buytaert's avatar
   
Dries Buytaert committed
217
        }
Dries Buytaert's avatar
   
Dries Buytaert committed
218
219
      }
    }
220
    $query .= "data = '%s' ";
Dries Buytaert's avatar
   
Dries Buytaert committed
221
    $v[] = serialize($data);
Dries Buytaert's avatar
   
Dries Buytaert committed
222

223
    db_query("UPDATE {users} SET $query WHERE uid = %d", array_merge($v, array($account->uid)));
Dries Buytaert's avatar
   
Dries Buytaert committed
224

225
    // Reload user roles if provided
226
    if (isset($array['roles']) && is_array($array['roles'])) {
227
      db_query('DELETE FROM {users_roles} WHERE uid = %d', $account->uid);
Dries Buytaert's avatar
   
Dries Buytaert committed
228

229
      foreach (array_keys($array['roles']) as $rid) {
230
231
232
        if (!in_array($rid, array(DRUPAL_ANONYMOUS_RID, DRUPAL_AUTHENTICATED_RID))) {
          db_query('INSERT INTO {users_roles} (uid, rid) VALUES (%d, %d)', $account->uid, $rid);
        }
233
      }
Dries Buytaert's avatar
   
Dries Buytaert committed
234
235
    }

236
    // Delete a blocked user's sessions to kick them if they are online.
237
    if (isset($array['status']) && $array['status'] == 0) {
238
      sess_destroy_uid($account->uid);
239
240
    }

241
242
    // If the password changed, delete all open sessions and recreate
    // the current one.
243
    if (!empty($array['pass'])) {
244
245
246
247
      sess_destroy_uid($account->uid);
      sess_regenerate();
    }

248
    // Refresh user object
Dries Buytaert's avatar
   
Dries Buytaert committed
249
    $user = user_load(array('uid' => $account->uid));
250
251
252
253
254
255
256
257

    // Send emails after we have the new user object.
    if (isset($array['status']) && $array['status'] != $account->status) {
      // The user's status is changing, conditionally send notification email.
      $op = $array['status'] == 1 ? 'status_activated' : 'status_blocked';
      _user_mail_notify($op, $user);
    }

258
    user_module_invoke('after_update', $array, $user, $category);
Dries Buytaert's avatar
   
Dries Buytaert committed
259
260
  }
  else {
261
    if (!isset($array['created'])) {    // Allow 'created' to be set by the caller
262
263
264
      $array['created'] = time();
    }

265
266
267
    // Note, we wait with saving the data column to prevent module-handled
    // fields from being saved there. We cannot invoke hook_user('insert') here
    // because we don't have a fully initialized user object yet.
Dries Buytaert's avatar
   
Dries Buytaert committed
268
    foreach ($array as $key => $value) {
269
      switch ($key) {
270
271
272
        case 'pass':
          $fields[] = $key;
          $values[] = md5($value);
Dries Buytaert's avatar
   
Dries Buytaert committed
273
          $s[] = "'%s'";
274
          break;
275
        case 'mode':       case 'sort':     case 'timezone':
276
277
278
279
280
281
282
283
284
285
286
287
288
        case 'threshold':  case 'created':  case 'access':
        case 'login':      case 'status':
          $fields[] = $key;
          $values[] = $value;
          $s[] = "%d";
          break;
        default:
          if (substr($key, 0, 4) !== 'auth' && in_array($key, $user_fields)) {
            $fields[] = $key;
            $values[] = $value;
            $s[] = "'%s'";
          }
          break;
Dries Buytaert's avatar
   
Dries Buytaert committed
289
290
      }
    }
291
    db_query('INSERT INTO {users} ('. implode(', ', $fields) .') VALUES ('. implode(', ', $s) .')', $values);
292
    $array['uid'] = db_last_insert_id('users', 'uid');
Dries Buytaert's avatar
   
Dries Buytaert committed
293

294
295
    // Build the initial user object.
    $user = user_load(array('uid' => $array['uid']));
Dries Buytaert's avatar
   
Dries Buytaert committed
296

297
298
299
300
301
    user_module_invoke('insert', $array, $user, $category);

    // Build and save the serialized data field now
    $data = array();
    foreach ($array as $key => $value) {
302
      if ((substr($key, 0, 4) !== 'auth') && ($key != 'roles') && (!in_array($key, $user_fields)) && ($value !== NULL)) {
303
304
305
306
307
        $data[$key] = $value;
      }
    }
    db_query("UPDATE {users} SET data = '%s' WHERE uid = %d", serialize($data), $user->uid);

308
    // Save user roles (delete just to be safe).
309
    if (isset($array['roles']) && is_array($array['roles'])) {
310
311
312
313
314
      db_query('DELETE FROM {users_roles} WHERE uid = %d', $array['uid']);
      foreach (array_keys($array['roles']) as $rid) {
        if (!in_array($rid, array(DRUPAL_ANONYMOUS_RID, DRUPAL_AUTHENTICATED_RID))) {
          db_query('INSERT INTO {users_roles} (uid, rid) VALUES (%d, %d)', $array['uid'], $rid);
        }
315
316
317
      }
    }

318
319
    // Build the finished user object.
    $user = user_load(array('uid' => $array['uid']));
Dries Buytaert's avatar
   
Dries Buytaert committed
320
321
  }

322
  // Save distributed authentication mappings
323
  $authmaps = array();
Dries Buytaert's avatar
   
Dries Buytaert committed
324
  foreach ($array as $key => $value) {
Dries Buytaert's avatar
   
Dries Buytaert committed
325
    if (substr($key, 0, 4) == 'auth') {
Dries Buytaert's avatar
   
Dries Buytaert committed
326
327
328
      $authmaps[$key] = $value;
    }
  }
329
  if (sizeof($authmaps) > 0) {
Dries Buytaert's avatar
   
Dries Buytaert committed
330
    user_set_authmaps($user, $authmaps);
Dries Buytaert's avatar
   
Dries Buytaert committed
331
332
333
334
335
  }

  return $user;
}

336
337
338
/**
 * Verify the syntax of the given name.
 */
Dries Buytaert's avatar
   
Dries Buytaert committed
339
function user_validate_name($name) {
340
  if (!strlen($name)) return t('You must enter a username.');
341
342
  if (substr($name, 0, 1) == ' ') return t('The username cannot begin with a space.');
  if (substr($name, -1) == ' ') return t('The username cannot end with a space.');
343
  if (strpos($name, '  ') !== FALSE) return t('The username cannot contain multiple spaces in a row.');
344
  if (ereg("[^\x80-\xF7 [:alnum:]@_.-]", $name)) return t('The username contains an illegal character.');
345
346
347
348
349
350
351
  if (preg_match('/[\x{80}-\x{A0}'.          // Non-printable ISO-8859-1 + NBSP
                   '\x{AD}'.                 // Soft-hyphen
                   '\x{2000}-\x{200F}'.      // Various space characters
                   '\x{2028}-\x{202F}'.      // Bidirectional text overrides
                   '\x{205F}-\x{206F}'.      // Various text hinting characters
                   '\x{FEFF}'.               // Byte order mark
                   '\x{FF01}-\x{FF60}'.      // Full-width latin
352
353
                   '\x{FFF9}-\x{FFFD}'.      // Replacement characters
                   '\x{0}]/u',               // NULL byte
354
355
356
                   $name)) {
    return t('The username contains an illegal character.');
  }
357
  if (strpos($name, '@') !== FALSE && !eregi('@([0-9a-z](-?[0-9a-z])*.)+[a-z]{2}([zmuvtg]|fo|me)?$', $name)) return t('The username is not a valid authentication ID.');
358
  if (strlen($name) > USERNAME_MAX_LENGTH) return t('The username %name is too long: it must be %max characters or less.', array('%name' => $name, '%max' => USERNAME_MAX_LENGTH));
Dries Buytaert's avatar
   
Dries Buytaert committed
359
360
361
}

function user_validate_mail($mail) {
362
  if (!$mail) return t('You must enter an e-mail address.');
363
  if (!valid_email_address($mail)) {
364
    return t('The e-mail address %mail is not valid.', array('%mail' => $mail));
Dries Buytaert's avatar
   
Dries Buytaert committed
365
366
367
  }
}

368
function user_validate_picture(&$form, &$form_state) {
369
  // If required, validate the uploaded picture.
370
371
372
373
374
375
376
  $validators = array(
    'file_validate_is_image' => array(),
    'file_validate_image_resolution' => array(variable_get('user_picture_dimensions', '85x85')),
    'file_validate_size' => array(variable_get('user_picture_file_size', '30') * 1024),
  );
  if ($file = file_save_upload('picture_upload', $validators)) {
    // The image was saved using file_save_upload() and was added to the
377
    // files table as a temporary file. We'll make a copy and let the garbage
378
    // collector delete the original upload.
379
    $info = image_get_info($file->filepath);
380
381
    $destination = variable_get('user_picture_path', 'pictures') .'/picture-'. $form['#uid'] .'.'. $info['extension'];
    if (file_copy($file, $destination, FILE_EXISTS_REPLACE)) {
382
      $form_state['values']['picture'] = $file->filepath;
383
    }
384
385
    else {
      form_set_error('picture_upload', t("Failed to upload the picture image; the %directory directory doesn't exist or is not writable.", array('%directory' => variable_get('user_picture_path', 'pictures'))));
386
    }
Dries Buytaert's avatar
   
Dries Buytaert committed
387
388
389
  }
}

390
391
392
/**
 * Generate a random alphanumeric password.
 */
Dries Buytaert's avatar
   
Dries Buytaert committed
393
394
function user_password($length = 10) {
  // This variable contains the list of allowable characters for the
395
396
  // password. Note that the number 0 and the letter 'O' have been
  // removed to avoid confusion between the two. The same is true
397
398
  // of 'I', 1, and l.
  $allowable_characters = 'abcdefghijkmnopqrstuvwxyzABCDEFGHJKLMNPQRSTUVWXYZ23456789';
399

400
401
  // Zero-based count of characters in the allowable list:
  $len = strlen($allowable_characters) - 1;
Dries Buytaert's avatar
   
Dries Buytaert committed
402

403
404
  // Declare the password as a blank string.
  $pass = '';
Dries Buytaert's avatar
   
Dries Buytaert committed
405

406
  // Loop the number of times specified by $length.
Dries Buytaert's avatar
   
Dries Buytaert committed
407
408
409
410
  for ($i = 0; $i < $length; $i++) {

    // Each iteration, pick a random character from the
    // allowable string and append it to the password:
411
    $pass .= $allowable_characters[mt_rand(0, $len)];
Dries Buytaert's avatar
   
Dries Buytaert committed
412
413
414
  }

  return $pass;
Dries Buytaert's avatar
   
Dries Buytaert committed
415
416
}

417
418
419
420
421
/**
 * Determine whether the user has a given privilege.
 *
 * @param $string
 *   The permission, such as "administer nodes", being checked for.
Dries Buytaert's avatar
   
Dries Buytaert committed
422
423
 * @param $account
 *   (optional) The account to check, if not given use currently logged in user.
424
425
 *
 * @return
426
 *   boolean TRUE if the current user has the requested permission.
427
428
429
430
431
 *
 * All permission checks in Drupal should go through this function. This
 * way, we guarantee consistent behavior, and ensure that the superuser
 * can perform all actions.
 */
Dries Buytaert's avatar
   
Dries Buytaert committed
432
function user_access($string, $account = NULL) {
Dries Buytaert's avatar
   
Dries Buytaert committed
433
  global $user;
Dries Buytaert's avatar
   
Dries Buytaert committed
434
  static $perm = array();
Dries Buytaert's avatar
   
Dries Buytaert committed
435

436
437
438
439
  if (is_null($account)) {
    $account = $user;
  }

440
  // User #1 has all privileges:
441
  if ($account->uid == 1) {
442
    return TRUE;
Dries Buytaert's avatar
   
Dries Buytaert committed
443
444
  }

445
446
  // To reduce the number of SQL queries, we cache the user's permissions
  // in a static variable.
447
  if (!isset($perm[$account->uid])) {
448
    $result = db_query("SELECT DISTINCT(p.perm) FROM {role} r INNER JOIN {permission} p ON p.rid = r.rid WHERE r.rid IN (%s)", implode(',', array_keys($account->roles)));
Dries Buytaert's avatar
   
Dries Buytaert committed
449

Steven Wittens's avatar
Steven Wittens committed
450
    $perm[$account->uid] = '';
Dries Buytaert's avatar
   
Dries Buytaert committed
451
    while ($row = db_fetch_object($result)) {
452
      $perm[$account->uid] .= "$row->perm, ";
Dries Buytaert's avatar
   
Dries Buytaert committed
453
    }
Dries Buytaert's avatar
   
Dries Buytaert committed
454
  }
455

456
  if (isset($perm[$account->uid])) {
457
    return strpos($perm[$account->uid], "$string, ") !== FALSE;
458
  }
459

460
  return FALSE;
Dries Buytaert's avatar
   
Dries Buytaert committed
461
462
}

463
464
465
/**
 * Checks for usernames blocked by user administration
 *
466
 * @return boolean TRUE for blocked users, FALSE for active
467
468
 */
function user_is_blocked($name) {
469
  $deny  = db_fetch_object(db_query("SELECT name FROM {users} WHERE status = 0 AND name = LOWER('%s')", $name));
470

471
  return $deny;
472
473
}

Dries Buytaert's avatar
   
Dries Buytaert committed
474
475
function user_fields() {
  static $fields;
Dries Buytaert's avatar
   
Dries Buytaert committed
476

Dries Buytaert's avatar
   
Dries Buytaert committed
477
  if (!$fields) {
478
    $result = db_query('SELECT * FROM {users} WHERE uid = 1');
479
480
    if ($field = db_fetch_array($result)) {
      $fields = array_keys($field);
481
    }
Dries Buytaert's avatar
   
Dries Buytaert committed
482
483
    else {
      // Make sure we return the default fields at least
484
      $fields = array('uid', 'name', 'pass', 'mail', 'picture', 'mode', 'sort', 'threshold', 'theme', 'signature', 'created', 'access', 'login', 'status', 'timezone', 'language', 'init', 'data');
Dries Buytaert's avatar
   
Dries Buytaert committed
485
    }
Dries Buytaert's avatar
   
Dries Buytaert committed
486
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
487

Dries Buytaert's avatar
   
Dries Buytaert committed
488
  return $fields;
Dries Buytaert's avatar
   
Dries Buytaert committed
489
490
}

491
492
493
/**
 * Implementation of hook_perm().
 */
Dries Buytaert's avatar
   
Dries Buytaert committed
494
function user_perm() {
495
  return array('administer access control', 'administer users', 'access user profiles', 'change own username');
Dries Buytaert's avatar
   
Dries Buytaert committed
496
497
}

498
499
500
501
502
/**
 * Implementation of hook_file_download().
 *
 * Ensure that user pictures (avatars) are always downloadable.
 */
Dries Buytaert's avatar
   
Dries Buytaert committed
503
function user_file_download($file) {
Steven Wittens's avatar
Steven Wittens committed
504
  if (strpos($file, variable_get('user_picture_path', 'pictures') .'/picture-') === 0) {
505
506
    $info = image_get_info(file_create_path($file));
    return array('Content-type: '. $info['mime_type']);
Dries Buytaert's avatar
   
Dries Buytaert committed
507
508
509
  }
}

510
511
512
/**
 * Implementation of hook_search().
 */
513
function user_search($op = 'search', $keys = NULL, $skip_access_check = FALSE) {
514
515
  switch ($op) {
    case 'name':
516
      if ($skip_access_check || user_access('access user profiles')) {
517
        return t('Users');
518
      }
519
    case 'search':
520
521
522
523
      if (user_access('access user profiles')) {
        $find = array();
        // Replace wildcards with MySQL/PostgreSQL wildcards.
        $keys = preg_replace('!\*+!', '%', $keys);
524
525
526
527
        if (user_access('administer users')) {
          // Administrators can also search in the otherwise private email field.
          $result = pager_query("SELECT name, uid, mail FROM {users} WHERE LOWER(name) LIKE LOWER('%%%s%%') OR LOWER(mail) LIKE LOWER('%%%s%%')", 15, 0, NULL, $keys, $keys);
          while ($account = db_fetch_object($result)) {
528
            $find[] = array('title' => $account->name .' ('. $account->mail .')', 'link' => url('user/'. $account->uid, array('absolute' => TRUE)));
529
530
531
          }
        }
        else {
532
          $result = pager_query("SELECT name, uid FROM {users} WHERE LOWER(name) LIKE LOWER('%%%s%%')", 15, 0, NULL, $keys);
533
          while ($account = db_fetch_object($result)) {
534
            $find[] = array('title' => $account->name, 'link' => url('user/'. $account->uid, array('absolute' => TRUE)));
535
          }
536
537
        }
        return $find;
538
      }
Dries Buytaert's avatar
   
Dries Buytaert committed
539
540
541
  }
}

542
543
544
545
546
547
548
549
550
551
/**
 * Implementation of hook_elements().
 */
function user_elements() {
  return array(
    'user_profile_category' => array(),
    'user_profile_item' => array(),
  );
}

552
553
554
/**
 * Implementation of hook_user().
 */
555
function user_user($type, &$edit, &$account, $category = NULL) {
556
  if ($type == 'view') {
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
    $account->content['user_picture'] = array(
      '#value' => theme('user_picture', $account),
      '#weight' => -10,
    );
    if (!isset($account->content['summary'])) {
      $account->content['summary'] = array();
    }
    $account->content['summary'] += array(
      '#type' => 'user_profile_category',
      '#attributes' => array('class' => 'user-member'),
      '#weight' => -5,
      '#title' => t('History'),
    );
    $account->content['summary']['member_for'] =  array(
      '#type' => 'user_profile_item',
      '#title' => t('Member for'),
      '#value' => format_interval(time() - $account->created),
574
    );
575
  }
576
  if ($type == 'form' && $category == 'account') {
577
578
    $form_state = array();
    return user_edit_form($form_state, arg(1), $edit);
579
580
581
  }

  if ($type == 'validate' && $category == 'account') {
582
    return _user_edit_validate(arg(1), $edit);
583
584
  }

585
586
587
588
  if ($type == 'submit' && $category == 'account') {
    return _user_edit_submit(arg(1), $edit);
  }

589
  if ($type == 'categories') {
590
    return array(array('name' => 'account', 'title' => t('Account settings'), 'weight' => 1));
591
  }
592
593
}

594
595
function user_login_block() {
  $form = array(
596
    '#action' => url($_GET['q'], array('query' => drupal_get_destination())),
597
    '#id' => 'user-login-form',
598
    '#validate' => user_login_default_validators(),
599
    '#submit' => array('user_login_submit'),
600
601
602
  );
  $form['name'] = array('#type' => 'textfield',
    '#title' => t('Username'),
603
    '#maxlength' => USERNAME_MAX_LENGTH,
604
605
606
607
608
    '#size' => 15,
    '#required' => TRUE,
  );
  $form['pass'] = array('#type' => 'password',
    '#title' => t('Password'),
609
    '#maxlength' => 60,
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
    '#size' => 15,
    '#required' => TRUE,
  );
  $form['submit'] = array('#type' => 'submit',
    '#value' => t('Log in'),
  );
  $items = array();
  if (variable_get('user_register', 1)) {
    $items[] = l(t('Create new account'), 'user/register', array('title' => t('Create a new user account.')));
  }
  $items[] = l(t('Request new password'), 'user/password', array('title' => t('Request new password via e-mail.')));
  $form['links'] = array('#value' => theme('item_list', $items));
  return $form;
}

625
626
627
/**
 * Implementation of hook_block().
 */
628
function user_block($op = 'list', $delta = 0, $edit = array()) {
Dries Buytaert's avatar
   
Dries Buytaert committed
629
630
  global $user;

631
632
  if ($op == 'list') {
     $blocks[0]['info'] = t('User login');
633
634
635
     // Not worth caching.
     $blocks[0]['cache'] = BLOCK_NO_CACHE;

636
     $blocks[1]['info'] = t('Navigation');
637
638
639
640
      // Menu blocks can't be cached because each menu item can have
      // a custom access callback. menu.inc manages its own caching.
     $blocks[1]['cache'] = BLOCK_NO_CACHE;

641
     $blocks[2]['info'] = t('Who\'s new');
642

643
644
645
     // Too dynamic to cache.
     $blocks[3]['info'] = t('Who\'s online');
     $blocks[3]['cache'] = BLOCK_NO_CACHE;
646
     return $blocks;
647
  }
648
649
650
651
652
653
654
655
656
  else if ($op == 'configure' && $delta == 2) {
    $form['user_block_whois_new_count'] = array(
      '#type' => 'select',
      '#title' => t('Number of users to display'),
      '#default_value' => variable_get('user_block_whois_new_count', 5),
      '#options' => drupal_map_assoc(array(1, 2, 3, 4, 5, 6, 7, 8, 9, 10)),
    );
    return $form;
  }
657
658
  else if ($op == 'configure' && $delta == 3) {
    $period = drupal_map_assoc(array(30, 60, 120, 180, 300, 600, 900, 1800, 2700, 3600, 5400, 7200, 10800, 21600, 43200, 86400), 'format_interval');
659
660
    $form['user_block_seconds_online'] = array('#type' => 'select', '#title' => t('User activity'), '#default_value' => variable_get('user_block_seconds_online', 900), '#options' => $period, '#description' => t('A user is considered online for this long after they have last viewed a page.'));
    $form['user_block_max_list_count'] = array('#type' => 'select', '#title' => t('User list length'), '#default_value' => variable_get('user_block_max_list_count', 10), '#options' => drupal_map_assoc(array(0, 5, 10, 15, 20, 25, 30, 40, 50, 75, 100)), '#description' => t('Maximum number of currently online users to display.'));
661

662
    return $form;
663
  }
664
665
666
  else if ($op == 'save' && $delta == 2) {
    variable_set('user_block_whois_new_count', $edit['user_block_whois_new_count']);
  }
667
668
669
670
671
  else if ($op == 'save' && $delta == 3) {
    variable_set('user_block_seconds_online', $edit['user_block_seconds_online']);
    variable_set('user_block_max_list_count', $edit['user_block_max_list_count']);
  }
  else if ($op == 'view') {
Dries Buytaert's avatar
   
Dries Buytaert committed
672
673
    $block = array();

Dries Buytaert's avatar
   
Dries Buytaert committed
674
675
    switch ($delta) {
      case 0:
Dries Buytaert's avatar
Dries Buytaert committed
676
677
        // For usability's sake, avoid showing two login forms on one page.
        if (!$user->uid && !(arg(0) == 'user' && !is_numeric(arg(1)))) {
Dries Buytaert's avatar
   
Dries Buytaert committed
678

679
          $block['subject'] = t('User login');
680
          $block['content'] = drupal_get_form('user_login_block');
Dries Buytaert's avatar
   
Dries Buytaert committed
681
        }
Dries Buytaert's avatar
Dries Buytaert committed
682
        return $block;
Dries Buytaert's avatar
Dries Buytaert committed
683

684
      case 1:
685
        if ($menu = menu_tree()) {
Dries Buytaert's avatar
Dries Buytaert committed
686
           $block['subject'] = $user->uid ? check_plain($user->name) : t('Navigation');
687
           $block['content'] = $menu;
Dries Buytaert's avatar
   
Dries Buytaert committed
688
        }
689
        return $block;
Dries Buytaert's avatar
Dries Buytaert committed
690

Dries Buytaert's avatar
   
Dries Buytaert committed
691
      case 2:
692
        if (user_access('access content')) {
Steven Wittens's avatar
Steven Wittens committed
693
          // Retrieve a list of new users who have subsequently accessed the site successfully.
694
          $result = db_query_range('SELECT uid, name FROM {users} WHERE status != 0 AND access != 0 ORDER BY created DESC', 0, variable_get('user_block_whois_new_count', 5));
695
          while ($account = db_fetch_object($result)) {
696
            $items[] = $account;
697
          }
698
          $output = theme('user_list', $items);
Dries Buytaert's avatar
   
Dries Buytaert committed
699

700
701
          $block['subject'] = t('Who\'s new');
          $block['content'] = $output;
702
        }
Dries Buytaert's avatar
Dries Buytaert committed
703
704
        return $block;

Dries Buytaert's avatar
   
Dries Buytaert committed
705
      case 3:
706
        if (user_access('access content')) {
707
          // Count users active within the defined period.
708
          $interval = time() - variable_get('user_block_seconds_online', 900);
709

710
          // Perform database queries to gather online user lists.  We use s.timestamp
711
          // rather than u.access because it is much faster.
712
          $anonymous_count = sess_count($interval);
713
          $authenticated_users = db_query('SELECT DISTINCT u.uid, u.name, s.timestamp FROM {users} u INNER JOIN {sessions} s ON u.uid = s.uid WHERE s.timestamp >= %d AND s.uid > 0 ORDER BY s.timestamp DESC', $interval);
714
715
716
717
718
719
720
721
722
723
          $authenticated_count = 0;
          $max_users = variable_get('user_block_max_list_count', 10);
          $items = array();
          while ($account = db_fetch_object($authenticated_users)) {
            if ($max_users > 0) {
              $items[] = $account;
              $max_users--;
            }
            $authenticated_count++;
          }
Dries Buytaert's avatar
   
Dries Buytaert committed
724

725
          // Format the output with proper grammar.
726
727
          if ($anonymous_count == 1 && $authenticated_count == 1) {
            $output = t('There is currently %members and %visitors online.', array('%members' => format_plural($authenticated_count, '1 user', '@count users'), '%visitors' => format_plural($anonymous_count, '1 guest', '@count guests')));
Dries Buytaert's avatar
   
Dries Buytaert committed
728
729
          }
          else {
730
            $output = t('There are currently %members and %visitors online.', array('%members' => format_plural($authenticated_count, '1 user', '@count users'), '%visitors' => format_plural($anonymous_count, '1 guest', '@count guests')));
Dries Buytaert's avatar
   
Dries Buytaert committed
731
732
          }

733
734
          // Display a list of currently online users.
          $max_users = variable_get('user_block_max_list_count', 10);
735
          if ($authenticated_count && $max_users) {
736
737
            $output .= theme('user_list', $items, t('Online users'));
          }
738

739
740
          $block['subject'] = t('Who\'s online');
          $block['content'] = $output;
Dries Buytaert's avatar
   
Dries Buytaert committed
741
        }
Dries Buytaert's avatar
   
Dries Buytaert committed
742
        return $block;
Dries Buytaert's avatar
   
Dries Buytaert committed
743
744
    }
  }
745
746
}

747
748
749
750
751
752
753
754
755
756
/**
 * Process variables for user-picture.tpl.php.
 *
 * The $variables array contains the following arguments:
 * - $account
 *
 * @see user-picture.tpl.php
 */
function template_preprocess_user_picture(&$variables) {
  $variables['picture'] = '';
Dries Buytaert's avatar
   
Dries Buytaert committed
757
  if (variable_get('user_pictures', 0)) {
758
    $account = $variables['account'];
759
    if (!empty($account->picture) && file_exists($account->picture)) {
Dries Buytaert's avatar
   
Dries Buytaert committed
760
761
762
763
764
765
      $picture = file_create_url($account->picture);
    }
    else if (variable_get('user_picture_default', '')) {
      $picture = variable_get('user_picture_default', '');
    }

766
    if (isset($picture)) {
767
      $alt = t("@user's picture", array('@user' => $account->name ? $account->name : variable_get('anonymous', t('Anonymous'))));
768
      $variables['picture'] = theme('image', $picture, $alt, $alt, '', FALSE);
769
      if (!empty($account->uid) && user_access('access user profiles')) {
770
771
        $attributes = array('attributes' => array('title' => t('View user profile.')), 'html' => TRUE);
        $variables['picture'] = l($variables['picture'], "user/$account->uid", $attributes);
Dries Buytaert's avatar
   
Dries Buytaert committed
772
773
774
775
776
      }
    }
  }
}

777
778
/**
 * Make a list of users.
779
780
781
782
783
 *
 * @param $users
 *   An array with user objects. Should contain at least the name and uid.
 * @param $title
 *  (optional) Title to pass on to theme_item_list().
784
785
786
787
 *
 * @ingroup themeable
 */
function theme_user_list($users, $title = NULL) {
788
789
790
791
  if (!empty($users)) {
    foreach ($users as $user) {
      $items[] = theme('username', $user);
    }
792
  }
793
  return theme('item_list', $items, $title);
Dries Buytaert's avatar
   
Dries Buytaert committed
794
795
}

796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
/**
 * Process variables for user-profile.tpl.php.
 *
 * The $variables array contains the following arguments:
 * - $account
 *
 * @see user-picture.tpl.php
 */
function template_preprocess_user_profile(&$variables) {
  $variables['profile'] = array();
  // Provide keyed variables so themers can print each section independantly.
  foreach (element_children($variables['account']->content) as $key) {
    $variables['profile'][$key] = drupal_render($variables['account']->content[$key]);
  }
  // Collect all profiles to make it easier to print all items at once.
  $variables['user_profile'] = implode($variables['profile']);
}

/**
 * Process variables for user-profile-item.tpl.php.
 *
 * The $variables array contains the following arguments:
 * - $element
 *
 * @see user-profile-item.tpl.php
 */
function template_preprocess_user_profile_item(&$variables) {
  $variables['title'] = $variables['element']['#title'];
  $variables['value'] = $variables['element']['#value'];
  $variables['attributes'] = '';
  if (isset($variables['element']['#attributes'])) {
    $variables['attributes'] = drupal_attributes($variables['element']['#attributes']);
  }
}

/**
 * Process variables for user-profile-category.tpl.php.
 *
 * The $variables array contains the following arguments:
 * - $element
 *
 * @see user-profile-category.tpl.php
 */
function template_preprocess_user_profile_category(&$variables) {
  $variables['title'] = $variables['element']['#title'];
  $variables['profile_items'] = $variables['element']['#children'];
  $variables['attributes'] = '';
  if (isset($variables['element']['#attributes'])) {
    $variables['attributes'] = drupal_attributes($variables['element']['#attributes']);
  }
}

848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
function user_is_anonymous() {
  return !$GLOBALS['user']->uid;
}

function user_is_logged_in() {
  return (bool)$GLOBALS['user']->uid;
}

function user_register_access() {
  return !$GLOBALS['user']->uid && variable_get('user_register', 1);
}

function user_view_access($account) {
  return $account && $account->uid &&
    (
      // Always let users view their own profile.
      ($GLOBALS['user']->uid == $account->uid) ||
      // Administrators can view all accounts.
      user_access('administer users') ||
      // The user is not blocked and logged in at least once.
      ($account->access && $account->status && user_access('access user profiles'))
    );
}

872
function user_edit_access($account) {
873
  return ($GLOBALS['user']->uid == $account->uid) || user_access('administer users');
874
875
876
877
878
879
880
}

function user_load_self($arg) {
  $arg[1] = user_load($GLOBALS['user']->uid);
  return $arg;
}

Dries Buytaert's avatar
   
Dries Buytaert committed
881
/**
Dries Buytaert's avatar
   
Dries Buytaert committed
882
 * Implementation of hook_menu().
Dries Buytaert's avatar
   
Dries Buytaert committed
883
 */
884
885
function user_menu() {
  $items['user/autocomplete'] = array(
886
    'title' => 'User autocomplete',
887
    'page callback' => 'user_autocomplete',
888
    'access callback' => 'user_access',
889
890
891
    'access arguments' => array('access user profiles'),
    'type' => MENU_CALLBACK,
  );
Dries Buytaert's avatar
   
Dries Buytaert committed
892

893
  // Registration and login pages.
894
  $items['user'] = array(
895
    'title' => 'Log in',
896
897
    'page callback' => 'user_page',
    'access callback' => TRUE,
898
    'type' => MENU_CALLBACK,
899
900
901
  );

  $items['user/login'] = array(
902
    'title' => 'Log in',
903
904
    'type' => MENU_DEFAULT_LOCAL_TASK,
  );
Dries Buytaert's avatar
   
Dries Buytaert committed
905

906
  $items['user/register'] = array(
907
    'title' => 'Create new account',
908
909
910
911
912
913
914
    'page callback' => 'drupal_get_form',
    'page arguments' => array('user_register'),
    'access callback' => 'user_register_access',
    'type' => MENU_LOCAL_TASK,
  );

  $items['user/password'] = array(
915
    'title' => 'Request new password',
916
917
    'page callback' => 'drupal_get_form',
    'page arguments' => array('user_pass'),
918
    'access callback' => 'user_is_anonymous',
919
920
921
    'type' => MENU_LOCAL_TASK,
  );
  $items['user/reset/%/%/%'] = array(
922
    'title' => 'Reset password',
923
924
925
926
927
928
929
930
    'page callback' => 'drupal_get_form',
    'page arguments' => array('user_pass_reset', 2, 3, 4),
    'access callback' => TRUE,
    'type' => MENU_CALLBACK,
  );

  // Admin user pages
  $items['admin/user'] = array(
931
932
    'title' => 'User management',
    'description' => "Manage your site's users, groups and access to site features.",
933
934
935
    'position' => 'left',
    'page callback' => 'system_admin_menu_block_page',
    'access arguments' => array('administer site configuration'),
936
937
    'file' => 'system.admin.inc',
    'file path' => drupal_get_path('module', 'system'),
938
939
  );
  $items['admin/user/user'] = array(
940
941
    'title' => 'Users',
    'description' => 'List, add, and edit users.',
942
943
944
945
    'page callback' => 'user_admin',
    'page arguments' => array('list'),
    'access arguments' => array('administer users'));
  $items['admin/user/user/list'] = array(
946
    'title' => 'List',
947
948
949
950
    'type' => MENU_DEFAULT_LOCAL_TASK,
    'weight' => -10,
  );
  $items['admin/user/user/create'] = array(
951
    'title' => 'Add user',
952
953
954
955
    'page arguments' => array('create'),
    'type' => MENU_LOCAL_TASK,
  );
  $items['admin/user/settings'] = array(