function hook_user_load

7.x user.api.php hook_user_load($users)

Act on user objects when loaded from the database.

Due to the static cache in user_load_multiple() you should not use this hook to modify the user properties returned by the {users} table itself since this may result in unreliable results when loading from cache.

Parameters

$users: An array of user objects, indexed by uid.

See also

user_load_multiple()

profile_user_load()

Related topics

2 functions implement hook_user_load()

Note: this list is generated by pattern matching, so it may include some functions that are not actually implementations of this hook.

entity_crud_hook_test_user_load in drupal/modules/simpletest/tests/entity_crud_hook_test.module
Implements hook_user_load().
profile_user_load in drupal/modules/profile/profile.module
Implements hook_user_load().
2 invocations of hook_user_load()
field_attach_load in drupal/modules/field/field.attach.inc
Loads fields for the current revisions of a group of entities.
node_preview in drupal/modules/node/node.pages.inc
Generates a node preview.

File

drupal/modules/user/user.api.php, line 26
Hooks provided by the User module.

Code

function hook_user_load($users) {
  $result = db_query('SELECT uid, foo FROM {my_table} WHERE uid IN (:uids)', array(':uids' => array_keys($users)));
  foreach ($result as $record) {
    $users[$record->uid]->foo = $record->foo;
  }
}