function _book_update_outline

7.x book.module _book_update_outline($node)

Handles additions and updates to the book outline.

This common helper function performs all additions and updates to the book outline through node addition, node editing, node deletion, or the outline tab.


$node: The node that is being saved, added, deleted, or moved.

Return value

TRUE if the menu link was saved; FALSE otherwise.

4 calls to _book_update_outline()
book_node_delete in drupal/modules/book/book.module
Implements hook_node_delete().
book_node_insert in drupal/modules/book/book.module
Implements hook_node_insert().
book_node_update in drupal/modules/book/book.module
Implements hook_node_update().
book_outline_form_submit in drupal/modules/book/
Form submission handler for book_outline_form().


drupal/modules/book/book.module, line 626
Allows users to create and organize related content in an outline.


function _book_update_outline($node) {
  if (empty($node->book['bid'])) {
    return FALSE;
  $new = empty($node->book['mlid']);

  $node->book['link_path'] = 'node/' . $node->nid;
  $node->book['link_title'] = $node->title;
  $node->book['parent_mismatch'] = FALSE; // The normal case.

  if ($node->book['bid'] == $node->nid) {
    $node->book['plid'] = 0;
    $node->book['menu_name'] = book_menu_name($node->nid);
  else {
    // Check in case the parent is not is this book; the book takes precedence.
    if (!empty($node->book['plid'])) {
      $parent = db_query("SELECT * FROM {book} WHERE mlid = :mlid", array(
        ':mlid' => $node->book['plid'],
    if (empty($node->book['plid']) || !$parent || $parent['bid'] != $node->book['bid']) {
      $node->book['plid'] = db_query("SELECT mlid FROM {book} WHERE nid = :nid", array(
        ':nid' => $node->book['bid'],
      $node->book['parent_mismatch'] = TRUE; // Likely when JS is disabled.

  if (menu_link_save($node->book)) {
    if ($new) {
      // Insert new.
        'nid' => $node->nid,
        'mlid' => $node->book['mlid'],
        'bid' => $node->book['bid'],
      // Reset the cache of stored books.
    else {
      if ($node->book['bid'] != db_query("SELECT bid FROM {book} WHERE nid = :nid", array(
        ':nid' => $node->nid,
      ))->fetchField()) {
        // Update the bid for this page and all children.
        // Reset the cache of stored books.

    return TRUE;

  // Failed to save the menu link.
  return FALSE;