hook_link

Define internal Drupal links.

This hook enables modules to add links to many parts of Drupal. Links may be added in nodes or in the navigation block, for example.

Parameters

$type: An identifier declaring what kind of link is being requested. Possible values:

• node: Links to be placed below a node being viewed.
• comment: Links to be placed below a comment being viewed.

$node: A node object passed in case of node links.

$teaser: In case of node link: a 0/1 flag depending on whether the node is displayed with its teaser or its full form (on a node/nid page)

Return value

An array of the requested links.

For a detailed usage example, see node_example.module.

Related topics

Hooks

Allow modules to interact with the Drupal core.

12 functions implement hook_link()

5 invocations of hook_link()

File

developer/hooks/core.php, line 542

These are the hooks that are invoked by the Drupal core.

Code

function hook_link($type, $node = NULL, $teaser = FALSE) {
  $links = array();

  if ($type == 'node' && $node->type == 'book') {
    if (book_access('update', $node)) {
      $links[] = l(t('edit this page'), "node/$node->nid/edit", 
        array('title' => t('Suggest an update for this book page.')));
    }
    if (!$teaser) {
      $links[] = l(t('printer-friendly version'), "book/print/$node->nid", 
        array('title' => t('Show a printer-friendly version of this book page
        and its sub-pages.')));
    }
  }

  return $links;
}