You are here

Home » API reference » Drupal 7 » user.api.php

function hook_user_view_alter in Drupal 7

The user was built; the module may modify the structured content.

This hook is called after the content has been assembled in a structured array and may be used for doing processing which requires that the complete user content structure has been built.

If the module wishes to act on the rendered HTML of the user rather than the structured content array, it may use this hook to add a #post_render callback. Alternatively, it could also implement hook_preprocess_user_profile(). See drupal_render() and theme() documentation respectively for details.

Parameters

$build: A renderable array representing the user.

See also

user_view()

hook_entity_view_alter()

Related topics

Hooks
Allow modules to interact with the Drupal core.

File

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

Code

function hook_user_view_alter(&$build) {

  // Check for the existence of a field added by another module.
  if (isset($build['an_additional_field'])) {

    // Change its weight.
    $build['an_additional_field']['#weight'] = -10;
  }

  // Add a #post_render callback to act on the rendered HTML of the user.
  $build['#post_render'][] = 'my_module_user_post_render';
}