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

4
function node_help($section = "admin/node/help") {
Dries's avatar
   
Dries committed
5
  global $mod;
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
  $output = "";

  switch ($section) {

    case 'admin/help':
    case 'admin/node/help':
      $output .= "<h3>Nodes</h3>";
      $output .= "<p>The core of the Drupal system is the node. All of the contents of the system are placed in nodes, or extensions of nodes.";
      $output .= "A base node contains:<dl>";
      $output .= "<dt>A Title</dt><dd>Up to 128 characters of text that titles the node.</dd>";
      $output .= strtr("<dt>A Teaser</dt><dd>A small block of text that is meant to get you interested in the rest of node. Drupal will automatically pull a small amount of the body of the node to make the teaser (To configure how long the teaser will be %teaser). The teaser can be changed if you don't like what Drupal grabs.</dd>", array("%teaser" => l(t("click here"), "admin/system/modules/node") ));
      $output .= "<dt>The Body</dt><dd>The main text that comprises your content.</dd>";
      $output .= "<dt>A Type</dt><dd>What kind of node is this? Blog, book, forum, comment, unextended, etc.</dd>";
      $output .= "<dt>An Author</dt><dd>The author's name. It will either be \"anonymous\" or a valid user. You <i>cannot</i> set it to an arbitrary value.</dd>";
      $output .= "<dt>Authored on</dt><dd>The date the node was written.</dd>";
      $output .= "<dt>Changed</dt><dd>The last time this node was changed.</dd>";
      $output .= strtr("<dt>Static on front page</dt><dd>The front page is configured to show the teasers from only a few of the total nodes you have on your site (To configure how many teasers %teaser), but if you think a node is important enough that you want it to stay on the front page enable this.</dd>",array("%teaser" => l(t("click here"),"admin/system/modules/node") ));
      $output .= "<dt>Allow user comments</dt><dd>A node can have comments. These comments can be written by other users (Read-write), or only by admins (Read-only).</dd>";
      $output .= "<dt>Attributes</dt><dd>A way to sort nodes.</dd>";
      $output .= "<dt>Revisions</dt><dd>Drupal has a revision system so that you can \"roll back\" to an older version of a node if the new version is not what you want.</dd>";
      $output .= "<dt>Promote to front page</dt><dd>To get people to look at the new stuff on your site you can choose to move it to the front page.</dd>";
      $output .= "<dt>In moderation queue</dt><dd>Drupal has a moderation system. If it is active, a node is in one of three states: approved and published, approved and unpublished, and awaiting approval. If you are moderating a node it should be in the moderation queue.</dd>";
      $output .= strtr("<dt>Votes</dt><dd>If you are moderating a node this counts how many votes the node has gotten. Once a node gets a certain number of vote if will either be Approved, or Dropped (To setup the number of votes needed and the promote and dump scores %queue.)</a>.</dd>",array("%queue" => l(t("click here"), "admin/system/modules/queue") ));
      $output .= "<dt>Score</dt><dd>The score of the node is gotten by the votes it is given.</dd>";
      $output .= "<dt>Users</dt><dd>The list of users who have voted on a moderated node.</dd>";
      $output .= "<dt>Published</dt><dd>When using Drupal's moderation system a node remains unpublished -- unavaliable to non-moderators -- until it is marked Published.</dd></dl>";
      $output .= "<p>Now that you know what is in a node, here are some of the types of nodes available.</p>";

      if ($mod == "admin") {
        foreach (module_list() as $name) {
          if (module_hook($name, "node") && $name != "node") {
            $output .= "<h3>". t("Node type: %module", array("%module" => module_invoke($name, "node", "name"))). "</h3>";
            $output .= module_invoke($name, "node", "description");
          }
        }
Dries's avatar
   
Dries committed
41
      }
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
      break;

    case 'admin/system/modules':
      $output = "The core that allows content to be submitted to the site.";
      break;
    case 'admin/system/modules/node':
      $output = "Settings for the core of Drupal. Almost everything is a node so these settings will affect most of the site.";
      break;
    case 'admin/node':
      $output = strtr("Below is a list of all of the nodes in your site. Other forms of content are listed elsewhere (e.g. %comment).<br />Clicking a title views that node, while clicking an author's name edits their user information.<br />Other node-related tasks are available from the menu on the left.",array("%comments" => l(t("comments"), "admin/comment") ));
      break;
    case 'admin/node/search':
      $output = "Enter a simple pattern to search for a post. This can include the wildcard character *.<br />For example, a search for \"br*\" might return \"bread bakers\", \"our daily bread\" and \"brenda\".";
      break;
    case 'admin/node/settings':
      $output = "This pages lets you set the defaults used during creation of nodes for all the different node types.<br /><b>comment:</b> Read/write setting for comments.<br /><b>publish:</b> Is this node publicly viewable, has it been published?<br /><b>promote:</b> Is this node to be promoted to the front page?<br /><b>moderate:</b> Does this node need approval before it can be viewed?<br /><b>static:</b> Is this node always visible on the front page?<br /><b>revision:</b> Will this node go into the revision system allowing multiple versions to be saved?";
      break;

Dries's avatar
   
Dries committed
60
  }
Dries's avatar
   
Dries committed
61
  return t($output);
Dries's avatar
   
Dries committed
62
63
}

64
function node_system($field){
65
66
67
68
69
70
  $output = "";

  if ($field == "description") {$output = node_help("admin/system/modules"); }
  else if ($field == "admin-help") {$output = node_help("admin/system/modules/node");};

  return $output;
71
72
}

Dries's avatar
   
Dries committed
73
74
75
76
/*
** Accepts a DB result object which can be used to fetch node objects.
** Returns an HTML list suitable as content for a block.
*/
Dries's avatar
   
Dries committed
77
78
function node_title_list($result, $title = NULL) {
  while ($node = db_fetch_object($result)) {
Dries's avatar
   
Dries committed
79
    $number = module_invoke("comment", "num_all", $node->nid);
Dries's avatar
   
Dries committed
80
    $items[] = l($node->title, node_url($node), array("title" => format_plural($number, "%count comment", "%count comments")));
Dries's avatar
   
Dries committed
81
82
  }

Dries's avatar
   
Dries committed
83
84
85
  return theme("theme_node_list", $items, $title);
}

Dries's avatar
   
Dries committed
86
87
function theme_node_list($items, $title = NULL) {
  return theme("theme_item_list", $items, $title);
Dries's avatar
   
Dries committed
88
89
}

Dries's avatar
   
Dries committed
90
91
92
93
94
// Update the 'last viewed' timestamp of the specified node for current user.
function node_tag_new($nid) {
  global $user;

  if ($user->uid) {
Dries's avatar
   
Dries committed
95
    $result = db_query("SELECT timestamp FROM {history} WHERE uid = %d AND nid = %d", $user->uid, $nid);
Dries's avatar
   
Dries committed
96
    if (db_fetch_object($result)) {
Dries's avatar
   
Dries committed
97
      db_query("UPDATE {history} SET timestamp = %d WHERE uid = %d AND nid = %d", time(), $user->uid, $nid);
Dries's avatar
   
Dries committed
98
99
    }
    else {
Dries's avatar
   
Dries committed
100
      db_query("INSERT INTO {history} (uid, nid, timestamp) VALUES (%d, %d, %d)", $user->uid, $nid, time());
Dries's avatar
   
Dries committed
101
102
103
104
105
106
107
108
109
110
111
    }
  }
}

/*
** Retrieves the timestamp at which the current user last viewed the
** specified node.
*/
function node_last_viewed($nid) {
  global $user;

Dries's avatar
   
Dries committed
112
  $history = db_fetch_object(db_query("SELECT timestamp FROM {history} WHERE uid = '$user->uid' AND nid = %d", $nid));
Dries's avatar
   
Dries committed
113
114
115
116
117
118
119
120
121
122
123
124
125
  return ($history->timestamp ? $history->timestamp : 0);
}

/**
 * Determines whether the supplied timestamp is newer than the user's last view of a given node
 *
 * @param $nid       node-id twhose history supplies the 'last viewed' timestamp
 * @param $timestamp time which is compared against node's 'last veiwed' timestamp
*/
function node_is_new($nid, $timestamp) {
  global $user;
  static $cache;

Dries's avatar
Dries committed
126
  if (!isset($cache[$nid])) {
Dries's avatar
   
Dries committed
127
    if ($user->uid) {
Dries's avatar
   
Dries committed
128
      $history = db_fetch_object(db_query("SELECT timestamp FROM {history} WHERE uid = %d AND nid = %d", $user->uid, $nid));
Dries's avatar
   
Dries committed
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
      $cache[$nid] = $history->timestamp ? $history->timestamp : 0;
    }
    else {
      $cache[$nid] = time();
    }
  }

  if ($timestamp > $cache[$nid]) {
    return 1;
  }
  else {
    return 0;
  }
}

Dries's avatar
   
Dries committed
144
145
function node_teaser($body) {

Dries's avatar
   
Dries committed
146
147
148
149
150
151
152
153
154
155
  $size = variable_get("teaser_length", 600);

  /*
  ** If the size is zero, teasers are disabled so we
  ** return the entire body.
  */

  if ($size == 0) {
    return $body;
  }
Dries's avatar
   
Dries committed
156
157

  /*
Dries's avatar
   
Dries committed
158
  ** If a valid delimiter has been specified, use it to
Dries's avatar
   
Dries committed
159
160
  ** chop of the teaser.  The delimiter can be outside
  ** the allowed range but no more than a factor two.
Dries's avatar
   
Dries committed
161
162
  */

Dries's avatar
Dries committed
163
  $delimiter = strpos($body, "<!--break-->");
Dries's avatar
   
Dries committed
164
  if ($delimiter > 0) {
Dries's avatar
   
Dries committed
165
166
167
    return substr($body, 0, $delimiter);
  }

Dries's avatar
   
Dries committed
168
169
170
171
172
173
174
175
  /*
  ** If we have a short body, return the entire body:
  */

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

Dries's avatar
   
Dries committed
176
177
178
179
  /*
  ** In some cases no delimiter has been specified (eg.
  ** when posting using the Blogger API) in which case
  ** we try to split at paragraph boundaries.
Dries's avatar
   
Dries committed
180
181
  */

Dries's avatar
   
Dries committed
182
  if ($length = strpos($body, "<br />", $size)) {
Dries's avatar
   
Dries committed
183
    return substr($body, 0, $length);
Dries's avatar
   
Dries committed
184
185
186
  }

  if ($length = strpos($body, "<br>", $size)) {
Dries's avatar
   
Dries committed
187
    return substr($body, 0, $length);
Dries's avatar
   
Dries committed
188
189
190
  }

  if ($length = strpos($body, "</p>", $size)) {
Dries's avatar
   
Dries committed
191
192
193
194
195
    return substr($body, 0, $length);
  }

  if ($length = strpos($body, "\n", $size)) {
    return substr($body, 0, $length);
Dries's avatar
   
Dries committed
196
197
  }

Dries's avatar
   
Dries committed
198
  /*
Dries's avatar
   
Dries committed
199
  ** When even the first paragraph is too long, try to
Dries's avatar
   
Dries committed
200
  ** split at the end of the next sentence.
Dries's avatar
   
Dries committed
201
202
  */

Dries's avatar
   
Dries committed
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
  if ($length = strpos($body, ". ", $size)) {
    return substr($body, 0, $length + 1);
  }

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

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

  /*
  ** Nevermind, we split it the hard way ...
  */
Dries's avatar
   
Dries committed
218

Dries's avatar
   
Dries committed
219
  return substr($body, 0, $size);
Dries's avatar
   
Dries committed
220
221
}

222
function node_invoke(&$node, $hook, $arg = 0) {
Dries's avatar
   
Dries committed
223
  if (is_array($node)) {
224
    $function = $node["type"] ."_$hook";
Dries's avatar
   
Dries committed
225
226
  }
  else if (is_object($node)) {
227
    $function = $node->type ."_$hook";
Dries's avatar
   
Dries committed
228
229
  }
  else if (is_string($node)) {
230
    $function = $node ."_$hook";
Dries's avatar
   
Dries committed
231
232
233
234
235
236
237
  }

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

238
function node_invoke_all(&$node, $hook, $op, $arg = 0) {
239
240
  $return = array();
  foreach (module_list() as $name) {
241
    if ((module_hook($name, "node") || module_hook($name, "nodeapi")) && module_hook($name, $hook)) {
242
243
244
245
246
247
248
249
250
251
      $function = $name ."_". $hook;
      $result = $function($node, $op, $arg);
      if (isset($result)) {
        $return = array_merge($return, $result);
      }
    }
  }
  return $return;
}

Dries's avatar
   
Dries committed
252
function node_load($conditions, $revision = -1) {
Dries's avatar
   
Dries committed
253
254
255
256
257
258
259
260
261
262
263
264
265

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

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

  /*
  ** Retrieve the node:
  */

Dries's avatar
   
Dries committed
266
  $node = db_fetch_object(db_query("SELECT n.*, u.uid, u.name FROM {node} n INNER JOIN {users} u ON u.uid = n.uid WHERE ". implode(" AND ", $cond)));
Dries's avatar
   
Dries committed
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286

  /*
  ** 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;
    }
  }

Dries's avatar
   
Dries committed
287
288
289
290
291
292
293
  /*
  ** Return the desired revision
  */
  if ($revision != -1 && isset($node->revisions[$revision])) {
    $node = $node->revisions[$revision]["node"];
  }

Dries's avatar
   
Dries committed
294
295
296
  return $node;
}

297
function node_save($node) {
Dries's avatar
   
Dries committed
298

299
300
301
302
  /*
  ** Fetch fields to save to node table:
  */
  $fields = node_invoke_all($node, "nodeapi", "fields");
Dries's avatar
   
Dries committed
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321

  /*
  ** 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
322
    // Set some required fields:
323
324
325
    if (!$node->created) {
      $node->created = time();
    }
Dries's avatar
   
Dries committed
326
    $node->changed = time();
Dries's avatar
   
Dries committed
327
    $node->nid = db_next_id("node_nid");
Dries's avatar
   
Dries committed
328

Dries's avatar
   
Dries committed
329
    // Prepare the query:
Dries's avatar
   
Dries committed
330
331
332
    foreach ($node as $key => $value) {
      if (in_array($key, $fields)) {
        $k[] = check_query($key);
Dries's avatar
   
Dries committed
333
334
        $v[] = $value;
        $s[] = "'%s'";
Dries's avatar
   
Dries committed
335
336
337
      }
    }

Dries's avatar
   
Dries committed
338
339
340
341
    $keysfmt = implode(", ", $s);
    // need to quote the placeholders for the values
    $valsfmt = "'". implode("', '", $s) ."'";

Dries's avatar
   
Dries committed
342
    // Insert the node into the database:
Dries's avatar
   
Dries committed
343
    db_query("INSERT INTO {node} (". implode(", ", $k) .") VALUES(". implode(", ", $s) .")", $v);
Dries's avatar
   
Dries committed
344

Dries's avatar
   
Dries committed
345
    // Call the node specific callback (if any):
346
347
    node_invoke($node, "insert");
    node_invoke_all($node, "nodeapi", "insert");
Dries's avatar
   
Dries committed
348
349
350
351
352
353
354
  }
  else {

    /*
    ** Update an existing node:
    */

Dries's avatar
   
Dries committed
355
    // Set some required fields:
Dries's avatar
   
Dries committed
356
357
    $node->changed = time();

Dries's avatar
   
Dries committed
358
    // Prepare the query:
Dries's avatar
   
Dries committed
359
360
    foreach ($node as $key => $value) {
      if (in_array($key, $fields)) {
Dries's avatar
   
Dries committed
361
362
        $q[] = check_query($key) ." = '%s'";
        $v[] = $value;
Dries's avatar
   
Dries committed
363
364
365
      }
    }

Dries's avatar
   
Dries committed
366
    // Update the node in the database:
Dries's avatar
   
Dries committed
367
    db_query("UPDATE {node} SET ". implode(", ", $q) ." WHERE nid = '$node->nid'", $v);
Dries's avatar
   
Dries committed
368

Dries's avatar
   
Dries committed
369
    // Call the node specific callback (if any):
370
371
    node_invoke($node, "update");
    node_invoke_all($node, "nodeapi", "update");
Dries's avatar
   
Dries committed
372
373
  }

Dries's avatar
   
Dries committed
374
  /*
Dries's avatar
   
Dries committed
375
376
  ** Clear the cache so an anonymous poster can see the node being
  ** added or updated.
Dries's avatar
   
Dries committed
377
378
379
380
  */

  cache_clear_all();

Dries's avatar
   
Dries committed
381
382
383
384
385
386
387
388
389
  /*
  ** Return the node ID:
  */

  return $node->nid;

}

function node_view($node, $main = 0) {
Dries's avatar
   
Dries committed
390

Dries's avatar
   
Dries committed
391
  $node = array2object($node);
Dries's avatar
   
Dries committed
392

Dries's avatar
   
Dries committed
393
394
  /*
  ** Remove the delimiter (if any) that seperates the teaser from the
Dries's avatar
Dries committed
395
  ** body. TODO: this strips legitimate uses of '<!--break-->' also.
Dries's avatar
   
Dries committed
396
397
  */

Dries's avatar
Dries committed
398
  $node->body = str_replace("<!--break-->", "", $node->body);
Dries's avatar
   
Dries committed
399

Dries's avatar
   
Dries committed
400
401
402
403
404
405
406
407
408
409
410
411
412
413
  /*
  ** 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:
    */

Dries's avatar
   
Dries committed
414
415
    $node->teaser = check_output($node->teaser);
    $node->body = check_output($node->body);
Dries's avatar
   
Dries committed
416

Dries's avatar
   
Dries committed
417
    theme("node", $node, $main);
Dries's avatar
   
Dries committed
418
419
420
  }
}

Dries's avatar
   
Dries committed
421
422
function node_show($node, $cid) {

Dries's avatar
   
Dries committed
423
424
425
426
427
428
429
  if (node_access("view", $node)) {

    node_view($node);

    if (function_exists("comment_render") && $node->comment) {
      comment_render($node, $cid);
    }
Dries's avatar
   
Dries committed
430
431
432
433
434
435

    /*
    ** Update the history table, stating that this user viewed this node.
    */

    node_tag_new($node->nid);
Dries's avatar
   
Dries committed
436
437
438
  }
}

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

Dries's avatar
   
Dries committed
441
442
  if (user_access("administer nodes")) {
    return 1;
Dries's avatar
   
Dries committed
443
444
  }

Dries's avatar
   
Dries committed
445
446
447
  /*
  ** Convert the node to an object if necessary:
  */
Dries's avatar
   
Dries committed
448

Dries's avatar
   
Dries committed
449
  $node = array2object($node);
Dries's avatar
   
Dries committed
450

Dries's avatar
   
Dries committed
451
452
453
  /*
  ** Construct a function:
  */
Dries's avatar
   
Dries committed
454

Dries's avatar
   
Dries committed
455
456
457
458
459
460
  if ($node->type) {
    $type = $node->type;
  }
  else {
    $type = $node;
  }
Dries's avatar
   
Dries committed
461

Dries's avatar
   
Dries committed
462
  $function = $type ."_access";
Dries's avatar
   
Dries committed
463

Dries's avatar
   
Dries committed
464
465
466
467
468
  if (function_exists($function)) {
    return $function($op, $node);
  }
  else {
    return 0;
Dries's avatar
   
Dries committed
469
470
471
  }
}

Dries's avatar
   
Dries committed
472
function node_perm() {
Dries's avatar
   
Dries committed
473
  return array("administer nodes", "access content", "create custom URLs");
Dries's avatar
   
Dries committed
474
475
}

Dries's avatar
   
Dries committed
476
477
function node_search($keys) {

Kjartan's avatar
Kjartan committed
478
479
480
481
482
483
484
485
486
487
488
489
  // 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
490
  // table to the data that the search_index table has in it, and the the
Kjartan's avatar
Kjartan committed
491
492
  // do_search functino will rank it.
  //
Dries's avatar
   
Dries committed
493
  // The select must always provide the following fields - lno, title,
Kjartan's avatar
Kjartan committed
494
495
  // created, uid, name, count
  //
Dries's avatar
   
Dries committed
496
  $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 INNER 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
497

Dries's avatar
   
Dries committed
498
499
500
  return $find;
}

501
function node_settings() {
Dries's avatar
   
Dries committed
502
  $output .= form_select(t("Number of posts on main page"), "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 posts to display per page on overview pages such as the main page."));
Dries's avatar
   
Dries committed
503
  $output .= form_select(t("Length of trimmed posts"), "teaser_length", variable_get("teaser_length", 600), array(0 => t("Unlimited"), 200 => t("200 characters"), 400 => t("400 characters"), 600 => t("600 characters"), 800 => t("800 characters"), 1000 => t("1000 characters"), 1200 => t("1200 characters"), 1400 => t("1400 characters"), 1600 => t("1600 characters"), 1800 => t("1800 characters"), 2000 => t("2000 characters")), t("The maximum number of characters used in the trimmed version of a post.  Drupal will use this setting to determine at which offset long posts should be trimmed.  The trimmed version of a post is typically used as a teaser when displaying the post on the main page, in XML feeds, etc.  To disable teasers, set to 'Unlimited'."));
Dries's avatar
   
Dries committed
504
  $output .= form_select(t("Preview post"), "node_preview", variable_get("node_preview", 0), array(t("Optional"), t("Required")), t("Must users preview posts before submitting?"));
Dries's avatar
   
Dries committed
505

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

Dries's avatar
CHANGES    
Dries committed
509
function node_conf_filters() {
Dries's avatar
   
Dries committed
510
  $output .= form_select(t("Filter HTML tags"), "filter_html", variable_get("filter_html", 0), array(t("Disabled"), t("Enabled")), t("Filter HTML and PHP tags in user-contributed content."));
Dries's avatar
   
Dries committed
511
  $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
512
  $output .= form_select(t("Rewrite old URLs"), "rewrite_old_urls", variable_get("rewrite_old_urls", 0), array(t("Disabled"), t("Enabled")), t("The introduction of 'clean URLs' in Drupal 4.2.0 breaks internal URLs that date back from Drupal 4.1.0 and before.  If enabled, this filter will attempt to rewrite the old style URLs to avoid broken links.  If <code>mod_rewrite</code> is available on your system, use the rewrite rules in Drupal's <code>.htaccess</code> file instead as these will also correct external referrers."));
Dries's avatar
   
Dries committed
513
  $output .= "<hr />";
Dries's avatar
CHANGES    
Dries committed
514
515
516
517
518
519
520
521
522
  return $output;
}

function node_filter_html($text) {
  $text = strip_tags($text, variable_get("allowed_html", ""));
  return $text;
}

function node_filter_link($text) {
523
524
  $pat = '\[{2}([^\|]+)(\|([^\|]+)?)?\]{2}';                   // [link|description]
  return ereg_replace($pat, $dst, $text);
Dries's avatar
   
Dries committed
525
526
}

Dries's avatar
   
Dries committed
527
function node_comment_mode($nid) {
Dries's avatar
   
Dries committed
528
529
  static $comment_mode;
  if (!isset($comment_mode[$nid])) {
Dries's avatar
   
Dries committed
530
    $comment_mode[$nid] = db_result(db_query("SELECT comment FROM {node} WHERE nid = %d", $nid));
Dries's avatar
   
Dries committed
531
532
  }
  return $comment_mode[$nid];
Dries's avatar
   
Dries committed
533
534
}

Dries's avatar
CHANGES    
Dries committed
535
function node_filter($text) {
Dries's avatar
   
Dries committed
536
537
538
539
540
541
542
  if (variable_get("filter_html", 0)) {
    $text = node_filter_html($text);
  }

  if (variable_get("rewrite_old_urls", 0)) {
    $text = rewrite_old_urls($text);
  }
Dries's avatar
   
Dries committed
543
544

  return trim($text);
Dries's avatar
CHANGES    
Dries committed
545
546
}

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

Dries's avatar
   
Dries committed
549
550
  $links = array();

Dries's avatar
   
Dries committed
551
  if ($type == "page") {
Dries's avatar
   
Dries committed
552
    $links[] = l(t("submit"), "node/add", array("title" => t("Submit or suggest new content.")));
Dries's avatar
   
Dries committed
553
554
  }

Dries's avatar
   
Dries committed
555
  if ($type == "node") {
Kjartan's avatar
Kjartan committed
556
557
558
    if ($node->links) {
      $links = $node->links;
    }
Dries's avatar
   
Dries committed
559

Dries's avatar
   
Dries committed
560
561
562
563
    if ($main == 1 && $node->teaser && strlen($node->teaser) != strlen($node->body))
 {
      $links[] = l(t("read more"), "node/view/$node->nid", array("title" => t("Read
the rest of this posting."), "class" => "read-more"));
Dries's avatar
   
Dries committed
564
    }
Dries's avatar
   
Dries committed
565
566

    if (user_access("administer nodes")) {
Dries's avatar
   
Dries committed
567
       $links[] = l(t("administer"), "admin/node/edit/$node->nid", array("title" => t("Administer this node.")));
Dries's avatar
   
Dries committed
568
    }
Dries's avatar
   
Dries committed
569
570
  }

Dries's avatar
   
Dries committed
571
  if ($type == "admin" && user_access("administer nodes")) {
572
573
574

    menu("admin/node", "content management", "node_admin", node_help("admin/node"));
    menu("admin/node/search", "search posts", "node_admin", node_help("admin/node/search"), 8);
Dries's avatar
   
Dries committed
575
576
    menu("admin/node/help", "help", "node_help", NULL, 9);
    menu("admin/node/edit", "edit node", "node_admin", NULL, 0, 1);
577
    menu("admin/node/settings", "content settings", "node_admin", node_help("admin/node/settings"), 8);
Dries's avatar
   
Dries committed
578
579
  }

Dries's avatar
   
Dries committed
580
  return $links;
Dries's avatar
   
Dries committed
581
582
}

Dries's avatar
   
Dries committed
583
function node_admin_edit($node) {
Dries's avatar
   
Dries committed
584

Dries's avatar
   
Dries committed
585
  if (is_numeric($node)) {
Dries's avatar
   
Dries committed
586
    $node = node_load(array("nid" => $node));
Dries's avatar
   
Dries committed
587
  }
Dries's avatar
   
Dries committed
588

Dries's avatar
   
Dries committed
589
590
591
  /*
  ** Edit node:
  */
Dries's avatar
   
Dries committed
592

Dries's avatar
   
Dries committed
593
  $output .= "<h3>". t("Edit %module", array("%module" => module_invoke($node->type, "node", "name"))) ."</h3>";
Dries's avatar
   
Dries committed
594

Dries's avatar
   
Dries committed
595
  $output .= node_form($node);
Dries's avatar
   
Dries committed
596

Dries's avatar
   
Dries committed
597
598
599
600
601
602
603
  /*
  ** Edit revisions:
  */

  if ($node->revisions) {
    $output .= "<h3>". t("Edit revisions") ."</h3>";
    $output .= "<table border=\"1\" cellpadding=\"2\" cellspacing=\"2\">";
Dries's avatar
   
Dries committed
604
    $output .= " <tr><th>". t("older revisions") ."</th><th colspan=\"3\">". t("operations") ."</th></tr>";
Dries's avatar
   
Dries committed
605
    foreach ($node->revisions as $key => $revision) {
Dries's avatar
   
Dries committed
606
      $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"), node_url($node), array(), "revision=$key") ."</td><td>". l(t("rollback revision"), "admin/node/rollback+revision/$node->nid/$key") ."</td><td>". l(t("delete revision"), "admin/node/delete+revision/$node->nid/$key") ."</td></tr>";
Dries's avatar
   
Dries committed
607
608
609
610
    }
    $output .= "</table>";
  }

Dries's avatar
   
Dries committed
611
  /*
Dries's avatar
   
Dries committed
612
  ** Display the node form extensions:
Dries's avatar
   
Dries committed
613
  */
Dries's avatar
   
Dries committed
614

Dries's avatar
   
Dries committed
615
616
  foreach (module_list() as $name) {
    $output .= module_invoke($name, "node_link", $node);
Dries's avatar
Dries committed
617
618
  }

Dries's avatar
   
Dries committed
619
  return $output;
Dries's avatar
   
Dries committed
620
621
622

}

Dries's avatar
   
Dries committed
623
function node_admin_nodes() {
Dries's avatar
   
Dries committed
624
625
626
627
628
629
630
631
632
633
  $filters = array(
    array(t("View posts that are new or updated"), "ORDER BY n.changed DESC"),
    array(t("View posts that need approval"), "WHERE n.status = 0 OR n.moderate = 1 ORDER BY n.changed DESC"),
    array(t("View posts that are promoted"), "WHERE n.status = 1 AND n.promote = 1 ORDER BY n.changed DESC"),
    array(t("View posts that are not promoted"), "WHERE n.status = 1 AND n.promote = 0 ORDER BY n.changed DESC"),
    array(t("View posts that are static"), "WHERE n.status = 1 AND n.static = 1 ORDER BY n.changed DESC"),
    array(t("View posts that are unpublished"), "WHERE n.status = 0 AND n.moderate = 0 ORDER BY n.changed DESC")
   );

  $operations = array(
Dries's avatar
   
Dries committed
634
    array(t("Approve the selected posts"), "UPDATE {node} SET status = 1, moderate = 0 WHERE nid = %d"),
Dries's avatar
   
Dries committed
635
636
637
    array(t("Promote the selected posts"), "UPDATE {node} SET status = 1, promote = 1 WHERE nid = %d"),
    array(t("Make the selected posts static"), "UPDATE {node} SET status = 1, static = 1 WHERE nid = %d"),
    array(t("Demote the selected posts"), "UPDATE {node} SET promote = 0 WHERE nid = %d"),
Dries's avatar
   
Dries committed
638
    array(t("Unpublish the selected posts"), "UPDATE {node} SET status = 0 WHERE nid = %d")
Dries's avatar
   
Dries committed
639
  );
Dries's avatar
   
Dries committed
640

Dries's avatar
   
Dries committed
641
642
643
644
645
646
647
648
  /*
  ** Handle operations:
  */

  if (empty($_SESSION["node-overview-filter"])) {
    $_SESSION["node-overview-filter"] = 0;
  }

Dries's avatar
   
Dries committed
649
  if (isset($_POST["edit"]["filter"])) {
Dries's avatar
   
Dries committed
650
651
652
    $_SESSION["node-overview-filter"] = $_POST["edit"]["filter"];
  }

Dries's avatar
   
Dries committed
653
  if (isset($_POST["edit"]["operation"])) {
Dries's avatar
   
Dries committed
654
655
656
    $operation = $operations[$_POST["edit"]["operation"]][1];
    foreach ($_POST["edit"]["status"] as $nid => $value) {
      if ($value) {
Dries's avatar
Dries committed
657
        db_query($operation, $nid);
Dries's avatar
   
Dries committed
658
659
660
661
662
663
664
      }
    }

    $output = status(t("the update has been performed."));
  }

  $filter = $_SESSION["node-overview-filter"];
Dries's avatar
Dries committed
665

Dries's avatar
   
Dries committed
666
667
668
669
670
671
672
673
  /*
  ** Render filter form:
  */

  $options = array();
  foreach ($filters as $key => $value) {
    $options[] = $value[0];
  }
Dries's avatar
   
Dries committed
674

Dries's avatar
   
Dries committed
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
  $form  = form_select(NULL, "filter", $filter, $options);
  $form .= form_submit(t("Go"));

  $output .= "<h3>". t("Filter options") ."</h3>";
  $output .= "<div class=\"container-inline\">$form</div>";

  /*
  ** Render operations form:
  */

  $options = array();
  foreach ($operations as $key => $value) {
    $options[] = $value[0];
  }

  $form = form_select(NULL, "operation", 0, $options);
  $form .= form_submit(t("Go"));

  $output .= "<h3>". t("Update options") ."</h3>";
  $output .= "<div class=\"container-inline\">$form</div>";

  /*
  ** Overview table:
  */

Dries's avatar
   
Dries committed
700
  $result = pager_query("SELECT n.*, u.name, u.uid FROM {node} n INNER JOIN {users} u ON n.uid = u.uid ". $filters[$filter][1], 50);
Dries's avatar
   
Dries committed
701
  $header = array(NULL, t("title"), t("type"), t("author"), t("status"), array ("data" => t("operations"), "colspan" => 2));
Dries's avatar
   
Dries committed
702

Dries's avatar
   
Dries committed
703
  while ($node = db_fetch_object($result)) {
Dries's avatar
   
Dries committed
704
    $rows[] = array(form_checkbox(NULL, "status][$node->nid", 1, 0), l($node->title, node_url($node)) ." ". (node_is_new($node->nid, $node->changed) ? theme_mark() : ""), module_invoke($node->type, "node", "name"), format_name($node), ($node->status ? t("published") : t("not published")), l(t("edit node"), "admin/node/edit/$node->nid"), l(t("delete node"), "admin/node/delete/$node->nid"));
Dries's avatar
   
Dries committed
705
  }
Dries's avatar
   
Dries committed
706

Dries's avatar
   
Dries committed
707
708
709
  if ($pager = pager_display(NULL, 50, 0, "admin")) {
    $rows[] = array(array("data" => $pager, "colspan" => 6));
  }
Dries's avatar
   
Dries committed
710

Dries's avatar
   
Dries committed
711
712
713
  $output .= "<h3>". $filters[$filter][0] ."</h3>";
  $output .= table($header, $rows);
  return form($output);
Dries's avatar
Dries committed
714
715
}

716
function node_admin_settings($edit) {
Dries's avatar
   
Dries committed
717
  $op = $_POST["op"];
Kjartan's avatar
Kjartan committed
718

719
720
721
722
723
724
725
726
  if ($op == t("Save configuration")) {
    /*
    ** Save the configuration options:
    */

    foreach ($edit as $name => $value) {
      variable_set($name, $value);
    }
727
    $output = status(t("the content settings have been saved."));
728
729
730
731
732
733
734
735
736
737
  }

  if ($op == t("Reset to defaults")) {
    /*
    ** Reset the configuration options to their default value:
    */

    foreach ($edit as $name => $value) {
      variable_del($name);
    }
738
    $output = status(t("the content settings have been reset to their default values."));
739
740
  }

Dries's avatar
   
Dries committed
741
  $header = array_merge(array(t("type")), array_keys(node_invoke_all($node, "nodeapi", "settings")));
742
743
744
745
746
747
748
749
750
751
  foreach (module_list() as $name) {
    if (module_hook($name, "node")) {
      $node->type = $name;
      $cols = array();
      foreach (node_invoke_all($node, "nodeapi", "settings") as $setting) {
        $cols[] = array("data" => $setting, "align" => "center", "width" => 55);
      }
      $rows[] = array_merge(array(module_invoke($name, "node", "name")), $cols);
    }
  }
Kjartan's avatar
Kjartan committed
752

753
  $output .= table($header, $rows);
754

755
  /* This is an idea for the future.
756
757
758
  foreach (module_list() as $name) {
    if (module_hook($name, "node")) {
      $node->type = $name;
Kjartan's avatar
Kjartan committed
759

760
761
762
763
764
765
766
767
768
769
      // Create table() data:
      $header = array_keys(node_invoke_all($node, "nodeapi", "settings"));
      $cols = array();
      foreach (node_invoke_all($node, "nodeapi", "settings") as $setting) {
        $cols[] = array("data" => $setting, "align" => "center", "width" => 75);
      }

      $output .= "<h2>". module_invoke($name, "node", "name") ."</h2>";
      $output .= table($header, array($cols));
      $output .= "<br /><br />";
770
771
    }
  }
772
  */
773
774
775

  $output .= form_submit(t("Save configuration"));
  $output .= form_submit(t("Reset to defaults"));
Kjartan's avatar
Kjartan committed
776

777
  print form($output);
778
779
780

}

Dries's avatar
   
Dries committed
781
782
783
784
785
786
787
788
789
790
791
792
/*
** 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
793
794
795
function node_revision_create($node) {
  global $user;

Dries's avatar
   
Dries committed
796
797
798
799
800
  /*
  ** '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
801
  if ($node->nid && $node->revision) {
Dries's avatar
   
Dries committed
802
803
804
805
    $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
806
807
808
809
810
  }

  return $node;
}

Dries's avatar
   
Dries committed
811
812
813
/*
** Roll-back to the revision with the specified revision number.
*/
Dries's avatar
   
Dries committed
814

Dries's avatar
   
Dries committed
815
816
function node_revision_rollback($node, $revision) {
  global $user;
Dries's avatar
   
Dries committed
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851

  /*
  ** 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
852
  watchdog("special", "$node->type: rollbacked to revision #$revision of '$node->title'");
Dries's avatar
   
Dries committed
853
854
}

Dries's avatar
   
Dries committed
855
856
857
858
859
/*
** Delete the revision with specified revision number.
*/

function node_revision_delete($node, $revision) {
Dries's avatar
   
Dries committed
860
861

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

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

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

Dries's avatar
   
Dries committed
868
869
870
871
872
873
874
875
876
877
878
/*
** 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
879
880
}

Dries's avatar
 
Dries committed
881
function node_admin() {
Dries's avatar
   
Dries committed
882
883
  $op = $_POST["op"];
  $edit = $_POST["edit"];
Dries's avatar
   
Dries committed
884

Dries's avatar
   
Dries committed
885
  if (user_access("administer nodes")) {
Dries's avatar
   
Dries committed
886

Dries's avatar
   
Dries committed
887
888
889
890
    if (empty($op)) {
      $op = arg(2);
    }

Dries's avatar
   
Dries committed
891
892
893
    /*
    ** Compile a list of the administrative links:
    */
Dries's avatar
   
Dries committed
894
895
    switch ($op) {
      case "search":
Dries's avatar
   
Dries committed
896
        print search_type("node", url("admin/node/search"), $_POST["keys"]);
Dries's avatar
   
Dries committed
897
898
        break;
      case "edit":
Dries's avatar
   
Dries committed
899
        print node_admin_edit(arg(3));
Dries's avatar
   
Dries committed
900
        break;
Dries's avatar
   
Dries committed
901
      case "delete":
Dries's avatar
   
Dries committed
902
        print node_delete(array("nid" => arg(3)));
Dries's avatar
   
Dries committed
903
        break;
Dries's avatar
   
Dries committed
904
905
906
      case "rollback revision":
        print node_revision_rollback(node_load(array("nid" => arg(3))), arg(4));
        print node_admin_edit(arg(3));
Dries's avatar
   
Dries committed
907
        break;
Dries's avatar
   
Dries committed
908
909
910
      case "delete revision":
        print node_revision_delete(node_load(array("nid" => arg(3))), arg(4));
        print node_admin_edit(arg(3));
Dries's avatar
   
Dries committed
911
        break;
Dries's avatar
   
Dries committed
912
      case t("Preview"):
Dries's avatar
   
Dries committed
913
        $edit = node_validate($edit, $error);
Dries's avatar
   
Dries committed
914
        print node_preview($edit, $error);
Dries's avatar
   
Dries committed
915
        break;
Dries's avatar
   
Dries committed
916
      case t("Submit"):
Dries's avatar
   
Dries committed
917
918
919
        print node_submit($edit);
        break;
      case t("Delete"):
Dries's avatar
   
Dries committed
920
        print node_delete($edit);
Dries's avatar
   
Dries committed
921
        break;
922
923
924
925
926
      case t("Save configuration"):
      case t("Reset to defaults"):
      case "settings":
        print node_admin_settings($edit);
        break;
Dries's avatar
   
Dries committed
927
      default:
Dries's avatar
   
Dries committed
928
        print node_admin_nodes();
Dries's avatar
   
Dries committed
929
930
931
932
    }
  }
  else {
    print message_access();
Dries's avatar
 
Dries committed
933
934
935
  }
}

Dries's avatar
   
Dries committed
936
function node_block($op = "list", $delta = 0) {
Dries's avatar
   
Dries committed
937

Dries's avatar
   
Dries committed
938
939
940
941
942
943
  if ($op == "list") {
    $blocks[0]["info"] = t("Syndicate");
    return $blocks;
  }
  else {
    $block["subject"] = t("Syndicate");
Dries's avatar
   
Dries committed
944
    $block["content"] = "<div style=\"text-align: center;\">". l("<img src=\"". theme("image", "xml.gif") ."\" width=\"36\" height=\"14\" style=\"border: 0px;\" alt=\"XML\" title=\"XML\" />", "node/feed", array("title" => t("Read the XML version of this page."))) ."</div>";
Dries's avatar
   
Dries committed
945

Dries's avatar
   
Dries committed
946
947
    return $block;
  }
Dries's avatar
   
Dries committed
948
949
}

Dries's avatar
   
Dries committed
950
951
952
953
954
955
956
957
958
function node_get_alias($path) {

  $result = db_query("SELECT nid FROM {node} WHERE path = '%s'", trim($path, "/"));
  if ($node = db_fetch_object($result)) {
    return "node/view/$node->nid";
  }
}

function node_url($node) {
959
  if ($node->path != NULL) {
Dries's avatar
   
Dries committed
960
961
962
963
964
965
966
    return $node->path;
  }
  else {
    return "node/view/$node->nid";
  }
}

Kjartan's avatar
Kjartan committed
967
function node_feed($nodes = 0, $channel = array()) {
Dries's avatar
   
Dries committed
968
  global $base_url, $languages;
Dries's avatar
   
Dries committed
969

Kjartan's avatar
Kjartan committed
970
  /*
Dries's avatar
   
Dries committed
971
972
973
974
975
  ** 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.
Kjartan's avatar
Kjartan committed
976
  */
Dries's avatar
   
Dries committed
977

Kjartan's avatar
Kjartan committed
978
  if (!$nodes) {
Dries's avatar
   
Dries committed
979
    $nodes = db_query_range("SELECT nid, path FROM {node} WHERE promote = '1' AND status = '1' ORDER BY created DESC", 0, 15);
Kjartan's avatar
Kjartan committed
980
  }
Dries's avatar
   
Dries committed
981

Kjartan's avatar
Kjartan committed
982
  while ($node = db_fetch_object($nodes)) {
Dries's avatar
   
Dries committed
983
984
985
986
    /*
    ** Load the specified node:
    */
    
Kjartan's avatar
Kjartan committed
987
    $item = node_load(array("nid" => $node->nid));
Dries's avatar
   
Dries committed
988
989
990
991
992
993
994
995
996
997
998
999
1000
    
    /*
    ** Transform the node information into an RSS item:
    */
    
    $items .= format_rss_item($item->title, url(node_url($node)), ($item->teaser ? $item->teaser : $item->body));

    /*
    ** Determine the publication date:
    */
    
    if ($item->updated > $pubdate) {
      $pubdate = $item->updated;