Same name and namespace in other branches
  1. 4.6.x developer/hooks/node.php \hook_view()
  2. 4.7.x developer/hooks/node.php \hook_view()
  3. 6.x developer/hooks/node.php \hook_view()
  4. 7.x modules/node/node.api.php \hook_view()

Display a node.

This is a hook used by node modules. It allows a module to define a custom method of displaying its nodes, usually by displaying extra information particular to that node type.

Parameters

$node: The node to be displayed.

$teaser: Whether we are to generate a "teaser" or summary of the node, rather than display the whole thing.

$page: Whether the node is being displayed as a standalone page. If this is TRUE, the node title should not be displayed, as it will be printed automatically by the theme system. Also, the module may choose to alter the default breadcrumb trail in this case.

Return value

$node. The passed $node parameter should be modified as necessary and returned so it can be properly presented. Nodes are prepared for display by assembling a structured array in $node->content, rather than directly manipulating $node->body and $node->teaser. The format of this array is the same used by the Forms API. As with FormAPI arrays, the #weight property can be used to control the relative positions of added elements. If for some reason you need to change the body or teaser returned by node_prepare(), you can modify $node->content['body']['#value']. Note that this will be the un-rendered content. To modify the rendered output, see hook_nodeapi($op = 'alter').

For a detailed usage example, see node_example.module.

Related topics

12 functions implement hook_view()

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

aggregator_view in modules/aggregator/aggregator.module
blog_view in modules/blog/blog.module
Implementation of hook_view().
fileupload_view in developer/examples/fileupload.module
Implementation of hook_view.
forum_view in modules/forum/forum.module
Implementation of hook_view().
multipage_form_example_view in developer/examples/multipage_form_example.module
Implementation of hook_view().

... See full list

File

developer/hooks/node.php, line 418
These hooks are defined by node modules, modules that define a new kind of node.

Code

function hook_view($node, $teaser = FALSE, $page = FALSE) {
  if ($page) {
    $breadcrumb = array();
    $breadcrumb[] = array(
      'path' => 'example',
      'title' => t('example'),
    );
    $breadcrumb[] = array(
      'path' => 'example/' . $node->field1,
      'title' => t('%category', array(
        '%category' => $node->field1,
      )),
    );
    $breadcrumb[] = array(
      'path' => 'node/' . $node->nid,
    );
    menu_set_location($breadcrumb);
  }
  $node = node_prepare($node, $teaser);
  $node->content['myfield'] = array(
    '#value' => theme('mymodule_myfield', $node->myfield),
    '#weight' => 1,
  );
  return $node;
}