book.pages.inc 7.42 KB
Newer Older
1 2 3 4 5 6 7
<?php

/**
 * @file
 * User page callbacks for the book module.
 */

8
use Drupal\node\Plugin\Core\Entity\Node;
9
use Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException;
10
use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
11

12
/**
13 14
 * Page callback: Prints a listing of all books.
 *
15 16 17
 * @return string
 *   A HTML-formatted string with the listing of all books content.
 *
18
 * @see book_menu()
19 20 21 22 23 24 25
 */
function book_render() {
  $book_list = array();
  foreach (book_get_books() as $book) {
    $book_list[] = l($book['title'], $book['href'], $book['options']);
  }

26
  return theme('item_list', array('items' => $book_list));
27 28 29
}

/**
30
 * Page callback: Generates representations of a book page and its children.
31
 *
32 33 34 35
 * The function delegates the generation of output to helper functions. The
 * function name is derived by prepending 'book_export_' to the given output
 * type. So, e.g., a type of 'html' results in a call to the function
 * book_export_html().
36
 *
37 38 39 40
 * @param $type
 *   A string encoding the type of output requested. The following types are
 *   currently supported in book module:
 *   - html: Printer-friendly HTML.
41
 *   Other types may be supported in contributed modules.
42 43
 * @param \Drupal\node\Plugin\Core\Entity\Node $node
 *   The node to export.
44
 *
45
 * @return
46 47 48
 *   A string representing the node and its children in the book hierarchy in a
 *   format determined by the $type parameter.
 *
49 50
 * @throws \Symfony\Component\HttpKernel\Exception\NotFoundHttpException
 *
51
 * @see book_menu()
52
 */
53
function book_export($type, Node $node) {
54 55
  $type = drupal_strtolower($type);

56
  $export_function = 'book_export_' . $type;
57 58

  if (function_exists($export_function)) {
59
    print call_user_func($export_function, $node);
60 61 62
  }
  else {
    drupal_set_message(t('Unknown export format.'));
63
    throw new NotFoundHttpException();
64 65 66 67
  }
}

/**
68
 * Generates HTML for export when invoked by book_export().
69
 *
70 71 72 73 74 75
 * The given node is embedded to its absolute depth in a top level section. For
 * example, a child node with depth 2 in the hierarchy is contained in
 * (otherwise empty) <div> elements corresponding to depth 0 and depth 1.
 * This is intended to support WYSIWYG output - e.g., level 3 sections always
 * look like level 3 sections, no matter their depth relative to the node
 * selected to be exported as printer-friendly HTML.
76
 *
77 78
 * @param \Drupal\node\Plugin\Core\Entity\Node
 *   The node to export.
79
 *
80 81 82
 * @return
 *   A string containing HTML representing the node and its children in
 *   the book hierarchy.
83 84 85
 *
 * @throws \Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException
 * @throws \Symfony\Component\HttpKernel\Exception\NotFoundHttpException
86
 */
87
function book_export_html(Node $node) {
88 89 90
  if (user_access('access printer-friendly version')) {
    if (isset($node->book)) {
      $tree = book_menu_subtree_data($node->book);
91
      $contents = book_export_traverse($tree, 'book_node_export');
92
      return theme('book_export_html', array('title' => $node->label(), 'contents' => $contents, 'depth' => $node->book['depth']));
93 94
    }
    else {
95
      throw new NotFoundHttpException();
96 97 98
    }
  }
  else {
99
    throw new AccessDeniedHttpException();
100 101 102 103
  }
}

/**
104 105
 * Page callback: Shows the outline form for a single node.
 *
106
 * @param Drupal\node\Node $node
107 108
 *   The book node for which to show the outline.
 *
109 110 111
 * @return string
 *   A HTML-formatted string with the outline form for a single node.
 *
112
 * @see book_menu()
113
 */
114
function book_outline(Node $node) {
115
  drupal_set_title($node->label());
116 117 118 119
  return drupal_get_form('book_outline_form', $node);
}

/**
120 121 122 123
 * Form constructor for the book outline form.
 *
 * Allows handling of all book outline operations via the outline tab.
 *
124
 * @param Drupal\node\Node $node
125
 *   The book node for which to show the outline.
126 127 128 129 130
 *
 * @see book_outline_form_submit()
 * @see book_remove_button_submit()
 * @ingroup forms
 */
131
function book_outline_form($form, &$form_state, Node $node) {
132 133 134 135 136 137 138
  if (!isset($node->book)) {
    // The node is not part of any book yet - set default options.
    $node->book = _book_link_defaults($node->nid);
  }
  else {
    $node->book['original_bid'] = $node->book['bid'];
  }
139

140 141 142 143 144 145
  // Find the depth limit for the parent select.
  if (!isset($node->book['parent_depth_limit'])) {
    $node->book['parent_depth_limit'] = _book_parent_depth_limit($node->book);
  }
  $form['#node'] = $node;
  $form['#id'] = 'book-outline';
146
  _book_add_form_elements($form, $form_state, $node);
147 148 149 150 151 152 153 154 155 156

  $form['update'] = array(
    '#type' => 'submit',
    '#value' => $node->book['original_bid'] ? t('Update book outline') : t('Add to book outline'),
    '#weight' => 15,
  );

  $form['remove'] = array(
    '#type' => 'submit',
    '#value' => t('Remove from book outline'),
157
    '#access' => _book_node_is_removable($node),
158 159 160 161 162 163 164 165
    '#weight' => 20,
    '#submit' => array('book_remove_button_submit'),
  );

  return $form;
}

/**
166
 * Form submission handler for book_outline_form().
167
 *
168 169 170
 * Redirects to removal confirmation form.
 *
 * @see book_outline_form_submit()
171
 */
172
function book_remove_button_submit($form, &$form_state) {
173
  $form_state['redirect'] = 'node/' . $form['#node']->nid . '/outline/remove';
174 175 176
}

/**
177
 * Form submission handler for book_outline_form().
178
 *
179
 * @see book_remove_button_submit()
180 181 182
 */
function book_outline_form_submit($form, &$form_state) {
  $node = $form['#node'];
183
  $form_state['redirect'] = "node/" . $node->nid;
184 185 186
  $book_link = $form_state['values']['book'];
  if (!$book_link['bid']) {
    drupal_set_message(t('No changes were made'));
187

188 189 190 191 192 193 194 195 196
    return;
  }

  $book_link['menu_name'] = book_menu_name($book_link['bid']);
  $node->book = $book_link;
  if (_book_update_outline($node)) {
    if ($node->book['parent_mismatch']) {
      // This will usually only happen when JS is disabled.
      drupal_set_message(t('The post has been added to the selected book. You may now position it relative to other pages.'));
197
      $form_state['redirect'] = "node/" . $node->nid . "/outline";
198 199 200 201 202 203 204 205 206 207 208
    }
    else {
      drupal_set_message(t('The book outline has been updated.'));
    }
  }
  else {
    drupal_set_message(t('There was an error adding the post to the book.'), 'error');
  }
}

/**
209
 * Form constructor to confirm removal of a node from a book.
210
 *
211
 * @param Drupal\node\Node $node
212
 *   The node to delete.
213
 *
214 215
 * @see book_remove_form_submit()
 * @see book_menu()
216 217
 * @ingroup forms
 */
218
function book_remove_form($form, &$form_state, Node $node) {
219
  $form['#node'] = $node;
220
  $title = array('%title' => $node->label());
221 222 223 224 225 226 227 228

  if ($node->book['has_children']) {
    $description = t('%title has associated child pages, which will be relocated automatically to maintain their connection to the book. To recreate the hierarchy (as it was before removing this page), %title may be added again using the Outline tab, and each of its former child pages will need to be relocated manually.', $title);
  }
  else {
    $description = t('%title may be added to hierarchy again using the Outline tab.', $title);
  }

229
  return confirm_form($form, t('Are you sure you want to remove %title from the book hierarchy?', $title), 'node/' . $node->nid, $description, t('Remove'));
230 231 232
}

/**
233
 * Form submission handler for book_remove_form().
234 235 236
 */
function book_remove_form_submit($form, &$form_state) {
  $node = $form['#node'];
237
  if (_book_node_is_removable($node)) {
238
    menu_link_delete($node->book['mlid']);
239 240 241
    db_delete('book')
      ->condition('nid', $node->nid)
      ->execute();
242 243
    drupal_set_message(t('The post has been removed from the book.'));
  }
244
  $form_state['redirect'] = 'node/' . $node->nid;
245
}