Newer
Older
// $Id$
Dries Buytaert
committed
/**
* Implementation of hook_node_info().
Dries Buytaert
committed
*/
function book_node_info() {
Neil Drumm
committed
return array(
'book' => array(
Steven Wittens
committed
'name' => t('Book page'),
Neil Drumm
committed
'module' => 'book',
'description' => t("A book is a collaborative writing effort: users can collaborate writing the pages of the book, positioning the pages in the right order, and reviewing or modifying pages previously written. So when you have some information to share or when you read a page of the book and you didn't like it, or if you think a certain page could have been written better, you can do something about it."),
)
);
Dries Buytaert
committed
/**
* Implementation of hook_perm().
*/
return array('outline posts in books', 'create book pages', 'create new books', 'edit book pages', 'edit own book pages', 'see printer-friendly version');
Dries Buytaert
committed
/**
* Implementation of hook_access().
*/
Dries Buytaert
committed
if ($op == 'create') {
// Only registered users can create book pages. Given the nature
return user_access('create book pages');
Dries Buytaert
committed
if ($op == 'update') {
// Only registered users can update book pages. Given the nature
// of the book module this is considered to be a good/safe idea.
// One can only update a book page if there are no suggested updates
// of that page waiting for approval. That is, only updates that
// don't overwrite the current or pending information are allowed.
Steven Wittens
committed
Dries Buytaert
committed
if (user_access('edit book pages') || ($node->uid == $user->uid && user_access('edit own book pages'))) {
Dries Buytaert
committed
return TRUE;
}
else {
// do nothing. node-access() will determine further access
}
Neil Drumm
committed
function book_link($type, $node = NULL, $teaser = FALSE) {
Dries Buytaert
committed
if ($type == 'node' && isset($node->parent)) {
Neil Drumm
committed
if (!$teaser) {
Neil Drumm
committed
if (book_access('create', $node) && $node->status == 1) {
Dries Buytaert
committed
$links['book_add_child'] = array(
Steven Wittens
committed
'title' => t('Add child page'),
'href' => "node/add/book/parent/$node->nid"
Dries Buytaert
committed
);
if (user_access('see printer-friendly version')) {
Dries Buytaert
committed
$links['book_printer'] = array(
Steven Wittens
committed
'title' => t('Printer-friendly version'),
'href' => 'book/export/html/'. $node->nid,
'attributes' => array('title' => t('Show a printer-friendly version of this book page and its sub-pages.'))
Dries Buytaert
committed
);
}
Dries Buytaert
committed
$items[] = array(
Dries Buytaert
committed
'path' => 'admin/content/book',
Steven Wittens
committed
'title' => t('Books'),
'description' => t("Manage site's books and orphaned book pages."),
Dries Buytaert
committed
'access' => user_access('administer nodes'));
Dries Buytaert
committed
'path' => 'admin/content/book/list',
Steven Wittens
committed
'title' => t('List'),
'type' => MENU_DEFAULT_LOCAL_TASK);
Dries Buytaert
committed
$items[] = array(
Dries Buytaert
committed
'path' => 'admin/content/book/orphan',
Steven Wittens
committed
'title' => t('Orphan pages'),
Dries Buytaert
committed
'callback' => 'drupal_get_form',
'callback arguments' => array('book_admin_orphan'),
'type' => MENU_LOCAL_TASK,
$items[] = array(
'path' => 'book',
Steven Wittens
committed
'title' => t('Books'),
'callback' => 'book_render',
'access' => user_access('access content'),
'type' => MENU_SUGGESTED_ITEM);
Dries Buytaert
committed
'path' => 'book/export',
'callback' => 'book_export',
'access' => user_access('access content'),
// Add the CSS for this module
// We put this in !$may_cache so it's only added once per request
drupal_add_css(drupal_get_path('module', 'book') .'/book.css');
// To avoid SQL overhead, check whether we are on a node page and whether the
// user is allowed to outline posts in books.
if (arg(0) == 'node' && is_numeric(arg(1)) && user_access('outline posts in books')) {
$result = db_query(db_rewrite_sql("SELECT n.nid FROM {node} n WHERE n.nid = %d AND n.type != 'book'"), arg(1));
$items[] = array(
'path' => 'node/'. arg(1) .'/outline',
Steven Wittens
committed
'title' => t('Outline'),
Dries Buytaert
committed
'callback' => 'drupal_get_form',
'callback arguments' => array('book_outline', arg(1)),
'access' => user_access('outline posts in books'),
'type' => MENU_LOCAL_TASK,
'weight' => 2);
Dries Buytaert
committed
/**
* Implementation of hook_block().
*
* Displays the book table of contents in a block when the current page is a
* single-node view of a book node.
Dries Buytaert
committed
*/
return $block;
else if ($op == 'view') {
// Only display this block when the user is browsing a book:
if (arg(0) == 'node' && is_numeric(arg(1))) {
$result = db_query(db_rewrite_sql('SELECT n.nid, n.title, b.parent FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE n.nid = %d'), arg(1));
if (db_num_rows($result) > 0) {
$node = db_fetch_object($result);
$path = book_location($node);
$path[] = $node;
$expand = array();
foreach ($path as $key => $node) {
$expand[] = $node->nid;
}
$block['subject'] = check_plain($path[0]->title);
return $block;
}
Dries Buytaert
committed
/**
* Implementation of hook_insert().
*/
function book_insert($node) {
db_query("INSERT INTO {book} (nid, vid, parent, weight) VALUES (%d, %d, %d, %d)", $node->nid, $node->vid, $node->parent, $node->weight);
Dries Buytaert
committed
/**
Dries Buytaert
committed
* Implementation of hook_submit().
Dries Buytaert
committed
*/
Dries Buytaert
committed
function book_submit(&$node) {
global $user;
Dries Buytaert
committed
// Set default values for non-administrators.
if (!user_access('administer nodes')) {
$node->revision = 1;
$node->uid = $user->uid;
Dries Buytaert
committed
}
}
Dries Buytaert
committed
/**
* Implementation of hook_form().
*/
function book_form(&$node) {
Neil Drumm
committed
$type = node_get_types('type', $node);
Steven Wittens
committed
if ($node->nid && !$node->parent && !user_access('create new books')) {
$form['parent'] = array('#type' => 'value', '#value' => $node->parent);
Steven Wittens
committed
}
else {
$form['parent'] = array('#type' => 'select',
'#title' => t('Parent'),
'#default_value' => ($node->parent ? $node->parent : arg(4)),
'#options' => book_toc($node->nid),
'#weight' => -4,
'#description' => user_access('create new books') ? t('The parent section in which to place this page. Note that each page whose parent is <top-level> is an independent, top-level book.') : t('The parent that this page belongs in.'),
Steven Wittens
committed
);
}
Dries Buytaert
committed
$form['title'] = array('#type' => 'textfield',
Neil Drumm
committed
'#title' => check_plain($type->title_label),
Dries Buytaert
committed
'#required' => TRUE,
'#default_value' => $node->title,
'#weight' => -5,
);
$form['body_filter']['body'] = array('#type' => 'textarea',
Neil Drumm
committed
'#title' => check_plain($type->body_label),
Dries Buytaert
committed
'#default_value' => $node->body,
'#rows' => 20,
'#required' => TRUE,
);
$form['body_filter']['format'] = filter_form($node->format);
Dries Buytaert
committed
if (user_access('administer nodes')) {
$form['weight'] = array('#type' => 'weight',
'#title' => t('Weight'),
'#default_value' => $node->weight,
'#delta' => 15,
'#weight' => 5,
'#description' => t('Pages at a given level are ordered first by weight and then by title.'),
);
}
else {
// If a regular user updates a book page, we preserve the node weight; otherwise
// we use 0 as the default for new pages
$form['weight'] = array(
'#type' => 'value',
'#value' => isset($node->weight) ? $node->weight : 0,
);
Dries Buytaert
committed
/**
* Implementation of function book_outline()
* Handles all book outline operations.
Dries Buytaert
committed
*/
Dries Buytaert
committed
function book_outline($nid) {
$node = node_load($nid);
Dries Buytaert
committed
$form['parent'] = array('#type' => 'select',
'#title' => t('Parent'),
'#default_value' => $node->parent,
Steven Wittens
committed
'#options' => book_toc($node->nid),
Dries Buytaert
committed
'#description' => t('The parent page in the book.'),
);
$form['weight'] = array('#type' => 'weight',
'#title' => t('Weight'),
'#default_value' => $node->weight,
Dries Buytaert
committed
'#delta' => 15,
'#description' => t('Pages at a given level are ordered first by weight and then by title.'),
);
$form['log'] = array('#type' => 'textarea',
'#title' => t('Log message'),
'#description' => t('An explanation to help other authors understand your motivations to put this post into the book.'),
);
Dries Buytaert
committed
$form['nid'] = array('#type' => 'value', '#value' => $nid);
Dries Buytaert
committed
$form['update'] = array('#type' => 'submit',
'#value' => t('Update book outline'),
);
$form['remove'] = array('#type' => 'submit',
'#value' => t('Remove from book outline'),
);
}
else {
$form['add'] = array('#type' => 'submit', '#value' => t('Add to book outline'));
}
Dries Buytaert
committed
drupal_set_title(check_plain($node->title));
Dries Buytaert
committed
return $form;
Dries Buytaert
committed
}
/**
* Handles book outline form submissions.
*/
function book_outline_submit($form_id, $form_values) {
$op = $form_values['op'];
Dries Buytaert
committed
$node = node_load($form_values['nid']);
switch ($op) {
case t('Add to book outline'):
db_query('INSERT INTO {book} (nid, vid, parent, weight) VALUES (%d, %d, %d, %d)', $node->nid, $node->vid, $form_values['parent'], $form_values['weight']);
db_query("UPDATE {node_revisions} SET log = '%s' WHERE vid = %d", $form_values['log'], $node->vid);
drupal_set_message(t('The post has been added to the book.'));
break;
case t('Update book outline'):
db_query('UPDATE {book} SET parent = %d, weight = %d WHERE vid = %d', $form_values['parent'], $form_values['weight'], $node->vid);
db_query("UPDATE {node_revisions} SET log = '%s' WHERE vid = %d", $form_values['log'], $node->vid);
drupal_set_message(t('The book outline has been updated.'));
break;
case t('Remove from book outline'):
db_query('DELETE FROM {book} WHERE nid = %d', $node->nid);
drupal_set_message(t('The post has been removed from the book.'));
break;
Dries Buytaert
committed
return "node/$node->nid";
Dries Buytaert
committed
/**
* Given a node, this function returns an array of 'book node' objects
* representing the path in the book tree from the root to the
* parent of the given node.
* @param $node
* A book node object for which to compute the path.
*
* @return
* An array of book node objects representing the path nodes root to
* parent of the given node. Returns an empty array if the node does
* not exist or is not part of a book hierarchy.
Dries Buytaert
committed
*/
$parent = db_fetch_object(db_query(db_rewrite_sql('SELECT n.nid, n.title, b.parent, b.weight FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE n.nid = %d'), $node->parent));
if (isset($parent->title)) {
* Given a node, this function returns an array of 'book node' objects
* representing the path in the book tree from the given node down to
* the last sibling of it.
*
* @param $node
* A book node object where the path starts.
*
* @return
* An array of book node objects representing the path nodes from the
* given node. Returns an empty array if the node does not exist or
* is not part of a book hierarchy or there are no siblings.
Dries Buytaert
committed
$last_direct_child = db_fetch_object(db_query(db_rewrite_sql('SELECT n.nid, n.title, b.parent, b.weight FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE n.status = 1 AND b.parent = %d ORDER BY b.weight DESC, n.title DESC'), $node->nid));
$nodes[] = $last_direct_child;
$nodes = book_location_down($last_direct_child, $nodes);
}
return $nodes;
}
Dries Buytaert
committed
/**
* Fetches the node object of the previous page of the book.
Dries Buytaert
committed
*/
// If the parent is zero, we are at the start of a book so there is no previous.
Dries Buytaert
committed
$direct_above = db_fetch_object(db_query(db_rewrite_sql("SELECT n.nid, n.title, b.weight FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE b.parent = %d AND n.status = 1 AND (b.weight < %d OR (b.weight = %d AND n.title < '%s')) ORDER BY b.weight DESC, n.title DESC"), $node->parent, $node->weight, $node->weight, $node->title));
return $path ? (count($path) > 0 ? array_pop($path) : NULL) : $direct_above;
Dries Buytaert
committed
$prev = db_fetch_object(db_query(db_rewrite_sql('SELECT n.nid, n.title FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE n.nid = %d AND n.status = 1'), $node->parent));
Dries Buytaert
committed
/**
* Fetches the node object of the next page of the book.
Dries Buytaert
committed
*/
Dries Buytaert
committed
$child = db_fetch_object(db_query(db_rewrite_sql('SELECT n.nid, n.title, b.weight FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE b.parent = %d AND n.status = 1 ORDER BY b.weight ASC, n.title ASC'), $node->nid));
// No direct child: get next for this level or any parent in this book.
Dries Buytaert
committed
$path = book_location($node); // Path to top-level node including this one.
Dries Buytaert
committed
Dries Buytaert
committed
$next = db_fetch_object(db_query(db_rewrite_sql("SELECT n.nid, n.title, b.weight FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE b.parent = %d AND n.status = 1 AND (b.weight > %d OR (b.weight = %d AND n.title > '%s')) ORDER BY b.weight ASC, n.title ASC"), $leaf->parent, $leaf->weight, $leaf->weight, $leaf->title));
* Returns the content of a given node. If $teaser if TRUE, returns
* the teaser rather than full content. Displays the most recently
* approved revision of a node (if any) unless we have to display this
* page in the context of the moderation queue.
*/
// Return the page body.
return node_prepare($node, $teaser);
Dries Buytaert
committed
/**
* Implementation of hook_nodeapi().
*
* Appends book navigation to all nodes in the book.
Dries Buytaert
committed
*/
function book_nodeapi(&$node, $op, $teaser, $page) {
switch ($op) {
case 'load':
return db_fetch_array(db_query('SELECT parent, weight FROM {book} WHERE vid = %d', $node->vid));
break;
if (isset($node->parent)) {
$path = book_location($node);
// Construct the breadcrumb:
$node->breadcrumb = array(); // Overwrite the trail with a book trail.
foreach ($path as $level) {
$node->breadcrumb[] = array('path' => 'node/'. $level->nid, 'title' => $level->title);
}
$node->breadcrumb[] = array('path' => 'node/'. $node->nid);
Dries Buytaert
committed
$node->content['book_navigation'] = array(
'#value' => theme('book_navigation', $node),
'#weight' => 100,
);
if ($page) {
menu_set_location($node->breadcrumb);
}
case 'update':
if (isset($node->parent)) {
if ($node->revision) {
db_query("INSERT INTO {book} (nid, vid, parent, weight) VALUES (%d, %d, %d, %d)", $node->nid, $node->vid, $node->parent, $node->weight);
}
else {
db_query("UPDATE {book} SET parent = %d, weight = %d WHERE vid = %d", $node->parent, $node->weight, $node->vid);
}
}
break;
Dries Buytaert
committed
case 'delete revision':
db_query('DELETE FROM {book} WHERE vid = %d', $node->vid);
break;
Dries Buytaert
committed
case 'delete':
db_query('DELETE FROM {book} WHERE nid = %d', $node->nid);
break;
Dries Buytaert
committed
/**
* Prepares the links to children (TOC) and forward/backward
Dries Buytaert
committed
* navigation for a node presented as a book page.
*
* @ingroup themeable
Dries Buytaert
committed
*/
function theme_book_navigation($node) {
Dries Buytaert
committed
$output = '';
Dries Buytaert
committed
Dries Buytaert
committed
$tree = book_tree($node->nid);
drupal_add_link(array('rel' => 'prev', 'href' => url('node/'. $prev->nid)));
Dries Buytaert
committed
$links .= l(t('‹ ') . $prev->title, 'node/'. $prev->nid, array('class' => 'page-previous', 'title' => t('Go to previous page')));
Dries Buytaert
committed
if ($node->parent) {
drupal_add_link(array('rel' => 'up', 'href' => url('node/'. $node->parent)));
Dries Buytaert
committed
$links .= l(t('up'), 'node/'. $node->parent, array('class' => 'page-up', 'title' => t('Go to parent page')));
drupal_add_link(array('rel' => 'next', 'href' => url('node/'. $next->nid)));
Dries Buytaert
committed
$links .= l($next->title . t(' ›'), 'node/'. $next->nid, array('class' => 'page-next', 'title' => t('Go to next page')));
Dries Buytaert
committed
if (isset($tree) || isset($links)) {
$output = '<div class="book-navigation">';
if (isset($tree)) {
$output .= $tree;
}
if (isset($links)) {
$output .= '<div class="page-links clear-block">'. $links .'</div>';
Dries Buytaert
committed
}
$output .= '</div>';
}
return $output;
/**
* This is a helper function for book_toc().
*/
Steven Wittens
committed
function book_toc_recurse($nid, $indent, $toc, $children, $exclude) {
if ($children[$nid]) {
foreach ($children[$nid] as $foo => $node) {
Steven Wittens
committed
if (!$exclude || $exclude != $node->nid) {
$toc[$node->nid] = $indent .' '. $node->title;
$toc = book_toc_recurse($node->nid, $indent .'--', $toc, $children, $exclude);
}
/**
* Returns an array of titles and nid entries of book pages in table of contents order.
*/
Steven Wittens
committed
function book_toc($exclude = 0) {
$result = db_query(db_rewrite_sql('SELECT n.nid, n.title, b.parent, b.weight FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE n.status = 1 ORDER BY b.weight, n.title'));
if (!$children[$node->parent]) {
$children[$node->parent] = array();
}
$children[$node->parent][] = $node;
$toc = array();
// If the user has permission to create new books, add the top-level book page to the menu;
Steven Wittens
committed
if (user_access('create new books')) {
Dries Buytaert
committed
$toc[0] = '<'. t('top-level') .'>';
$toc = book_toc_recurse(0, '', $toc, $children, $exclude);
/**
* This is a helper function for book_tree()
*/
function book_tree_recurse($nid, $depth, $children, $unfold = array()) {
if (isset($children[$nid])) {
if (in_array($node->nid, $unfold)) {
if ($tree = book_tree_recurse($node->nid, $depth - 1, $children, $unfold)) {
$output .= '<li class="expanded">';
$output .= '<ul class="menu">'. $tree .'</ul>';
$output .= '<li class="leaf">'. l($node->title, 'node/'. $node->nid) .'</li>';
}
}
else {
if ($tree = book_tree_recurse($node->nid, 1, $children)) {
$output .= '<li class="collapsed">'. l($node->title, 'node/'. $node->nid) .'</li>';
$output .= '<li class="leaf">'. l($node->title, 'node/'. $node->nid) .'</li>';
/**
* Returns an HTML nested list (wrapped in a menu-class div) representing the book nodes
* as a tree.
*/
Dries Buytaert
committed
$result = db_query(db_rewrite_sql('SELECT n.nid, n.title, b.parent, b.weight FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE n.status = 1 ORDER BY b.weight, n.title'));
$list = isset($children[$node->parent]) ? $children[$node->parent] : array();
return '<ul class="menu">'. $tree .'</ul>';
Dries Buytaert
committed
/**
* Menu callback; prints a listing of all books.
Dries Buytaert
committed
*/
Dries Buytaert
committed
$result = db_query(db_rewrite_sql('SELECT n.nid, n.title, b.weight FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE b.parent = 0 AND n.status = 1 ORDER BY b.weight, n.title'));
$books = array();
while ($node = db_fetch_object($result)) {
$books[] = l($node->title, 'node/'. $node->nid);
}
return theme('item_list', $books);
Dries Buytaert
committed
/**
Dries Buytaert
committed
* Menu callback; Generates various representation of a book page with
* all descendants and prints the requested representation to output.
*
* 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().
Dries Buytaert
committed
*
* @param type
* - a string encoding the type of output requested.
* The following types are currently supported in book module
* html: HTML (printer friendly output)
* Other types are supported in contributed modules.
Dries Buytaert
committed
* @param nid
* - an integer representing the node id (nid) of the node to export
*
Dries Buytaert
committed
*/
function book_export($type = 'html', $nid = 0) {
Steven Wittens
committed
$type = drupal_strtolower($type);
$node_result = db_query(db_rewrite_sql('SELECT n.nid, n.title, b.parent FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE n.nid = %d'), $nid);
if (db_num_rows($node_result) > 0) {
$node = db_fetch_object($node_result);
}
$depth = count(book_location($node)) + 1;
$export_function = 'book_export_'. $type;
if (function_exists($export_function)) {
print call_user_func($export_function, $nid, $depth);
Dries Buytaert
committed
}
else {
drupal_set_message(t('Unknown export format.'));
Dries Buytaert
committed
drupal_not_found();
Dries Buytaert
committed
}
/**
* This function is called by book_export() to generate HTML for export.
*
* 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.
*
* @param nid
* - an integer representing the node id (nid) of the node to export
* @param depth
* - an integer giving the depth in the book hierarchy of the node
* which is to be exported
*
* @return
* - string containing HTML representing the node and its children in
* the book hierarchy
*/
function book_export_html($nid, $depth) {
if (user_access('see printer-friendly version')) {
$node = node_load($nid);
for ($i = 1; $i < $depth; $i++) {
$content .= "<div class=\"section-$i\">\n";
}
$content .= book_recurse($nid, $depth, 'book_node_visitor_html_pre', 'book_node_visitor_html_post');
for ($i = 1; $i < $depth; $i++) {
$content .= "</div>\n";
}
return theme('book_export_html', check_plain($node->title), $content);
}
else {
drupal_access_denied();
}
}
/**
* How the book's HTML export should be themed
*
* @ingroup themeable
*/
function theme_book_export_html($title, $content) {
global $base_url;
$html = "<!DOCTYPE html PUBLIC \"-//W3C//DTD XHTML 1.0 Transitional//EN\" \"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd\">\n";
$html .= '<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">';
$html .= '<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />';
$html .= '<base href="'. $base_url .'/" />' . "\n";
$html .= "<style type=\"text/css\">\n@import url(misc/print.css);\n</style>\n";
$html .= "</head>\n<body>\n". $content ."\n</body>\n</html>\n";
return $html;
}
* Traverses the book tree. Applies the $visit_pre() callback to each
* node, is called recursively for each child of the node (in weight,
* title order). Finally appends the output of the $visit_post()
* callback to the output before returning the generated output.
*
Neil Drumm
committed
* @todo This is duplicitous with node_build_content().
*
* @param nid
* - the node id (nid) of the root node of the book hierarchy.
* @param depth
* - the depth of the given node in the book hierarchy.
* @param visit_pre
* - a function callback to be called upon visiting a node in the tree
* @param visit_post
* - a function callback to be called after visiting a node in the tree,
* but before recursively visiting children.
* @return
* - the output generated in visiting each node
*/
function book_recurse($nid = 0, $depth = 1, $visit_pre, $visit_post) {
Dries Buytaert
committed
$result = db_query(db_rewrite_sql('SELECT n.nid, n.title, b.weight FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE n.status = 1 AND n.nid = %d ORDER BY b.weight, n.title'), $nid);
$node = node_load($page->nid);
if (function_exists($visit_pre)) {
$output .= call_user_func($visit_pre, $node, $depth, $nid);
Dries Buytaert
committed
else {
$output .= book_node_visitor_html_pre($node, $depth, $nid);
Dries Buytaert
committed
$children = db_query(db_rewrite_sql('SELECT n.nid, n.title, b.weight FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE n.status = 1 AND b.parent = %d ORDER BY b.weight, n.title'), $node->nid);
while ($childpage = db_fetch_object($children)) {
$childnode = node_load($childpage->nid);
if ($childnode->nid != $node->nid) {
$output .= book_recurse($childnode->nid, $depth + 1, $visit_pre, $visit_post);
}
}
if (function_exists($visit_post)) {
Dries Buytaert
committed
$output .= call_user_func($visit_post, $node, $depth);
else {
# default
Dries Buytaert
committed
$output .= book_node_visitor_html_post($node, $depth);
* Generates printer-friendly HTML for a node. This function
* is a 'pre-node' visitor function for book_recurse().
*
* @param $node
* - the node to generate output for.
* @param $depth
* - the depth of the given node in the hierarchy. This
* is used only for generating output.
* @param $nid
* - the node id (nid) of the given node. This
* is used only for generating output.
* @return
* - the HTML generated for the given node.
*/
Dries Buytaert
committed
function book_node_visitor_html_pre($node, $depth, $nid) {
Neil Drumm
committed
// Remove the delimiter (if any) that separates the teaser from the body.
$node->body = str_replace('<!--break-->', '', $node->body);
Neil Drumm
committed
// The 'view' hook can be implemented to overwrite the default function
// to display nodes.
if (node_hook($node, 'view')) {
$node = node_invoke($node, 'view', FALSE, FALSE);
}
else {
$node = node_prepare($node, FALSE);
Neil Drumm
committed
// Allow modules to make their own additions to the node.
node_invoke_nodeapi($node, 'print');
Dries Buytaert
committed
$output .= "<div id=\"node-". $node->nid ."\" class=\"section-$depth\">\n";
$output .= "<h1 class=\"book-heading\">". check_plain($node->title) ."</h1>\n";
Neil Drumm
committed
$output .= drupal_render($node->content);
return $output;
}
/**
* Finishes up generation of printer-friendly HTML after visiting a
* node. This function is a 'post-node' visitor function for
* book_recurse().
*/
Dries Buytaert
committed
function book_node_visitor_html_post($node, $depth) {
return "</div>\n";
}
function _book_admin_table($nodes = array()) {
$form = array(
'#theme' => 'book_admin_table',
'#tree' => TRUE,
);
foreach ($nodes as $node) {
$form = array_merge($form, _book_admin_table_tree($node, 0));
}
return $form;
function _book_admin_table_tree($node, $depth) {
$form = array();
$form[] = array(
'nid' => array('#type' => 'value', '#value' => $node->nid),
'depth' => array('#type' => 'value', '#value' => $depth),
'title' => array(
'#type' => 'textfield',
'#default_value' => $node->title,
'#maxlength' => 255,
),
'weight' => array(
'#type' => 'weight',
'#default_value' => $node->weight,
'#delta' => 15,
),
$children = db_query(db_rewrite_sql('SELECT n.nid, n.title, b.weight FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE b.parent = %d ORDER BY b.weight, n.title'), $node->nid);
while ($child = db_fetch_object($children)) {
$form = array_merge($form, _book_admin_table_tree(node_load($child->nid), $depth + 1));
}
return $form;
function theme_book_admin_table($form) {
$header = array(t('Title'), t('Weight'), array('data' => t('Operations'), 'colspan' => '3'));
foreach (element_children($form) as $key) {
$nid = $form[$key]['nid']['#value'];
Dries Buytaert
committed
$pid = $form[0]['nid']['#value'];
Dries Buytaert
committed
'<div style="padding-left: '. (25 * $form[$key]['depth']['#value']) .'px;">'. drupal_render($form[$key]['title']) .'</div>',
drupal_render($form[$key]['weight']),
l(t('view'), 'node/'. $nid),
l(t('edit'), 'node/'. $nid .'/edit'),
Dries Buytaert
committed
l(t('delete'), 'node/'. $nid .'/delete', NULL, 'destination=admin/content/book'. (arg(3) == 'orphan' ? '/orphan' : '') . ($pid != $nid ? '/'.$pid : ''))
return theme('table', $header, $rows);
Dries Buytaert
committed
/**
* Display an administrative view of the hierarchy of a book.
*/
function book_admin_edit($nid) {
$node = node_load($nid);
Dries Buytaert
committed
if ($node->nid) {
drupal_set_title(check_plain($node->title));
$form['table'] = _book_admin_table(array($node));
$form['save'] = array(
'#type' => 'submit',
'#value' => t('Save book pages'),
);
Dries Buytaert
committed
return $form;
Dries Buytaert
committed
else {
drupal_not_found();
}
* Menu callback; displays a listing of all orphaned book pages.
function book_admin_orphan() {
$result = db_query(db_rewrite_sql('SELECT n.nid, n.title, n.status, b.parent FROM {node} n INNER JOIN {book} b ON n.vid = b.vid'));
$pages = array();
while ($page = db_fetch_object($result)) {
$pages[$page->nid] = $page;
}
$orphans = array();
if (count($pages)) {
foreach ($pages as $page) {
if ($page->parent && empty($pages[$page->parent])) {
$orphans[] = node_load($page->nid);
if (count($orphans)) {
$form['table'] = _book_admin_table($orphans);
$form['save'] = array(
'#type' => 'submit',
'#value' => t('Save book pages'),
);
}
else {
Dries Buytaert
committed
$form['error'] = array('#value' => '<p>'. t('There are no orphan pages.') .'</p>');
Dries Buytaert
committed
$form['#base'] = 'book_admin_edit';
return $form;
Dries Buytaert
committed
function book_admin_edit_submit($form_id, $form_values) {
foreach ($form_values['table'] as $row) {
$node = node_load($row['nid']);
if ($row['title'] != $node->title || $row['weight'] != $node->weight) {
$node->title = $row['title'];
$node->weight = $row['weight'];
watchdog('content', t('%type: updated %title.', array('%type' => t('book'), '%title' => $node->title)), WATCHDOG_NOTICE, l(t('view'), 'node/'. $node->nid));
if (is_numeric(arg(3))) {
// Updating pages in a single book.
$book = node_load(arg(3));
drupal_set_message(t('Updated book %title.', array('%title' => $book->title)));
}
else {
// Updating the orphan pages.
drupal_set_message(t('Updated orphan book pages.'));
}
Dries Buytaert
committed
/**
* Menu callback; displays the book administration page.
Dries Buytaert
committed
*/
Dries Buytaert
committed
if ($nid) {
return drupal_get_form('book_admin_edit', $nid);
Dries Buytaert
committed
}
else {
return book_admin_overview();
}
}
/**
* Returns an administrative overview of all books.
*/
Dries Buytaert
committed
function book_admin_overview() {
$result = db_query(db_rewrite_sql('SELECT n.nid, n.title, b.weight FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE b.parent = 0 ORDER BY b.weight, n.title'));
Dries Buytaert
committed
while ($book = db_fetch_object($result)) {
Dries Buytaert
committed
$rows[] = array(l($book->title, "node/$book->nid"), l(t('outline'), "admin/content/book/$book->nid"));
Dries Buytaert
committed
}
$headers = array(t('Book'), t('Operations'));
return theme('table', $headers, $rows);
Dries Buytaert
committed
/**
* Implementation of hook_help().
*/
Dries Buytaert
committed
$output = '<p>'. t('The <em>book</em> module is suited for creating structured, multi-page hypertexts such as site resource guides, manuals, and Frequently Asked Questions (FAQs). It permits a document to have chapters, sections, subsections, etc. Authors with suitable permissions can add pages to a collaborative book, placing them into the existing document by adding them to a table of contents menu.') .'</p>';
$output .= '<p>'. t('Book pages have navigation elements at the bottom of the page for moving through the text. These link to the previous and next pages in the book, as well as a link labeled <em>up</em>, leading to the level above in the structure. More comprehensive navigation may be provided by enabling the <em>book navigation block</em> on the <a href="@admin-block">block administration page</a>.', array('@admin-block' => url('admin/build/block'))) .'</p>';
$output .= '<p>'. t('Users can select the <em>printer-friendly version</em> link visible at the bottom of a book page to generate a printer-friendly display of the page and all of its subsections. ') .'</p>';
Dries Buytaert
committed
$output .= '<p>'. t("Posts of type %book are automatically added to the book hierarchy. Users with the <em>outline posts in books</em> permission can also add content of any other type to a book, placing it into the existing book structure through the interface that's available by clicking on the <em>outline</em> tab while viewing that post.", array('%book' => node_get_types('name', 'book'))) .'</p>';
$output .= '<p>'. t('Administrators can view a list of all books on the <a href="@admin-node-book">book administration page</a>. In this list there is a link to an outline page for each book, from which is it possible to change the titles of sections, or to change their weight, thus reordering sections. From this administrative interface, it is also possible to determine whether there are any orphan pages - pages that have become disconnected from the rest of the book structure.', array('@admin-node-book' => url('admin/content/book'))) .'</p>';
$output .= '<p>'. t('For more information please read the configuration and customization handbook <a href="@book">Book page</a>.', array('@book' => 'http://drupal.org/handbook/modules/book/')) .'</p>';
Dries Buytaert
committed
return $output;
Dries Buytaert
committed
case 'admin/content/book':
return '<p>'. t('The book module offers a means to organize content, authored by many users, in an online manual, outline or FAQ.') .'</p>';
Dries Buytaert
committed
case 'admin/content/book/orphan':
return '<p>'. t('Pages in a book are like a tree. As pages are edited, reorganized and removed, child pages might be left with no link to the rest of the book. Such pages are referred to as "orphan pages". On this page, administrators can review their books for orphans and reattach those pages as desired.') .'</p>';
if (arg(0) == 'node' && is_numeric(arg(1)) && arg(2) == 'outline') {
return '<p>'. t('The outline feature allows you to include posts in the <a href="@book">book hierarchy</a>.', array('@book' => url('book'))) .'</p>';