node.module 36.1 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>". t("%module type", array("%module" => ucfirst(module_invoke($name, "node", "name")))). "</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_next_id("node");
Dries's avatar
   
Dries committed
153

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

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

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

    /*
    ** Update an existing node:
    */

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

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

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

Dries's avatar
   
Dries committed
187
    // Call the node specific callback (if any):
Dries's avatar
   
Dries committed
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
    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
203
  $node = array2object($node);
Dries's avatar
   
Dries committed
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222

  /*
  ** 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
223
224
function node_access($op, $node = 0) {

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

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

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

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

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

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

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

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

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

Kjartan's avatar
Kjartan committed
265
266
267
268
269
270
271
272
273
274
275
276
  // 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
277
  // table to the data that the search_index table has in it, and the the
Kjartan's avatar
Kjartan committed
278
279
  // do_search functino will rank it.
  //
Dries's avatar
   
Dries committed
280
  // The select must always provide the following fields - lno, title,
Kjartan's avatar
Kjartan committed
281
282
  // created, uid, name, count
  //
Kjartan's avatar
Kjartan committed
283
  $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
284

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

Dries's avatar
   
Dries committed
288
function node_conf_options() {
Dries's avatar
   
Dries committed
289
  $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
290
291
292
  return $output;
}

Dries's avatar
CHANGES    
Dries committed
293
function node_conf_filters() {
Dries's avatar
   
Dries committed
294
  $output .= form_select(t("Enable HTML tags"), "filter_html", variable_get("filter_html", 0), array(t("Disabled"), t("Enabled")), t("Allow HTML and PHP tags in user-contributed content."));
295
  $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
296
  $output .= "<hr />";
Dries's avatar
   
Dries committed
297
  $output .= form_select(t("Enable link tags"), "filter_link", variable_get("filter_link", 0), array(t("Disabled"), t("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
298
  $output .= "<hr />";
Dries's avatar
CHANGES    
Dries committed
299
300
301
302
303
304
305
306
307
  return $output;
}

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

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

Dries's avatar
   
Dries committed
313
function node_filter_line($text) {
Dries's avatar
   
Dries committed
314

Dries's avatar
   
Dries committed
315
  /*
Dries's avatar
   
Dries committed
316
317
318
319
320
321
322
  ** 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
323
324
325
  */

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

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

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

  /*
Dries's avatar
   
Dries committed
339
  ** Replace '\r\n' by '\n':
Dries's avatar
   
Dries committed
340
341
342
343
344
345
346
347
348
349
350
  */

  $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
351

Dries's avatar
   
Dries committed
352
353
354
355
356
357
358
  /*
  ** 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
359
360
361
  return trim($text);
}

Dries's avatar
   
Dries committed
362
function node_comment_mode($nid) {
Dries's avatar
   
Dries committed
363
364
365
366
367
  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
368
369
}

Dries's avatar
CHANGES    
Dries committed
370
function node_filter($text) {
Dries's avatar
   
Dries committed
371
372
373
374
375
  $text = preg_replace("/\Wstyle\s*=[^>]+?>/i", ">", $text);
  $text = preg_replace("/\Won[a-z]+\s*=[^>]+?>/i", ">", $text);
  $text = preg_replace("/\Wsrc\s*=[\s'\"]*javascript[^>]+?>/i", ">", $text);
  $text = preg_replace("/\Whref\s*=[\s'\"]*javascript:[^>]+?>/i", ">", $text);

Dries's avatar
CHANGES    
Dries committed
376
377
  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
378
  return node_filter_line($text);
Dries's avatar
CHANGES    
Dries committed
379
380
}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Dries's avatar
   
Dries committed
444
  return form($output);
Dries's avatar
   
Dries committed
445
446
}

Dries's avatar
   
Dries committed
447
function node_admin_edit($node) {
Dries's avatar
   
Dries committed
448

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

Dries's avatar
   
Dries committed
453
454
455
  /*
  ** Edit node:
  */
Dries's avatar
   
Dries committed
456

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

Dries's avatar
   
Dries committed
459
  $output .= node_form($node);
Dries's avatar
   
Dries committed
460

Dries's avatar
   
Dries committed
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\">";
Dries's avatar
   
Dries committed
468
    $output .= " <tr><th>". t("older revisions") ."</th><th colspan=\"3\">". t("operations") ."</th></tr>";
Dries's avatar
   
Dries committed
469
    foreach ($node->revisions as $key => $revision) {
470
      $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
471
472
473
474
    }
    $output .= "</table>";
  }

Dries's avatar
   
Dries committed
475
  /*
Dries's avatar
   
Dries committed
476
  ** Display the node form extensions:
Dries's avatar
   
Dries committed
477
  */
Dries's avatar
   
Dries committed
478

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

Dries's avatar
   
Dries committed
483
  return $output;
Dries's avatar
   
Dries committed
484
485
486

}

Dries's avatar
   
Dries committed
487
488
function node_admin_nodes() {
  global $query;
Dries's avatar
   
Dries committed
489

Dries's avatar
   
Dries committed
490
  $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
491

Dries's avatar
   
Dries committed
492
  $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
493

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

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

Dries's avatar
   
Dries committed
500
  $output .= "<table border=\"1\" cellpadding=\"2\" cellspacing=\"2\">\n";
Dries's avatar
   
Dries committed
501
  $output .= " <tr><th>". t("title") ."</th><th>type</th><th>". t("author") ."</th><th>". t("status") ."</th><th colspan=\"2\">". t("operations") ."</th></tr>\n";
Dries's avatar
   
Dries committed
502
  while ($node = db_fetch_object($result)) {
Kjartan's avatar
Kjartan committed
503
    $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
504
  }
Dries's avatar
   
Dries committed
505
  $output .= "</table>";
Dries's avatar
   
Dries committed
506

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

Dries's avatar
   
Dries committed
510
511
512
513
514
515
516
517
518
519
520
521
/*
** 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
522
523
524
function node_revision_create($node) {
  global $user;

Dries's avatar
   
Dries committed
525
526
527
528
529
  /*
  ** '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
530
  if ($node->nid && $node->revision) {
Dries's avatar
   
Dries committed
531
532
533
534
    $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
535
536
537
538
539
  }

  return $node;
}

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

Dries's avatar
   
Dries committed
544
545
function node_revision_rollback($node, $revision) {
  global $user;
Dries's avatar
   
Dries committed
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
579
580

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

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

function node_revision_delete($node, $revision) {
Dries's avatar
   
Dries committed
589
590

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

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

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

Dries's avatar
   
Dries committed
597
598
599
600
601
602
603
604
605
606
607
/*
** 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
608
609
}

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

Dries's avatar
   
Dries committed
613
  if (user_access("administer nodes")) {
Dries's avatar
   
Dries committed
614

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

Dries's avatar
   
Dries committed
619
620
621
622
    $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
623

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

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

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

  $block[0][subject] = t("Syndicate");
Kjartan's avatar
Kjartan committed
674
  $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
675
676
677
678
679
  $block[0][info] = "Syndicate";

  return $block;
}

Kjartan's avatar
Kjartan committed
680
681
682
683
684
685
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
686

Kjartan's avatar
Kjartan committed
687
688
689
  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
690

Kjartan's avatar
Kjartan committed
691
692
693
  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
694
    $items .= format_rss_item($item->title, $link, $item->teaser);
Dries's avatar
   
Dries committed
695
696
  }

Kjartan's avatar
Kjartan committed
697
  $output .= "<?xml version=\"1.0\" ". t("encoding=\"ISO-8859-1\""). "?>\n";
Dries's avatar
   
Dries committed
698
  // $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
699
700
701
702
703
704
705
  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
706
707
  $output .= "</rss>\n";

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

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

  global $user;

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

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

  /*
  ** Validate the title field:
  */

Dries's avatar
   
Dries committed
726
  if (isset($node->title) && !$node->title) {
Dries's avatar
   
Dries committed
727
728
729
730
731
732
733
734
735
    $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
736
737
    if (!$node->created) {
      $node->created = time();
Dries's avatar
   
Dries committed
738
739
    }

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

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

Dries's avatar
   
Dries committed
748
749
750
751
752
753
754
755
756
    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
757
      $node->uid = $account->uid;
Dries's avatar
   
Dries committed
758
759
    }
    else {
Dries's avatar
   
Dries committed
760
      $error["name"] = "<div style=\"color: red;\">". t("The name '%u' does not exist.", array ("%u" => $node->name)) ."</div>";
Dries's avatar
   
Dries committed
761
762
763
764
765
766
    }

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

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

Dries's avatar
   
Dries committed
774
775
  }

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

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

Dries's avatar
   
Dries committed
785
  return $node;
Dries's avatar
   
Dries committed
786
787
}

Dries's avatar
   
Dries committed
788

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

Dries's avatar
   
Dries committed
791
792
793
794
795
796
797
  /*
  ** 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
798
799
800
801
  /*
  ** Validate the node:
  */

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

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

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

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

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

  /*
  ** Add the help text:
  */

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

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

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

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

  /*
Dries's avatar
   
Dries committed
843
  ** Add the node specific fields:
Dries's avatar
   
Dries committed
844
845
  */

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

  /*
  ** Add the hidden fields:
  */

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

Dries's avatar
   
Dries committed
856
857
858
859
860
  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
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
    $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
880
  if ($edit->nid && node_access("delete", $edit)) {
Dries's avatar
   
Dries committed
881
882
883
884
885
886
887
888
    $output .= form_submit(t("Delete"));
  }

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

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

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

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

function node_add($type) {
  global $user;

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

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

Dries's avatar
   
Dries committed
926
  if ($type && node_access("create", $type)) {
927
    // Initialize settings
Kjartan's avatar
Kjartan committed
928
    $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
929
930
  }
  else {
Dries's avatar
   
Dries committed
931

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

Dries's avatar
   
Dries committed
936
    foreach (module_list() as $name) {
Dries's avatar
   
Dries committed
937
938
      if (module_hook($name, "node") && node_access("create", array("type" => $name))) {
        $output .= "<li>";
Kjartan's avatar
Kjartan committed
939
        $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
940
941
        $output .= " <div style=\"margin-left: 20px;\">". module_invoke($name, "node", "description") ."</div>";
        $output .= "</li>";
Dries's avatar
   
Dries committed
942
      }
Dries's avatar
   
Dries committed
943
944
    }

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

Dries's avatar
   
Dries committed
947
948
949
950
951
952
953
954
  }

  return $output;
}

function node_edit($id) {
  global $user;

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

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

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

  return $output;
Dries's avatar
   
Dries committed
969
970
}

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

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

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

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

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

Dries's avatar
   
Dries committed
987
988
989
990
991
992
993
994
  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
995
996
    }
    else {
Dries's avatar
   
Dries committed
997
      $node->uid = 0; // anonymous user
Dries's avatar
   
Dries committed
998
    }
Dries's avatar
   
Dries committed
999
  }
Dries's avatar
   
Dries committed
1000
  else if ($node->uid) {