node.module 47.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
function node_help($section = "admin/help#node") {
Dries's avatar
   
Dries committed
5
  global $mod;
6
7
8
9
  $output = "";

  switch ($section) {

Dries's avatar
   
Dries committed
10
    case 'admin/help#node':
11
12
13
14
      $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>";
Dries's avatar
   
Dries committed
15
      $output .= "<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>";
16
17
18
19
20
      $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>";
Dries's avatar
   
Dries committed
21
      $output .= "<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>";
22
23
      $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>";
Dries's avatar
   
Dries committed
24
      $output .= "<dt>Revisions</dt><dd>Drupal has a revision system so that you can \"roll back\" to an older version of a post if the new version is not what you want.</dd>";
25
26
      $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>";
Dries's avatar
   
Dries committed
27
      $output .= "<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.";
28
29
30
31
32
      $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>";

Dries's avatar
   
Dries committed
33
      $output = t($output, array("%teaser" => l(t("click here"), "admin/system/modules/node")));
Dries's avatar
   
Dries committed
34

35
36
37
      if ($mod == "admin") {
        foreach (module_list() as $name) {
          if (module_hook($name, "node") && $name != "node") {
Dries's avatar
   
Dries committed
38
            $output .= "<h3>". t("Node type: %module", array("%module" => module_invoke($name, "node", "name"))) ."</h3>";
39
40
41
            $output .= module_invoke($name, "node", "description");
          }
        }
Dries's avatar
   
Dries committed
42
      }
43
44
      break;

Dries's avatar
   
Dries committed
45
    case 'admin/system/modules#description':
Dries's avatar
   
Dries committed
46
      $output = t("The core that allows content to be submitted to the site.");
47
48
      break;
    case 'admin/system/modules/node':
Dries's avatar
   
Dries committed
49
      $output = t("Settings for the core of Drupal. Almost everything is a node so these settings will affect most of the site.");
50
51
      break;
    case 'admin/node':
Dries's avatar
   
Dries committed
52
      $output = t("Below is a list of all of the nodes in your site. Other forms of content are listed elsewhere (e.g. %comments).<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")));
53
54
      break;
    case 'admin/node/search':
Dries's avatar
   
Dries committed
55
      $output = t("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\".");
56
57
      break;
    case 'admin/node/settings':
Dries's avatar
   
Dries committed
58
      $output = t("This page 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?");
59
60
      break;

Dries's avatar
   
Dries committed
61
  }
Dries's avatar
   
Dries committed
62
63

  return $output;
Dries's avatar
   
Dries committed
64
65
}

Dries's avatar
   
Dries committed
66
function node_help_page() {
Dries's avatar
   
Dries committed
67
  print theme("page", node_help());
Dries's avatar
   
Dries committed
68
69
70
}


Dries's avatar
   
Dries committed
71
72
73
74
/*
** 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
75
76
function node_title_list($result, $title = NULL) {
  while ($node = db_fetch_object($result)) {
Dries's avatar
   
Dries committed
77
    $number = module_invoke("comment", "num_all", $node->nid);
Dries's avatar
   
Dries committed
78
    $items[] = l($node->title, "node/view/$node->nid", array("title" => format_plural($number, "%count comment", "%count comments")));
Dries's avatar
   
Dries committed
79
80
  }

Dries's avatar
   
Dries committed
81
  return theme("node_list", $items, $title);
Dries's avatar
   
Dries committed
82
83
}

Dries's avatar
   
Dries committed
84
function theme_node_list($items, $title = NULL) {
Dries's avatar
   
Dries committed
85
  return theme("item_list", $items, $title);
Dries's avatar
   
Dries committed
86
87
}

Dries's avatar
   
Dries committed
88
89
90
91
92
// 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
93
    $result = db_query("SELECT timestamp FROM {history} WHERE uid = %d AND nid = %d", $user->uid, $nid);
Dries's avatar
   
Dries committed
94
    if (db_fetch_object($result)) {
Dries's avatar
   
Dries committed
95
      db_query("UPDATE {history} SET timestamp = %d WHERE uid = %d AND nid = %d", time(), $user->uid, $nid);
Dries's avatar
   
Dries committed
96
97
    }
    else {
Dries's avatar
   
Dries committed
98
      db_query("INSERT INTO {history} (uid, nid, timestamp) VALUES (%d, %d, %d)", $user->uid, $nid, time());
Dries's avatar
   
Dries committed
99
100
101
102
103
104
105
106
107
108
109
    }
  }
}

/*
** 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
110
  $history = db_fetch_object(db_query("SELECT timestamp FROM {history} WHERE uid = '$user->uid' AND nid = %d", $nid));
Dries's avatar
   
Dries committed
111
112
113
114
115
116
117
118
119
120
121
122
123
  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
124
  if (!isset($cache[$nid])) {
Dries's avatar
   
Dries committed
125
    if ($user->uid) {
Dries's avatar
   
Dries committed
126
      $history = db_fetch_object(db_query("SELECT timestamp FROM {history} WHERE uid = %d AND nid = %d", $user->uid, $nid));
Dries's avatar
   
Dries committed
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
      $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
142
143
function node_teaser($body) {

Dries's avatar
   
Dries committed
144
145
146
147
148
149
150
151
152
153
  $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
154
155

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

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

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

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

Dries's avatar
   
Dries committed
174
175
176
177
  /*
  ** 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
178
179
  */

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

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

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

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

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

Dries's avatar
   
Dries committed
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
  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
216

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

Dries's avatar
   
Dries committed
220
function node_invoke(&$node, $hook, $a2 = NULL, $a3 = NULL, $a4 = NULL) {
Dries's avatar
   
Dries committed
221
  if (is_array($node)) {
222
    $function = $node["type"] ."_$hook";
Dries's avatar
   
Dries committed
223
224
  }
  else if (is_object($node)) {
225
    $function = $node->type ."_$hook";
Dries's avatar
   
Dries committed
226
227
  }
  else if (is_string($node)) {
228
    $function = $node ."_$hook";
Dries's avatar
   
Dries committed
229
230
231
  }

  if (function_exists($function)) {
Dries's avatar
   
Dries committed
232
    return ($function($node, $a2, $a3, $a4));
Dries's avatar
   
Dries committed
233
234
235
  }
}

Dries's avatar
   
Dries committed
236
237
238
239
240
241
242
243
244
245
246
247
248
249
function node_invoke_nodeapi(&$node, $op, $arg = 0) {
  $return = array();
  foreach (module_list() as $name) {
    $function = $name ."_nodeapi";
    if (function_exists($function)) {
      $result = $function($node, $op, $arg);
      if (isset($result)) {
        $return = array_merge($return, $result);
      }
    }
  }
  return $return;
}

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

  /*
  ** 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
264
  $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
265
266
267
268
269
270
271
272
273
274
275
276
277
278

  /*
  ** 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:
  */

Dries's avatar
   
Dries committed
279
  if ($extra = node_invoke($node, "load")) {
Dries's avatar
   
Dries committed
280
281
282
283
284
    foreach ($extra as $key => $value) {
      $node->$key = $value;
    }
  }

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

Dries's avatar
   
Dries committed
292
293
294
  return $node;
}

295
function node_save($node) {
Dries's avatar
   
Dries committed
296

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

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

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

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

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

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

    /*
    ** Update an existing node:
    */

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

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

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

Dries's avatar
   
Dries committed
367
    // Call the node specific callback (if any):
368
    node_invoke($node, "update");
Dries's avatar
   
Dries committed
369
    node_invoke_nodeapi($node, "update");
Dries's avatar
   
Dries committed
370
371
  }

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

  cache_clear_all();

Dries's avatar
   
Dries committed
379
380
381
382
383
384
385
386
  /*
  ** Return the node ID:
  */

  return $node->nid;

}

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

Dries's avatar
   
Dries committed
389
  $node = array2object($node);
Dries's avatar
   
Dries committed
390

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

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

Dries's avatar
   
Dries committed
398
399
400
401
402
403
  /*
  ** The "view" hook can be implemented to overwrite the default function
  ** to display nodes.
  */

  if (module_hook($node->type, "view")) {
Dries's avatar
   
Dries committed
404
    return node_invoke($node, "view", $main, $page);
Dries's avatar
   
Dries committed
405
406
407
408
409
410
411
  }
  else {

    /*
    ** Default behavior:
    */

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

Dries's avatar
   
Dries committed
415
    return theme("node", $node, $main, $page);
Dries's avatar
   
Dries committed
416
417
418
  }
}

Dries's avatar
   
Dries committed
419
420
function node_show($node, $cid) {

Dries's avatar
   
Dries committed
421
422
  if (node_access("view", $node)) {

Dries's avatar
   
Dries committed
423
    $output = node_view($node, 0, 1);
Dries's avatar
   
Dries committed
424
425

    if (function_exists("comment_render") && $node->comment) {
Dries's avatar
   
Dries committed
426
      $output .= comment_render($node, $cid);
Dries's avatar
   
Dries committed
427
    }
Dries's avatar
   
Dries committed
428
429
430
431
432
433

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

    node_tag_new($node->nid);
Dries's avatar
   
Dries committed
434
435

    return $output;
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
463
  // Can't use node_invoke:
  // the access hook takes the $op parameter before the $node parameter.
Dries's avatar
   
Dries committed
464
  return module_invoke($type, "access", $op, $node);
Dries's avatar
   
Dries committed
465
466
}

Dries's avatar
   
Dries committed
467
function node_perm() {
Dries's avatar
   
Dries committed
468
  return array("administer nodes", "access content");
Dries's avatar
   
Dries committed
469
470
}

Dries's avatar
   
Dries committed
471
472
function node_search($keys) {

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

Dries's avatar
   
Dries committed
493
494
495
  return $find;
}

496
function node_settings() {
Dries's avatar
   
Dries committed
497
  $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
498
  $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
499
  $output .= form_radios(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
500

Dries's avatar
   
Dries committed
501
502
503
  return $output;
}

Dries's avatar
CHANGES    
Dries committed
504
function node_conf_filters() {
Dries's avatar
   
Dries committed
505
  $output .= form_radios(t("Filter HTML tags"), "filter_html", variable_get("filter_html", 0), array(0 => t("Do not filter"), 1 => t("Strip tags"), 2 => t("Escape tags")), t("How to deal with HTML and PHP tags in user-contributed content. If set to \"Strip tags\", dangerous tags are removed.  If set to \"Escape tags\", all HTML is escaped and presented as it was typed."));
Dries's avatar
   
Dries committed
506
  $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 \"Strip tags\" is selected, optionally specify tags which should not be stripped.  'STYLE' attributes, 'ON*' attributes and unclosed tags are always stripped."));
Dries's avatar
   
Dries committed
507
  $output .= form_radios(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
508
  $output .= "<hr />";
Dries's avatar
CHANGES    
Dries committed
509
510
511
  return $output;
}

Dries's avatar
   
Dries committed
512
513
514
515
function node_escape_html($text) {
  return htmlspecialchars($text);
}

Dries's avatar
CHANGES    
Dries committed
516
517
518
519
520
521
function node_filter_html($text) {
  $text = strip_tags($text, variable_get("allowed_html", ""));
  return $text;
}

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

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

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

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

Dries's avatar
   
Dries committed
543
  if (variable_get("filter_html", 0) == 2) {
Dries's avatar
   
Dries committed
544
545
546
    $text = node_escape_html($text);
  }

Dries's avatar
   
Dries committed
547
  return trim($text);
Dries's avatar
CHANGES    
Dries committed
548
549
}

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

Dries's avatar
   
Dries committed
552
553
  $links = array();

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

Dries's avatar
   
Dries committed
559
    if ($main == 1 && $node->teaser && strlen($node->teaser) != strlen($node->body)) {
Dries's avatar
   
Dries committed
560
      $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
561
    }
Dries's avatar
   
Dries committed
562
563

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

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

Dries's avatar
   
Dries committed
572
  if ($type == "system") {
Dries's avatar
   
Dries committed
573
    menu("node/add", t("create content"), NULL, 1);
Dries's avatar
   
Dries committed
574

Dries's avatar
   
Dries committed
575
    if (user_access("administer nodes")) {
Dries's avatar
   
Dries committed
576
577
      menu("admin/node", t("content"), "node_admin");
      menu("admin/node/search", t("search"), "node_admin", 8);
Dries's avatar
   
Dries committed
578
      menu("admin/node/help", t("help"), "node_help_page", 9);
Dries's avatar
   
Dries committed
579
580
      menu("admin/node/edit", t("edit post"), "node_admin", 0, 1);
      menu("admin/node/settings", t("settings"), "node_admin", 8);
Dries's avatar
   
Dries committed
581
    }
Dries's avatar
   
Dries committed
582
583
584
585

    if (user_access("access content")) {
      menu("node", t("content"), "node_page", 0, 1);
    }
Dries's avatar
   
Dries committed
586
587
  }

Dries's avatar
   
Dries committed
588
  return $links;
Dries's avatar
   
Dries committed
589
590
}

Dries's avatar
   
Dries committed
591
function node_admin_edit($node) {
Dries's avatar
   
Dries committed
592

Dries's avatar
   
Dries committed
593
  if (is_numeric($node)) {
Dries's avatar
   
Dries committed
594
    $node = node_load(array("nid" => $node));
Dries's avatar
   
Dries committed
595
  }
Dries's avatar
   
Dries committed
596

Dries's avatar
   
Dries committed
597
  $output .= node_form($node);
Dries's avatar
   
Dries committed
598

Dries's avatar
   
Dries committed
599
  /*
Dries's avatar
   
Dries committed
600
  ** Display the node form extensions:
Dries's avatar
   
Dries committed
601
  */
Dries's avatar
   
Dries committed
602
  $output .= implode("\n", module_invoke_all("node_link", $node));
Dries's avatar
Dries committed
603

Dries's avatar
   
Dries committed
604
  return $output;
Dries's avatar
   
Dries committed
605
606
607

}

Dries's avatar
   
Dries committed
608
function node_admin_nodes() {
Dries's avatar
   
Dries committed
609
610
611
612
613
614
615
616
617
618
  $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
619
    array(t("Approve the selected posts"), "UPDATE {node} SET status = 1, moderate = 0 WHERE nid = %d"),
Dries's avatar
   
Dries committed
620
621
622
    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
623
    array(t("Unpublish the selected posts"), "UPDATE {node} SET status = 0 WHERE nid = %d")
Dries's avatar
   
Dries committed
624
  );
Dries's avatar
   
Dries committed
625

Dries's avatar
   
Dries committed
626
627
628
629
  /*
  ** Handle operations:
  */

Dries's avatar
   
Dries committed
630
631
  if (empty($_SESSION["node_overview_filter"])) {
    $_SESSION["node_overview_filter"] = 0;
Dries's avatar
   
Dries committed
632
633
  }

Dries's avatar
   
Dries committed
634
  if (isset($_POST["edit"]["filter"])) {
Dries's avatar
   
Dries committed
635
    $_SESSION["node_overview_filter"] = $_POST["edit"]["filter"];
Dries's avatar
   
Dries committed
636
637
  }

Dries's avatar
   
Dries committed
638
  if (isset($_POST["edit"]["operation"])) {
Dries's avatar
   
Dries committed
639
640
641
    $operation = $operations[$_POST["edit"]["operation"]][1];
    foreach ($_POST["edit"]["status"] as $nid => $value) {
      if ($value) {
Dries's avatar
Dries committed
642
        db_query($operation, $nid);
Dries's avatar
   
Dries committed
643
644
645
      }
    }

Dries's avatar
   
Dries committed
646
    drupal_set_message(t("the update has been performed."));
Dries's avatar
   
Dries committed
647
648
  }

Dries's avatar
   
Dries committed
649
  $filter = $_SESSION["node_overview_filter"];
Dries's avatar
Dries committed
650

Dries's avatar
   
Dries committed
651
652
653
654
655
656
657
658
  /*
  ** Render filter form:
  */

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

Dries's avatar
   
Dries committed
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
  $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
685
  $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
686
  $header = array(NULL, t("title"), t("type"), t("author"), t("status"), array("data" => t("operations"), "colspan" => 2));
Dries's avatar
   
Dries committed
687

Dries's avatar
   
Dries committed
688
  while ($node = db_fetch_object($result)) {
Dries's avatar
   
Dries committed
689
    $rows[] = array(form_checkbox(NULL, "status][$node->nid", 1, 0), l($node->title, "node/view/$node->nid") ." ". (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
690
  }
Dries's avatar
   
Dries committed
691

Dries's avatar
   
Dries committed
692
  if ($pager = pager_display(NULL, 50, 0, "admin")) {
693
    $rows[] = array(array("data" => $pager, "colspan" => 7));
Dries's avatar
   
Dries committed
694
  }
Dries's avatar
   
Dries committed
695

Dries's avatar
   
Dries committed
696
  $output .= "<h3>". $filters[$filter][0] ."</h3>";
Dries's avatar
   
Dries committed
697
  $output .= theme("table", $header, $rows);
Dries's avatar
   
Dries committed
698
  return form($output);
Dries's avatar
Dries committed
699
700
}

701
function node_admin_settings($edit) {
Dries's avatar
   
Dries committed
702
  $op = $_POST["op"];
Kjartan's avatar
Kjartan committed
703

704
705
706
707
708
709
710
711
  if ($op == t("Save configuration")) {
    /*
    ** Save the configuration options:
    */

    foreach ($edit as $name => $value) {
      variable_set($name, $value);
    }
Dries's avatar
   
Dries committed
712
    drupal_set_message(t("the content settings have been saved."));
713
714
715
716
717
718
719
720
721
722
  }

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

    foreach ($edit as $name => $value) {
      variable_del($name);
    }
Dries's avatar
   
Dries committed
723
    drupal_set_message(t("the content settings have been reset to their default values."));
724
725
  }

Dries's avatar
   
Dries committed
726
  $header = array_merge(array(t("type")), array_keys(node_invoke_nodeapi($node, "settings")));
727
728
729
730
  foreach (module_list() as $name) {
    if (module_hook($name, "node")) {
      $node->type = $name;
      $cols = array();
Dries's avatar
   
Dries committed
731
      foreach (node_invoke_nodeapi($node, "settings") as $setting) {
732
733
734
735
736
        $cols[] = array("data" => $setting, "align" => "center", "width" => 55);
      }
      $rows[] = array_merge(array(module_invoke($name, "node", "name")), $cols);
    }
  }
Kjartan's avatar
Kjartan committed
737

Dries's avatar
   
Dries committed
738
  $output .= theme("table", $header, $rows);
739

740
  /* This is an idea for the future.
741
742
743
  foreach (module_list() as $name) {
    if (module_hook($name, "node")) {
      $node->type = $name;
Kjartan's avatar
Kjartan committed
744

Dries's avatar
   
Dries committed
745
      // Create theme("table", ) data:
Dries's avatar
   
Dries committed
746
      $header = array_keys(node_invoke_nodeapi($node, "settings"));
747
      $cols = array();
Dries's avatar
   
Dries committed
748
      foreach (node_invoke_nodeapi($node, "settings") as $setting) {
749
750
751
752
        $cols[] = array("data" => $setting, "align" => "center", "width" => 75);
      }

      $output .= "<h2>". module_invoke($name, "node", "name") ."</h2>";
Dries's avatar
   
Dries committed
753
      $output .= theme("table", $header, array($cols));
754
      $output .= "<br /><br />";
755
756
    }
  }
757
  */
758
759
760

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

Dries's avatar
   
Dries committed
762
  return form($output);
763
764
765

}

Dries's avatar
   
Dries committed
766
767
768
769
770
771
772
773
774
775
776
function node_revision_overview($nid) {

  if (user_access("administer nodes")) {
    $node = node_load(array("nid" => $nid));

    if ($node->revisions) {
      $header = array(t("older revisions"), array("colspan" => "3", "data" => t("operations")));

      foreach ($node->revisions as $key => $revision) {
        $rows[] = array(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>" : ""), l(t("view"), "node/view/$node->nid", array(), "revision=$key"), l(t("rollback"), "node/rollback-revision/$node->nid/$key"), l(t("delete"), "node/delete-revision/$node->nid/$key"));
      }
Dries's avatar
   
Dries committed
777
      $output .= theme("table", $header, $rows);
Dries's avatar
   
Dries committed
778
779
780
781
782
783
784
    }
  }

  return $output;
}


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

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

  return $node;
}

Dries's avatar
   
Dries committed
815
816
817
/*
** Roll-back to the revision with the specified revision number.
*/
Dries's avatar
   
Dries committed
818

Dries's avatar
   
Dries committed
819
function node_revision_rollback($nid, $revision) {
Dries's avatar
   
Dries committed
820
  global $user;
Dries's avatar
   
Dries committed
821

Dries's avatar
   
Dries committed
822
823
  if (user_access("administer nodes")) {
    $node = node_load(array("nid" => $nid));
Dries's avatar
   
Dries committed
824

Dries's avatar
   
Dries committed
825
826
827
    /*
    ** Extract the specified revision:
    */
Dries's avatar
   
Dries committed
828

Dries's avatar
   
Dries committed
829
    $rev = $node->revisions[$revision]["node"];
Dries's avatar
   
Dries committed
830

Dries's avatar
   
Dries committed
831
832
833
    /*
    ** Inherit all the past revisions:
    */
Dries's avatar
   
Dries committed
834

Dries's avatar
   
Dries committed
835
    $rev->revisions = $node->revisions;
Dries's avatar
   
Dries committed
836

Dries's avatar
   
Dries committed
837
838
839
    /*
    ** Save the original/current node:
    */
Dries's avatar
   
Dries committed
840

Dries's avatar
   
Dries committed
841
    $rev->revisions[] = array("uid" => $user->uid, "timestamp" => time(), "node" => $node);
Dries's avatar
   
Dries committed
842

Dries's avatar
   
Dries committed
843
844
845
    /*
    ** Remove the specified revision:
    */
Dries's avatar
   
Dries committed
846

Dries's avatar
   
Dries committed
847
    unset($rev->revisions[$revision]);
Dries's avatar
   
Dries committed
848

Dries's avatar
   
Dries committed
849
850
851
    /*
    ** Save the node:
    */
Dries's avatar
   
Dries committed
852

Dries's avatar
   
Dries committed
853
854
855
    foreach ($node as $key => $value) {
      $filter[] = $key;
    }
Dries's avatar
   
Dries committed
856

Dries's avatar
   
Dries committed
857
858
    node_save($rev, $filter);

Dries's avatar
   
Dries committed
859
    drupal_set_message(t("rollbacked to revision #%revision of '%title'", array("%revision" => $revision, "%title" => $node->title)));
Dries's avatar
   
Dries committed
860
  }
Dries's avatar
   
Dries committed
861
862
}

Dries's avatar
   
Dries committed
863
864
865
866
/*
** Delete the revision with specified revision number.
*/

Dries's avatar
   
Dries committed
867
868
869
870
function node_revision_delete($nid, $revision) {

  if (user_access("administer nodes")) {
    $node = node_load(array("nid" => $nid));
Dries's avatar
   
Dries committed
871

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

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

Dries's avatar
   
Dries committed
876
    drupal_set_message(t("deleted revision #%revision of '%title'", array("%revision" => $revision, "%title" => $node->title)));
Dries's avatar
   
Dries committed
877
  }
Dries's avatar
   
Dries committed
878
879
}

Dries's avatar
   
Dries committed
880
881
882
883
884
885
886
887
888
889
890
/*
** 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
891
892
}

Dries's avatar
 
Dries committed
893
function node_admin() {
Dries's avatar
   
Dries committed
894
895
  $op = $_POST["op"];
  $edit = $_POST["edit"];
Dries's avatar
   
Dries committed
896

Dries's avatar
   
Dries committed
897
  if (user_access("administer nodes")) {
Dries's avatar
   
Dries committed
898

Dries's avatar
   
Dries committed
899
900
901
902
    if (empty($op)) {
      $op = arg(2);
    }

Dries's avatar
   
Dries committed
903
904
905
    /*
    ** Compile a list of the administrative links:
    */
Dries's avatar
   
Dries committed
906
907
    switch ($op) {
      case "search":
Dries's avatar
   
Dries committed
908
        $output = search_type("node", url("admin/node/search"), $_POST["keys"]);
Dries's avatar
   
Dries committed
909
910
        break;
      case "edit":
Dries's avatar
   
Dries committed
911
        $output = node_admin_edit(arg(3));
Dries's avatar
   
Dries committed
912
        break;
Dries's avatar
   
Dries committed
913
      case "delete":
Dries's avatar
   
Dries committed
914
        $output = node_delete(array("nid" => arg(3)));
Dries's avatar
   
Dries committed
915
        break;
Dries's avatar
   
Dries committed
916
      case t("Preview"):
Dries's avatar
   
Dries committed
917
        $edit = node_validate($edit, $error);
Dries's avatar
   
Dries committed
918
        $output = node_preview($edit, $error);
Dries's avatar
   
Dries committed
919
        break;
Dries's avatar
   
Dries committed
920
      case t("Submit"):
Dries's avatar
   
Dries committed
921
        $output = node_submit($edit);
Dries's avatar
   
Dries committed
922
923
        break;
      case t("Delete"):
Dries's avatar
   
Dries committed
924
        $output = node_delete($edit);
Dries's avatar
   
Dries committed
925
        break;
926
927
928
      case t("Save configuration"):
      case t("Reset to defaults"):
      case "settings":
Dries's avatar
   
Dries committed
929
        $output = node_admin_settings($edit);
930
        break;
Dries's avatar
   
Dries committed
931
      default:
Dries's avatar
   
Dries committed
932
        $output = node_admin_nodes();
Dries's avatar
   
Dries committed
933
    }
Dries's avatar
   
Dries committed
934
    print theme("page", $output);
Dries's avatar
   
Dries committed
935
936
  }
  else {
Dries's avatar
   
Dries committed
937
    print theme("page", message_access());
Dries's avatar
 
Dries committed
938
939
940
  }
}

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

Dries's avatar
   
Dries committed
943
944
945
946
947
948
  if ($op == "list") {
    $blocks[0]["info"] = t("Syndicate");
    return $blocks;
  }
  else {
    $block["subject"] = t("Syndicate");
Dries's avatar
   
Dries committed
949
    $block["content"] = "<div class=\"xml-icon\">". 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
950

Dries's avatar
   
Dries committed
951
952
    return $block;
  }
Dries's avatar
   
Dries committed
953
954
}

Kjartan's avatar
Kjartan committed
955
function node_feed($nodes = 0, $channel = array()) {
Dries's avatar
   
Dries committed
956
  global $base_url, $languages;
Dries's avatar
   
Dries committed
957

Kjartan's avatar
Kjartan committed
958
  /*
Dries's avatar
   
Dries committed
959
960
961
962
963
  ** 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
964
  */
Dries's avatar
   
Dries committed
965

Kjartan's avatar
Kjartan committed
966
  if (!$nodes) {
967
    $nodes = db_query_range("SELECT nid FROM {node} WHERE promote = '1' AND status = '1' ORDER BY created DESC", 0, 15);
Kjartan's avatar
Kjartan committed
968
  }
Dries's avatar
   
Dries committed
969

Kjartan's avatar
Kjartan committed
970
  while ($node = db_fetch_object($nodes)) {
Dries's avatar
   
Dries committed
971
972
973
    /*
    ** Load the specified node:
    */
Dries's avatar
   
Dries committed
974

Kjartan's avatar
Kjartan committed
975
    $item = node_load(array("nid" => $node->nid));
Dries's avatar
   
Dries committed
976
    $link = url("node/view/$node->nid");
Dries's avatar
   
Dries committed
977
    $items .= format_rss_item($item->title, $link, ($item->teaser ? $item->teaser : $item->body), array("pubDate" => date("r", $item->changed)));
Dries's avatar
   
Dries committed
978
979
  }

Dries's avatar
   
Dries committed
980
  $output .= "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n";
Kjartan's avatar
Kjartan committed
981
  $output .= "<!DOCTYPE rss [<!ENTITY % HTMLlat1 PUBLIC \"-//W3C//ENTITIES Latin 1 for XHTML//EN\" \"http://www.w3.org/TR/xhtml1/DTD/xhtml-lat1.ent\">]>\n";
Dries's avatar
   
Dries committed
982
  if (!$channel["version"]) $channel["version"] = "0.92";
Kjartan's avatar
Kjartan committed
983
  if (!$channel["title"]) $channel["title"] = variable_get("site_name", "drupal") ." - ". variable_get("site_slogan", "");
Dries's avatar
   
Dries committed
984
  if (!$channel["link"]) $channel["link"] = $base_url;
Kjartan's avatar
Kjartan committed
985
  if (!$channel["description"]) $channel["description"] = variable_get("site_mission", "");
Dries's avatar
   
Dries committed
986
987
  foreach ($languages as $key => $value) break;
  if (!$channel["language"]) $channel["language"] = $key ? $key : "en";
Kjartan's avatar
Kjartan committed
988
  $output .= "<rss version=\"". $channel["version"] . "\">\n";
Dries's avatar
   
Dries committed
989
  $output .= format_rss_channel($channel["title"], $channel["link"], $channel["description"], $items, $channel["language"]);
Dries's avatar
   
Dries committed
990
991
  $output .= "</rss>\n";

Dries's avatar
   
Dries committed
992
  header("Content-Type: text/xml");
Dries's avatar
   
Dries committed
993
994
995
  print $output;
}

996
function node_validate($node, &$error) {
Dries's avatar
   
Dries committed
997
  global $user;
<