node.module 35.8 KB
Newer Older
Dries's avatar
 
Dries committed
1
<?php
2
// $Id$
Dries's avatar
 
Dries committed
3

Dries's avatar
 
Dries committed
4 5 6 7 8
function node_help() {
  global $mod;

  if ($mod == "node") {
    foreach (module_list() as $name) {
Dries's avatar
 
Dries committed
9
      if (module_hook($name, "node") && $name != "node") {
Dries's avatar
 
Dries committed
10
        print "<h3>". ucfirst($name) ." type</h3>";
Dries's avatar
 
Dries committed
11 12 13 14 15 16
        print module_invoke($name, "help");
      }
    }
  }
}

17
function node_system($field){
Kjartan's avatar
Kjartan committed
18
  $system["description"] = t("The core that allows content to be submitted to the site.");
19 20 21
  return $system[$field];
}

Dries's avatar
 
Dries committed
22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51
function node_teaser($body) {

  $size = 400;

  /*
  ** If we have a short body, return the entire body:
  */

  if (strlen($body) < $size) {
    return $body;
  }

  /*
  ** If we have a long body, try not to split paragraphs:
  */

  if ($length = strpos($body, "\n", $size)) {
    return substr($body, 0, $length + 1);
  }

  /*
  ** If we have a long body, try not to split sentences:
  */

  return substr($body, 0, strpos($body, ". ", $size) + 1);

}

function node_invoke($node, $name, $arg = 0) {
  if (is_array($node)) {
Kjartan's avatar
Kjartan committed
52
    $function = $node["type"] ."_$name";
Dries's avatar
 
Dries committed
53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105
  }
  else if (is_object($node)) {
    $function = $node->type ."_$name";
  }
  else if (is_string($node)) {
    $function = $node ."_$name";
  }

  if (function_exists($function)) {
    return ($arg ? $function($node, $arg) : $function($node));
  }
}

function node_load($conditions) {

  /*
  ** Turn the conditions into a query:
  */

  foreach ($conditions as $key => $value) {
    $cond[] = "n.". check_query($key) ." = '". check_query($value) ."'";
  }

  /*
  ** Retrieve the node:
  */

  $node = db_fetch_object(db_query("SELECT n.*, u.uid, u.name FROM node n LEFT JOIN users u ON u.uid = n.uid WHERE ". implode(" AND ", $cond)));

  /*
  ** Unserialize the revisions field:
  */

  if ($node->revisions) {
    $node->revisions = unserialize($node->revisions);
  }

  /*
  ** Call the node specific callback (if any) and piggy-back the
  ** results to the node or overwrite some values:
  */

  if ($extra = module_invoke($node->type, "load", $node)) {
    foreach ($extra as $key => $value) {
      $node->$key = $value;
    }
  }

  return $node;
}

function node_save($node, $filter) {

106
  $fields = array("nid", "uid", "type", "title", "teaser", "body", "revisions", "score", "status", "comment", "promote", "static", "moderate", "created", "changed", "users", "votes");
Dries's avatar
 
Dries committed
107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148

  foreach ($filter as $key => $value) {
    /*
    ** Only save those fields specified by the filter.  If the filter
    ** does not specify a default value, use the value of the $node's
    ** corresponding field instead.
    */

    if (is_numeric($key)) {
      if (isset($node->$value)) {
          // The above check is mandatory.
        $edit->$value = $node->$value;
      }
    }
    else {
      if (isset($value)) {
          // The above check is mandatory.
        $edit->$key = $value;
      }
    }
  }

  $node = $edit;

  /*
  ** Serialize the revisions field:
  */

  if ($node->revisions) {
    $node->revisions = serialize($node->revisions);
  }

  /*
  ** Apply filters to some default node fields:
  */

  if (empty($node->nid)) {

    /*
    ** Insert a new node:
    */

Dries's avatar
 
Dries committed
149
    // Set some required fields:
Dries's avatar
 
Dries committed
150
    $node->created = time();
Dries's avatar
 
Dries committed
151
    $node->changed = time();
Dries's avatar
 
Dries committed
152
    $node->nid = db_result(db_query("SELECT MAX(nid) + 1 FROM node"));
Dries's avatar
 
Dries committed
153
    $node->nid = empty($node->nid) ? 1 : $node->nid;
Dries's avatar
 
Dries committed
154

Dries's avatar
 
Dries committed
155
    // Prepare the query:
Dries's avatar
 
Dries committed
156 157 158 159 160 161 162
    foreach ($node as $key => $value) {
      if (in_array($key, $fields)) {
        $k[] = check_query($key);
        $v[] = "'". check_query($value) ."'";
      }
    }

Dries's avatar
 
Dries committed
163
    // Insert the node into the database:
Dries's avatar
 
Dries committed
164 165
    db_query("INSERT INTO node (". implode(", ", $k) .") VALUES (". implode(", ", $v) .")");

Dries's avatar
 
Dries committed
166
    // Call the node specific callback (if any):
Dries's avatar
 
Dries committed
167 168 169 170 171 172 173 174
    module_invoke($node->type, "insert", $node);
  }
  else {

    /*
    ** Update an existing node:
    */

Dries's avatar
 
Dries committed
175
    // Set some required fields:
Dries's avatar
 
Dries committed
176 177
    $node->changed = time();

Dries's avatar
 
Dries committed
178
    // Prepare the query:
Dries's avatar
 
Dries committed
179 180 181 182 183 184
    foreach ($node as $key => $value) {
      if (in_array($key, $fields)) {
        $q[] = check_query($key) ." = '". check_query($value) ."'";
      }
    }

Dries's avatar
 
Dries committed
185
    // Update the node in the database:
Dries's avatar
 
Dries committed
186 187
    db_query("UPDATE node SET ". implode(", ", $q) ." WHERE nid = '$node->nid'");

Dries's avatar
 
Dries committed
188
    // Call the node specific callback (if any):
Dries's avatar
 
Dries committed
189 190 191 192 193 194 195 196 197 198 199 200 201 202 203
    module_invoke($node->type, "update", $node);

  }

  /*
  ** Return the node ID:
  */

  return $node->nid;

}

function node_view($node, $main = 0) {
  global $theme;

Dries's avatar
 
Dries committed
204
  $node = array2object($node);
Dries's avatar
 
Dries committed
205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223

  /*
  ** The "view" hook can be implemented to overwrite the default function
  ** to display nodes.
  */

  if (module_hook($node->type, "view")) {
    node_invoke($node, "view", $main);
  }
  else {

    /*
    ** Default behavior:
    */

    $theme->node($node, $main);
  }
}

Dries's avatar
 
Dries committed
224 225
function node_access($op, $node = 0) {

Dries's avatar
 
Dries committed
226 227
  if (user_access("administer nodes")) {
    return 1;
Dries's avatar
 
Dries committed
228
  }
Dries's avatar
 
Dries committed
229
  else {
Dries's avatar
 
Dries committed
230

Dries's avatar
 
Dries committed
231 232 233
    /*
    ** Convert the node to an object if necessary:
    */
Dries's avatar
 
Dries committed
234

Dries's avatar
 
Dries committed
235
    $node = array2object($node);
Dries's avatar
 
Dries committed
236

Dries's avatar
 
Dries committed
237 238 239 240
    /*
    ** Construct a function:
    */

Dries's avatar
 
Dries committed
241 242 243 244 245 246 247 248
    if ($node->type) {
      $type = $node->type;
    }
    else {
      $type = $node;
    }

    $function = $type ."_access";
Dries's avatar
 
Dries committed
249 250 251 252 253 254 255

    if (function_exists($function)) {
      return $function($op, $node);
    }
    else {
      return 0;
    }
Dries's avatar
 
Dries committed
256 257 258
  }
}

Dries's avatar
 
Dries committed
259
function node_perm() {
Dries's avatar
 
Dries committed
260
  return array("administer nodes", "access content", "post content");
Dries's avatar
 
Dries committed
261 262
}

Dries's avatar
 
Dries committed
263
function node_search($keys) {
Dries's avatar
 
Dries committed
264
  global $PHP_SELF;
Dries's avatar
 
Dries committed
265

Kjartan's avatar
Kjartan committed
266 267 268 269 270 271 272 273 274 275 276 277
  // Return the results of performing a search using the indexed search
  // for this particular type of node.
  //
  // Pass an array to the "do_search" function which dictates what it
  // will search through, and what it will search for
  //
  // "keys"'s value is the keywords entered by the user
  //
  // "type"'s value is used to identify the node type in the search
  // index.
  //
  // "select"'s value is used to relate the data from the specific nodes
Dries's avatar
 
Dries committed
278
  // table to the data that the search_index table has in it, and the the
Kjartan's avatar
Kjartan committed
279 280
  // do_search functino will rank it.
  //
Dries's avatar
 
Dries committed
281
  // The select must always provide the following fields - lno, title,
Kjartan's avatar
Kjartan committed
282 283
  // created, uid, name, count
  //
Kjartan's avatar
Kjartan committed
284
  $find = do_search(array("keys" => $keys, "type" => "node", "select" => "select s.lno as lno, n.title as title, n.created as created, u.uid as uid, u.name as name, s.count as count FROM search_index s, node n LEFT JOIN users u ON n.uid = u.uid WHERE s.lno = n.nid AND s.type = 'node' AND s.word like '%' AND n.status = 1"));
Dries's avatar
 
Dries committed
285

Dries's avatar
 
Dries committed
286 287 288
  return $find;
}

Dries's avatar
 
Dries committed
289
function node_conf_options() {
Dries's avatar
 
Dries committed
290
  $output .= form_select(t("Default number of nodes to display"), "default_nodes_main", variable_get("default_nodes_main", 10), array(1 => 1, 2 => 2, 3 => 3, 4 => 4, 5 =>  5, 6 => 6, 7 => 7, 8 => 8, 9 => 9, 10 => 10, 15 => 15, 20 => 20, 25 => 25, 30 => 30), t("The default maximum number of nodes to display on the main page."));
Dries's avatar
 
Dries committed
291 292 293
  return $output;
}

Dries's avatar
CHANGES  
Dries committed
294
function node_conf_filters() {
Dries's avatar
 
Dries committed
295
  $output .= form_select(t("Enable HTML tags"), "filter_html", variable_get("filter_html", 0), array("Disabled", "Enabled"), t("Allow HTML and PHP tags in user-contributed content."));
296
  $output .= form_textfield(t("Allowed HTML tags"), "allowed_html", variable_get("allowed_html", "<a> <b> <dd> <dl> <dt> <i> <li> <ol> <u> <ul>"), 64, 255, t("If enabled, optionally specify tags which should not be stripped.  'STYLE' attributes, 'ON' attributes and unclosed tags are always stripped."));
Dries's avatar
 
Dries committed
297
  $output .= "<hr />";
Dries's avatar
 
Dries committed
298
  $output .= form_select(t("Enable link tags"), "filter_link", variable_get("filter_link", 0), array("Disabled", "Enabled"), t("Substitute special [[nodesubject|text]] tags. Your browser will display 'text', and when you click on it your browser will open the node with the subject 'nodesubject'. Please be aware that you'll need to copy the subject of the target node exactly in order to use this feature."));
Dries's avatar
 
Dries committed
299
  $output .= "<hr />";
Dries's avatar
CHANGES  
Dries committed
300 301 302 303
  return $output;
}

function node_filter_html($text) {
Kjartan's avatar
Kjartan committed
304 305
  $text = eregi_replace("([ \f\r\t\n\'\"])style=[^>]+>", "\\1", $text);
  $text = eregi_replace("([ \f\r\t\n\'\"])on[a-z]+=[^>]+>", "\\1", $text);
Dries's avatar
CHANGES  
Dries committed
306 307 308 309 310
  $text = strip_tags($text, variable_get("allowed_html", ""));
  return $text;
}

function node_filter_link($text) {
311
  $pat = '\[{2}([^\|]+)(\|([^\|]+)?)?\]{2}';                   // [link|description]
312
  $dst = str_replace('%5C1', '\\1', format_tag('\\1', '\\3')); // [link|description]
313
  return ereg_replace($pat, $dst, $text);
Dries's avatar
 
Dries committed
314 315
}

Dries's avatar
 
Dries committed
316
function node_filter_line($text) {
Dries's avatar
 
Dries committed
317

Dries's avatar
 
Dries committed
318
  /*
Dries's avatar
 
Dries committed
319 320 321 322 323 324 325
  ** This "line break filter" will try to get the line breaks right
  ** regardless of the user's input.  Its goal aspires a consistent
  ** mark-up and use of line breaks and paragraphs.
  */

  /*
  ** If HTML mark-up is being used, strip regular line breaks:
Dries's avatar
 
Dries committed
326 327 328
  */

  if (strstr($text, "<br />") || strstr($text, "<p>")) {
Dries's avatar
 
Dries committed
329
    $text = ereg_replace("[\r\n]", "", $text);
Dries's avatar
 
Dries committed
330 331 332 333 334 335
  }

  /*
  ** Replace '<br>', '<br />', '<p>' and '<p />' by '\n':
  */

Kjartan's avatar
Kjartan committed
336
  $text = eregi_replace("<br />", "\n", $text);
Dries's avatar
 
Dries committed
337 338
  $text = eregi_replace("<br />", "\n", $text);
  $text = eregi_replace("<p>", "\n", $text);
Dries's avatar
 
Dries committed
339
  $text = eregi_replace("<p />", "\n", $text);
Dries's avatar
 
Dries committed
340 341

  /*
Dries's avatar
 
Dries committed
342
  ** Replace '\r\n' by '\n':
Dries's avatar
 
Dries committed
343 344 345 346 347 348 349 350 351 352 353
  */

  $text = ereg_replace("\r\n", "\n", $text);

  /*
  ** Replace some new line charachters:
  */

  while (strpos($text, "\n\n\n")) {
    $text = ereg_replace("\n\n\n", "\n\n", $text);
  }
Dries's avatar
 
Dries committed
354

Dries's avatar
 
Dries committed
355 356 357 358 359 360 361
  /*
  ** Replace some common "artifacts":
  */

  $list = "blockquote|li|ol|ul|table|th|td|tr|pre";
  $text = preg_replace(array("/\n\s*<([\/])($list)/", "/($list)>\s*\n/"), array("<$1$2", "$1>"), $text);

Dries's avatar
 
Dries committed
362 363 364
  return trim($text);
}

Dries's avatar
 
Dries committed
365
function node_comment_mode($nid) {
Dries's avatar
 
Dries committed
366 367 368 369 370
  static $comment_mode;
  if (!isset($comment_mode[$nid])) {
    $comment_mode[$nid] = db_result(db_query("SELECT comment FROM node WHERE nid = '%s'", $nid));
  }
  return $comment_mode[$nid];
Dries's avatar
 
Dries committed
371 372
}

Dries's avatar
CHANGES  
Dries committed
373 374 375
function node_filter($text) {
  if (variable_get("filter_html", 0)) $text = node_filter_html($text);
  if (variable_get("filter_link", 0)) $text = node_filter_link($text);
Dries's avatar
 
Dries committed
376
  return node_filter_line($text);
Dries's avatar
CHANGES  
Dries committed
377 378
}

379
function node_link($type, $node = 0, $main = 0) {
Dries's avatar
 
Dries committed
380

Dries's avatar
 
Dries committed
381
  if ($type == "admin" && user_access("administer nodes")) {
Dries's avatar
 
Dries committed
382
    $links[] = la(t("content management"), array("mod" => "node"));
Dries's avatar
 
Dries committed
383 384
  }

Dries's avatar
 
Dries committed
385
  if ($type == "page" && user_access("post content")) {
Kjartan's avatar
Kjartan committed
386
    $links[] = lm(t("submit"), array("mod" => "node", "op" => "add"), "", array("title" => t("Submit or suggest new content.")));
Dries's avatar
 
Dries committed
387 388
  }

Dries's avatar
 
Dries committed
389
  if ($type == "node") {
Kjartan's avatar
Kjartan committed
390 391 392
    if ($node->links) {
      $links = $node->links;
    }
Dries's avatar
 
Dries committed
393

Dries's avatar
 
Dries committed
394
    if ($main == 1 && $node->teaser != $node->body) {
Kjartan's avatar
Kjartan committed
395
      $links[] = l(t("read more"), array("id" => $node->nid), "node", "", array("title" => t("Read the rest of this posting.")));
Dries's avatar
 
Dries committed
396
    }
Dries's avatar
 
Dries committed
397 398

    if (user_access("administer nodes")) {
Kjartan's avatar
Kjartan committed
399
       $links[] = la(t("administer"), array("mod" => "node", "op" => "edit", "id" => $node->nid), "", array("title" => t("Administer this node.")));
Dries's avatar
 
Dries committed
400
    }
Dries's avatar
 
Dries committed
401 402 403 404 405
  }

  return $links ? $links : array();
}

Dries's avatar
 
Dries committed
406
function node_admin_settings($edit = array()) {
Dries's avatar
 
Dries committed
407 408
  global $op;

Dries's avatar
 
Dries committed
409 410 411 412
  if ($op == t("Save configuration")) {
    /*
    ** Save the configuration options:
    */
Dries's avatar
Dries committed
413

Dries's avatar
 
Dries committed
414 415 416
    foreach ($edit as $name => $value) {
      variable_set($name, $value);
    }
Dries's avatar
 
Dries committed
417 418
  }

Dries's avatar
 
Dries committed
419 420 421 422
  if ($op == t("Reset to defaults")) {
    /*
    ** Reset the configuration options to their default value:
    */
Dries's avatar
 
Dries committed
423

424
    foreach ($edit as $name => $value) {
Dries's avatar
 
Dries committed
425 426
      variable_del($name);
    }
Dries's avatar
 
Dries committed
427
  }
Dries's avatar
Dries committed
428

Dries's avatar
 
Dries committed
429
  $output .= "<h3>". t("Global node settings") ."</h3>";
Dries's avatar
 
Dries committed
430
  $output .= node_conf_options();
Dries's avatar
 
Dries committed
431 432 433

  foreach (module_list() as $name) {
    if (module_hook($name, "conf_options") && module_hook($name, "node")) {
Dries's avatar
 
Dries committed
434
      $output .= "<h3>". ucfirst(module_invoke($name, "node", "name") ." settings") ."</h3>";
Dries's avatar
 
Dries committed
435 436 437 438
      $output .= module_invoke($name, "conf_options");
    }
  }

Dries's avatar
 
Dries committed
439 440
  $output .= form_submit(t("Save configuration"));
  $output .= form_submit(t("Reset to defaults"));
Dries's avatar
Dries committed
441

Dries's avatar
 
Dries committed
442
  return form($output);
Dries's avatar
 
Dries committed
443 444
}

Dries's avatar
 
Dries committed
445
function node_admin_edit($node) {
Dries's avatar
 
Dries committed
446

Dries's avatar
 
Dries committed
447
  if (is_numeric($node)) {
Dries's avatar
 
Dries committed
448
    $node = node_load(array("nid" => $node));
Dries's avatar
 
Dries committed
449
  }
Dries's avatar
 
Dries committed
450

Dries's avatar
 
Dries committed
451 452 453
  /*
  ** Edit node:
  */
Dries's avatar
 
Dries committed
454

Dries's avatar
 
Dries committed
455
  $output .= "<h3>". t("Edit") ." ". module_invoke($node->type, "node", "name") ."</h3>";
Dries's avatar
 
Dries committed
456

Dries's avatar
 
Dries committed
457
  $output .= node_form($node);
Dries's avatar
 
Dries committed
458

Dries's avatar
 
Dries committed
459 460 461 462 463 464 465 466 467
  /*
  ** Edit revisions:
  */

  if ($node->revisions) {
    $output .= "<h3>". t("Edit revisions") ."</h3>";
    $output .= "<table border=\"1\" cellpadding=\"2\" cellspacing=\"2\">";
    $output .= " <tr><th>older revisions</th><th colspan=\"3\">operations</th></tr>";
    foreach ($node->revisions as $key => $revision) {
468
      $output .= " <tr><td>". t("revision #%r revised by %u on %d", array("%r" => $key, "%u" => format_name(user_load(array("uid" => $revision["uid"]))), "%d" => format_date($revision["timestamp"], "small"))) . ($revision["history"] ? "<br /><small>". $revision["history"] ."</small>" : "") ."</td><td>". l(t("view revision"), array("id" => $node->nid, "revision" => $key)) ."</td><td>". la(t("rollback revision"), array("mod" => "node", "op" => "rollback+revision", "id" => $node->nid, "revision" => $key)) ."</td><td>". la(t("delete revision"), array("mod" => "node", "op" => "delete+revision", "id" => $node->nid, "revision" => $key)) ."</td></tr>";
Dries's avatar
 
Dries committed
469 470 471 472
    }
    $output .= "</table>";
  }

Dries's avatar
 
Dries committed
473
  /*
Dries's avatar
 
Dries committed
474
  ** Display the node form extensions:
Dries's avatar
 
Dries committed
475
  */
Dries's avatar
 
Dries committed
476

Dries's avatar
 
Dries committed
477 478
  foreach (module_list() as $name) {
    $output .= module_invoke($name, "node_link", $node);
Dries's avatar
Dries committed
479 480
  }

Dries's avatar
 
Dries committed
481
  return $output;
Dries's avatar
 
Dries committed
482 483 484

}

Dries's avatar
 
Dries committed
485 486
function node_admin_nodes() {
  global $query;
Dries's avatar
 
Dries committed
487

Dries's avatar
 
Dries committed
488
  $queries = array(array("ORDER BY n.created DESC", "new nodes"), array("ORDER BY n.changed DESC", "updated nodes"), array("WHERE n.status = 1 AND n.moderate = 0 ORDER BY n.nid DESC", "published nodes"), array("WHERE n.status = 0 AND n.moderate = 0 ORDER BY n.nid DESC", "non-published nodes"), array("WHERE n.status = 1 AND n.moderate = 1 ORDER BY n.nid DESC", "pending nodes"), array("WHERE n.status = 1 AND n.promote = 1 ORDER BY n.nid DESC", "promoted nodes"));
Dries's avatar
 
Dries committed
489

Dries's avatar
 
Dries committed
490
  $result = db_query("SELECT n.*, u.name, u.uid FROM node n LEFT JOIN users u ON n.uid = u.uid ". $queries[$query ? $query : 1][0] ." LIMIT 50");
Dries's avatar
 
Dries committed
491

Dries's avatar
 
Dries committed
492
  foreach ($queries as $key => $value) {
Dries's avatar
 
Dries committed
493
    $links[] = la($value[1], array("mod" => "node", "op" => "nodes", "query" => $key));
Dries's avatar
Dries committed
494 495
  }

Dries's avatar
 
Dries committed
496
  $output .= "<small>". implode(" :: ", $links) ."</small><hr />";
Dries's avatar
 
Dries committed
497

Dries's avatar
 
Dries committed
498 499 500
  $output .= "<table border=\"1\" cellpadding=\"2\" cellspacing=\"2\">\n";
  $output .= " <tr><th>title</th><th>type</th><th>author</th><th>status</th><th colspan=\"2\">operations</th></tr>\n";
  while ($node = db_fetch_object($result)) {
Kjartan's avatar
Kjartan committed
501
    $output .= "<tr><td>". l(check_output($node->title), array("id" => $node->nid)) ."</td><td>". module_invoke($node->type, "node", "name") ."</td><td nowrap=\"nowrap\">". format_name($node) ."</td><td>". ($node->status ? t("published") : t("not published")) ."</td><td nowrap=\"nowrap\">". la(t("edit node"), array("mod" => "node", "op" => "edit", "id" => $node->nid)) ."</td><td nowrap=\"nowrap\">". la(t("delete node"), array("mod" => "node", "op" => "delete", "id" => $node->nid)) ."</td></tr>";
Dries's avatar
 
Dries committed
502
  }
Dries's avatar
 
Dries committed
503
  $output .= "</table>";
Dries's avatar
 
Dries committed
504

Dries's avatar
 
Dries committed
505
  return $output;
Dries's avatar
Dries committed
506 507
}

Dries's avatar
 
Dries committed
508 509 510 511 512 513 514 515 516 517 518 519
/*
** Return the revision with the specified revision number.
*/

function node_revision_load($node, $revision) {
  return $node->revisions[$revision]["node"];
}

/*
** Create and return a new revision of the given node.
*/

Dries's avatar
 
Dries committed
520 521 522
function node_revision_create($node) {
  global $user;

Dries's avatar
 
Dries committed
523 524 525 526 527
  /*
  ** 'revision' is the name of the field used to indicicate that we
  ** have to create a new revision of a node.
  */

Dries's avatar
 
Dries committed
528
  if ($node->nid && $node->revision) {
Dries's avatar
 
Dries committed
529 530 531 532
    $prev = node_load(array("nid" => $node->nid));
    $node->revisions = $prev->revisions;
    unset($prev->revisions);
    $node->revisions[] = array("uid" => $user->uid, "timestamp" => time(), "node" => $prev, "history" => $node->history);
Dries's avatar
 
Dries committed
533 534 535 536 537
  }

  return $node;
}

Dries's avatar
 
Dries committed
538 539 540
/*
** Roll-back to the revision with the specified revision number.
*/
Dries's avatar
 
Dries committed
541

Dries's avatar
 
Dries committed
542 543
function node_revision_rollback($node, $revision) {
  global $user;
Dries's avatar
 
Dries committed
544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578

  /*
  ** Extract the specified revision:
  */

  $rev = $node->revisions[$revision]["node"];

  /*
  ** Inherit all the past revisions:
  */

  $rev->revisions = $node->revisions;

  /*
  ** Save the original/current node:
  */

  $rev->revisions[] = array("uid" => $user->uid, "timestamp" => time(), "node" => $node);

  /*
  ** Remove the specified revision:
  */

  unset($rev->revisions[$revision]);

  /*
  ** Save the node:
  */

  foreach ($node as $key => $value) {
    $filter[] = $key;
  }

  node_save($rev, $filter);

Dries's avatar
 
Dries committed
579
  watchdog("special", "$node->type: rollbacked to revision #$revision of '$node->title'");
Dries's avatar
 
Dries committed
580 581
}

Dries's avatar
 
Dries committed
582 583 584 585 586
/*
** Delete the revision with specified revision number.
*/

function node_revision_delete($node, $revision) {
Dries's avatar
 
Dries committed
587 588

  unset($node->revisions[$revision]);
Dries's avatar
 
Dries committed
589

Dries's avatar
 
Dries committed
590
  node_save($node, array("nid", "revisions"));
Dries's avatar
 
Dries committed
591

Dries's avatar
 
Dries committed
592
  watchdog("special", "$node->type: removed revision #$revision of '$node->title'");
Dries's avatar
 
Dries committed
593 594
}

Dries's avatar
 
Dries committed
595 596 597 598 599 600 601 602 603 604 605
/*
** Return a list of all the existing revision numbers.
*/

function node_revision_list($node) {
  if (is_array($node->revisions)) {
    return array_keys($node->revisions);
  }
  else {
    return array();
  }
Dries's avatar
 
Dries committed
606 607
}

Dries's avatar
 
Dries committed
608
function node_admin() {
Dries's avatar
 
Dries committed
609
  global $op, $id, $revision, $edit;
Dries's avatar
 
Dries committed
610

Dries's avatar
 
Dries committed
611
  if (user_access("administer nodes")) {
Dries's avatar
 
Dries committed
612

Dries's avatar
 
Dries committed
613 614 615
    /*
    ** Compile a list of the administrative links:
    */
Dries's avatar
Dries committed
616

Dries's avatar
 
Dries committed
617 618 619 620
    $links[] = la(t("nodes"), array("mod" => "node", "op" => "nodes"));
    $links[] = la(t("search content"), array("mod" => "node", "op" => "search"));
    $links[] = la(t("settings"), array("mod" => "node", "op" => "settings"));
    $links[] = la(t("help"), array("mod" => "node", "op" => "help"));
Dries's avatar
 
Dries committed
621

Dries's avatar
 
Dries committed
622
    print "<small>". implode(" &middot; ", $links) ."</small><hr />";
Dries's avatar
 
Dries committed
623 624 625 626 627 628

    switch ($op) {
      case "help":
        print node_help();
        break;
      case "search":
Dries's avatar
 
Dries committed
629
        print search_type("node", drupal_url(array("mod" => "node", "op" => "search"), "admin"));
Dries's avatar
 
Dries committed
630
        break;
Dries's avatar
 
Dries committed
631 632 633 634
      case t("Save configuration"):
      case t("Reset to defaults"):
      case "settings":
        print node_admin_settings($edit);
Dries's avatar
 
Dries committed
635 636
        break;
      case "edit":
Dries's avatar
 
Dries committed
637
        print node_admin_edit($id);
Dries's avatar
 
Dries committed
638
        break;
Dries's avatar
 
Dries committed
639 640 641
      case "delete":
        print node_delete(array("nid" => $id));
        break;
Dries's avatar
 
Dries committed
642
      case "rollback revision":
Dries's avatar
 
Dries committed
643 644
        print node_revision_rollback(node_load(array("nid" => $id)), $revision);
        print node_admin_edit($id);
Dries's avatar
 
Dries committed
645 646
        break;
      case "delete revision":
Dries's avatar
 
Dries committed
647 648
        print node_revision_delete(node_load(array("nid" => $id)), $revision);
        print node_admin_edit($id);
Dries's avatar
 
Dries committed
649
        break;
Dries's avatar
 
Dries committed
650
      case t("Preview"):
Dries's avatar
 
Dries committed
651
        print node_preview($edit);
Dries's avatar
 
Dries committed
652
        break;
Dries's avatar
 
Dries committed
653
      case t("Submit"):
Dries's avatar
 
Dries committed
654 655 656
        print node_submit($edit);
        break;
      case t("Delete"):
Dries's avatar
 
Dries committed
657
        print node_delete($edit);
Dries's avatar
 
Dries committed
658
        break;
Dries's avatar
 
Dries committed
659
      default:
Dries's avatar
 
Dries committed
660
        print node_admin_nodes();
Dries's avatar
 
Dries committed
661 662 663 664
    }
  }
  else {
    print message_access();
Dries's avatar
 
Dries committed
665 666 667
  }
}

Dries's avatar
 
Dries committed
668 669 670 671
function node_block() {
  global $theme;

  $block[0][subject] = t("Syndicate");
Kjartan's avatar
Kjartan committed
672
  $block[0][content] = "<div align=\"center\">". lm("<img src=\"". $theme->image("xml.gif") ."\" width=\"36\" height=\"14\" border=\"0\" alt=\"XML\" />", array("mod" => "node", "op" => "feed"), "", array("title" => t("Read the XML version of this page."))) ."</div>\n";
Dries's avatar
 
Dries committed
673 674 675 676 677
  $block[0][info] = "Syndicate";

  return $block;
}

Kjartan's avatar
Kjartan committed
678 679 680 681 682 683
function node_feed($nodes = 0, $channel = array()) {
  /*
    a generic function for generating rss feeds from a set of nodes.
    $nodes should be an object as returned by db_query() which contains the nid field
    $channel is an associative array containing title, link, and description keys
  */
Dries's avatar
 
Dries committed
684

Kjartan's avatar
Kjartan committed
685 686 687
  if (!$nodes) {
    $nodes = db_query("SELECT nid FROM node WHERE promote = '1' AND status = '1' ORDER BY created DESC LIMIT 15");
  }
Dries's avatar
 
Dries committed
688

Kjartan's avatar
Kjartan committed
689 690 691
  while ($node = db_fetch_object($nodes)) {
    $item = node_load(array("nid" => $node->nid));
    $link = path_uri(). drupal_url(array("id" => $item->nid), "node");
Dries's avatar
 
Dries committed
692
    $items .= format_rss_item($item->title, $link, $item->teaser);
Dries's avatar
 
Dries committed
693 694
  }

Kjartan's avatar
Kjartan committed
695
  $output .= "<?xml version=\"1.0\" ". t("encoding=\"ISO-8859-1\""). "?>\n";
Dries's avatar
 
Dries committed
696
  // $output .= "<!DOCTYPE rss [<!ENTITY % HTMLlat1 PUBLIC \"-//W3C//ENTITIES Latin 1 for XHTML//EN\" \"http://www.w3.org/TR/xhtml1/DTD/xhtml-lat1.ent\">\n";
Kjartan's avatar
Kjartan committed
697 698 699 700 701 702 703
  if (!$channel["version"]) $channel["version"] = "0.91";
  if (!$channel["title"]) $channel["title"] = variable_get("site_name", "drupal") ." - ". variable_get("site_slogan", "");
  if (!$channel["link"]) $channel["link"] = path_uri();
  if (!$channel["description"]) $channel["description"] = variable_get("site_mission", "");
  if (!$channel["language"]) $channel["language"] = "en";
  $output .= "<rss version=\"". $channel["version"] . "\">\n";
  $output .= format_rss_channel($channel["title"], $channel["link"], $channel["description"], $items, $channel["language"]);
Dries's avatar
 
Dries committed
704 705
  $output .= "</rss>\n";

Dries's avatar
 
Dries committed
706
  header("Content-Type: text/xml");
Dries's avatar
 
Dries committed
707 708 709
  print $output;
}

710
function node_validate($node, &$error) {
Dries's avatar
 
Dries committed
711 712 713 714 715 716 717

  global $user;

  /*
  ** Convert the node to an object if necessary:
  */

Dries's avatar
 
Dries committed
718
  $node = array2object($node);
Dries's avatar
 
Dries committed
719 720 721 722 723

  /*
  ** Validate the title field:
  */

Dries's avatar
 
Dries committed
724
  if (isset($node->title) && !$node->title) {
Dries's avatar
 
Dries committed
725 726 727 728 729 730 731 732 733
    $error["title"] = "<div style=\"color: red;\">". t("You have to specify a valid title.") ."</div>";
  }

  if (user_access("administer nodes")) {

    /*
    ** Setup default values if required:
    */

Dries's avatar
 
Dries committed
734 735
    if (!$node->created) {
      $node->created = time();
Dries's avatar
 
Dries committed
736 737
    }

Dries's avatar
 
Dries committed
738 739
    if (!$node->date) {
      $node->date = date("M j, Y g:i a", $node->created);
Dries's avatar
 
Dries committed
740 741 742 743 744 745
    }

    /*
    ** Validate the "authored by"-field:
    */

Dries's avatar
 
Dries committed
746 747 748 749 750 751 752 753 754
    if (empty($node->name)) {
      /*
      ** The use of empty() is mandatory in the context of usernames
      ** as the empty string denotes the anonymous user.  In case we
      ** are dealing with an anomymous user we set the user ID to 0.
      */
      $node->uid = 0;
    }
    else if ($account = user_load(array("name" => $node->name))) {
Dries's avatar
 
Dries committed
755
      $node->uid = $account->uid;
Dries's avatar
 
Dries committed
756 757
    }
    else {
Dries's avatar
 
Dries committed
758
      $error["name"] = "<div style=\"color: red;\">". t("The name '%u' does not exist.", array ("%u" => $node->name)) ."</div>";
Dries's avatar
 
Dries committed
759 760 761 762 763 764
    }

    /*
    ** Validate the "authored on"-field:
    */

Dries's avatar
 
Dries committed
765 766
    if (strtotime($node->date) > 1000) {
      $node->created = strtotime($node->date);
Dries's avatar
 
Dries committed
767 768 769 770
    }
    else {
      $error["date"] = "<div style=\"color: red;\">". t("You have to specifiy a valid date.") ."</div>";
    }
Dries's avatar
 
Dries committed
771

Dries's avatar
 
Dries committed
772 773
  }

Dries's avatar
 
Dries committed
774 775 776 777 778 779 780 781 782
  /*
  ** Do node type specific validation checks.
  */

  $function = $node->type ."_validate";
  if (function_exists($function)) {
    $node = $function($node, $error);
  }

Dries's avatar
 
Dries committed
783
  return $node;
Dries's avatar
 
Dries committed
784 785
}

Dries's avatar
 
Dries committed
786

Dries's avatar
 
Dries committed
787
function node_form($edit, $error = NULL) {
Dries's avatar
 
Dries committed
788

Dries's avatar
 
Dries committed
789 790 791 792 793 794 795
  /*
  ** Save the referer.  We record where the user came from such that we
  ** can redirect him after having completed the node forms.
  */

  referer_save();

Dries's avatar
 
Dries committed
796 797 798 799
  /*
  ** Validate the node:
  */

Dries's avatar
 
Dries committed
800
  if (!$error) {
801 802
    /* Only validate if we don't already know the errors. */
    $edit = node_validate($edit, $error);
Dries's avatar
 
Dries committed
803
  }
Dries's avatar
 
Dries committed
804

Dries's avatar
 
Dries committed
805 806 807 808 809 810 811 812
  /*
  ** Generate a teaser when necessary:
  */

  if ($edit->body && !$edit->teaser) {
    $edit->teaser = node_teaser($edit->body);
  }

Dries's avatar
 
Dries committed
813 814 815 816 817 818
  /*
  ** Get the node specific bits:
  */

  $function = $edit->type ."_form";
  if (function_exists($function)) {
Kjartan's avatar
Kjartan committed
819
    $form .= $function($edit, $help, $error, $param);
Dries's avatar
 
Dries committed
820 821 822 823 824 825 826 827 828 829
  }

  /*
  ** Add the help text:
  */

  if ($help) {
    $output .= "<p>$help</p>";
  }

Dries's avatar
 
Dries committed
830 831 832 833
  $output .= "<table border=\"0\" cellpadding=\"2\" cellspacing=\"2\">";
  $output .= " <tr>";
  $output .= "  <td valign=\"top\">";

Dries's avatar
 
Dries committed
834 835 836 837 838 839 840
  /*
  ** Add the default fields:
  */

  $output .= form_textfield(t("Title"), "title", $edit->title, 60, 64, $error["title"]);

  /*
Dries's avatar
 
Dries committed
841
  ** Add the node specific fields:
Dries's avatar
 
Dries committed
842 843
  */

Dries's avatar
 
Dries committed
844
  $output .= $form;
Dries's avatar
 
Dries committed
845 846 847 848 849 850 851 852 853

  /*
  ** Add the hidden fields:
  */

  if ($edit->nid) {
    $output .= form_hidden("nid", $edit->nid);
  }

Dries's avatar
 
Dries committed
854 855 856 857 858
  if (isset($edit->uid)) {
      /*
      ** The use of isset() is mandatory in the context of user IDs as uid
      ** 0 denotes the anonymous user.
      */
Dries's avatar
 
Dries committed
859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877
    $output .= form_hidden("uid", $edit->uid);
  }

  if ($edit->created) {
    $output .= form_hidden("created", $edit->created);
  }

  $output .= form_hidden("type", $edit->type);

  /*
  ** Add the buttons:
  */

  $output .= form_submit(t("Preview"));

  if ($edit->title && $edit->type && !$error) {
    $output .= form_submit(t("Submit"));
  }

Dries's avatar
 
Dries committed
878
  if ($edit->nid && node_access("delete", $edit)) {
Dries's avatar
 
Dries committed
879 880 881 882 883 884 885 886
    $output .= form_submit(t("Delete"));
  }

  /*
  ** Add the admin specific parts:
  */

  if (user_access("administer nodes")) {
Dries's avatar
 
Dries committed
887
    $output .= "</td><td align=\"left\" valign=\"top\">";
Dries's avatar
 
Dries committed
888 889 890
    $output .= form_textfield(t("Authored by"), "name", $edit->name, 20, 25, $error["name"]);
    $output .= form_textfield(t("Authored on"), "date", $edit->date, 20, 25, $error["date"]);
    $output .= "<br />";
Dries's avatar
 
Dries committed
891
    $output .= form_select(t("Set public/published"), "status", $edit->status, array("Disabled", "Enabled"));
Kjartan's avatar
Kjartan committed
892 893 894 895
    // TODO: move this to the queue.module
    if (module_exist("queue")) {
      $output .= form_select(t("Queue for moderation"), "moderate", $edit->moderate, array("Disabled", "Enabled"));
    }
Dries's avatar
 
Dries committed
896
    $output .= form_select(t("Promote to front page"), "promote", $edit->promote, array("Disabled", "Enabled"));
897
    $output .= form_select(t("Static on front page"), "static", $edit->static, array("Disabled", "Enabled"));
Kjartan's avatar
Kjartan committed
898 899 900 901
    // TODO: move this to the comment.module
    if (module_exist("comment")) {
      $output .= form_select(t("Allow users comments"), "comment", $edit->comment, array("Disabled", "Read only", "Read/Write"));
    }
Dries's avatar
 
Dries committed
902
    $output .= form_select(t("Create new revision"), "revision", $edit->revision, array("Disabled", "Enabled"));
Dries's avatar
 
Dries committed
903 904
  }

Dries's avatar
 
Dries committed
905 906 907 908
  $output .= "  </td>";
  $output .= " </tr>";
  $output .= "</table>";

Kjartan's avatar
Kjartan committed
909
  return form($output, ($param["method"] ? $param["method"] : "post"), $param["action"], $param["options"]);
Dries's avatar
 
Dries committed
910 911 912 913 914
}

function node_add($type) {
  global $user;

Kjartan's avatar
Kjartan committed
915 916 917 918
  if (!user_access("post content")) {
    return message_access();
  }

Dries's avatar
 
Dries committed
919
  /*
Dries's avatar
 
Dries committed
920
  ** If a node type has been specified, validate it existence.  If no
Dries's avatar
 
Dries committed
921 922 923
  ** (valid) node type has been provied, display a node type overview.
  */

Dries's avatar
 
Dries committed
924
  if ($type && node_access("create", $type)) {
925
    // Initialize settings
Kjartan's avatar
Kjartan committed
926
    $output = node_form(array("uid" => $user->uid, "name" => $user->name, "type" => $type, "status" => 1, "promote" => !module_exist("queue"), "moderate" => module_exist("queue"), "comment" => module_exist("queue") ? 2 : 0));
Dries's avatar
 
Dries committed
927 928
  }
  else {
Dries's avatar
 
Dries committed
929

Dries's avatar
 
Dries committed
930 931 932
    /*
    ** Compile a list with the different node types and their explanation:
    */
Dries's avatar
 
Dries committed
933

Dries's avatar
 
Dries committed
934
    foreach (module_list() as $name) {
Dries's avatar
 
Dries committed
935 936
      if (module_hook($name, "node") && node_access("create", array("type" => $name))) {
        $output .= "<li>";
Kjartan's avatar
Kjartan committed
937
        $output .= " ". lm(module_invoke($name, "node", "name"), array("mod" => "node", "op" => "add", "type" => $name), "", array("title" => t("Add a new %s.", array("%s" => module_invoke($name, "node", "name")))));
Dries's avatar
 
Dries committed
938 939
        $output .= " <div style=\"margin-left: 20px;\">". module_invoke($name, "node", "description") ."</div>";
        $output .= "</li>";
Dries's avatar
 
Dries committed
940
      }
Dries's avatar
 
Dries committed
941 942
    }

Dries's avatar
 
Dries committed
943 944
    $output = t("Choose the appropriate item from the list:") ."<ul>$output</ul>";

Dries's avatar
 
Dries committed
945 946 947 948 949 950 951 952
  }

  return $output;
}

function node_edit($id) {
  global $user;

Kjartan's avatar
Kjartan committed
953 954 955 956
  if (!user_access("post content")) {
    return message_access();
  }

Dries's avatar
 
Dries committed
957 958
  $node = node_load(array("nid" => $id));

Dries's avatar
 
Dries committed
959 960 961 962 963 964 965 966
  if (node_access("update", $node)) {
    $output = node_form($node);
  }
  else {
    $output = message_access();
  }

  return $output;
Dries's avatar
 
Dries committed
967 968
}

Dries's avatar
 
Dries committed
969
function node_preview($node, $error = NULL) {
Dries's avatar
 
Dries committed
970

Kjartan's avatar
Kjartan committed
971 972 973 974
  if (!user_access("post content")) {
    return message_access();
  }

Dries's avatar
 
Dries committed
975 976 977 978
  /*
  ** Convert the array to an object:
  */

Dries's avatar
 
Dries committed
979
  $node = array2object($node);
Dries's avatar
 
Dries committed
980 981 982 983 984

  /*
  ** Load the user's name when needed:
  */

Dries's avatar
 
Dries committed
985 986 987 988 989 990 991 992
  if (isset($node->name)) {
    /*
    ** The use of isset() is mandatory in the context of user IDs as uid
    ** 0 denotes the anonymous user.
    */

    if ($user = user_load(array("name" => $node->name))) {
      $node->uid = $user->uid;
Dries's avatar
 
Dries committed
993 994
    }
    else {
Dries's avatar
 
Dries committed
995
      $node->uid = 0; // anonymous user
Dries's avatar
 
Dries committed
996
    }
Dries's avatar
 
Dries committed
997
  }
Dries's avatar
 
Dries committed
998
  else if ($node->uid) {
Dries's avatar
 
Dries committed
999 1000
    $user = user_load(array("uid" => $node->uid));
    $node->name = $user->name;
Dries's avatar
 
Dries committed
1001 1002 1003 1004 1005 1006
  }

  /*
  ** Set the created time when needed:
  */

Dries's avatar
 
Dries committed
1007 1008
  if (empty($node->nid)) {
    $node->created = time();
Dries's avatar
 
Dries committed
1009 1010
  }

Dries's avatar
 
Dries committed
1011 1012 1013 1014
  /*
  ** Apply the required filters:
  */

Dries's avatar
 
Dries committed
1015
  if ($node->nid) {
Dries's avatar
 
Dries committed
1016
    $view = array_merge($node, module_invoke($node->type, "save", "update", $node));
Dries's avatar
 
Dries committed
1017 1018
  }
  else {
Dries's avatar
 
Dries committed
1019
    $view = array_merge($node, module_invoke($node->type, "save", "create", $node));
Dries's avatar
 
Dries committed
1020 1021
  }

Dries's avatar
 
Dries committed
1022 1023 1024 1025
  /*
  ** Display a preview of the node:
  */

Dries's avatar
 
Dries committed
1026
  node_view($view);
Dries's avatar
 
Dries committed
1027

Dries's avatar
 
Dries committed
1028
  return node_form($node, $error);
Dries's avatar
 
Dries committed
1029 1030
}

Dries's avatar
 
Dries committed
1031
function node_submit($node) {
1032
  global $user, $theme;
Dries's avatar
 
Dries committed
1033

1034
  if (user_access("post content")) {
Dries's avatar
 
Dries committed
1035

Dries's avatar
 
Dries committed
1036