forum.module 25.6 KB
Newer Older
Dries Buytaert's avatar
   
Dries Buytaert committed
1
2
3
4
<?php
// $Id$

function forum_node($field) {
Dries Buytaert's avatar
   
Dries Buytaert committed
5
  $info["name"] = t("forum topic");
Dries Buytaert's avatar
   
Dries Buytaert committed
6
7
8
9
10
11
12
13
14
  $info["description"] = t("A forum is a threaded discussion, enabling users to communicate about a particular topic.");

  return $info[$field];
}

function forum_access($op, $node) {
  if ($op == "view") {
    return $node->status;
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
15
  if ($op == "create") {
Dries Buytaert's avatar
   
Dries Buytaert committed
16
    return user_access("create forum topics");
Dries Buytaert's avatar
   
Dries Buytaert committed
17
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
18
19
}

Dries Buytaert's avatar
   
Dries Buytaert committed
20
function forum_perm() {
Dries Buytaert's avatar
   
Dries Buytaert committed
21
  return array("create forum topics");
Dries Buytaert's avatar
   
Dries Buytaert committed
22
}
Dries Buytaert's avatar
   
Dries Buytaert committed
23

24
function forum_settings() {
Dries Buytaert's avatar
   
Dries Buytaert committed
25

Dries Buytaert's avatar
   
Dries Buytaert committed
26
  if (module_exist("taxonomy")) {
Dries Buytaert's avatar
   
Dries Buytaert committed
27
    $vocs[0] = "<". t("none") .">";
Dries Buytaert's avatar
   
Dries Buytaert committed
28
29
30
31
    foreach (taxonomy_get_vocabularies("forum") as $vid => $voc) {
      $vocs[$vid] = $voc->name;
    }

Dries Buytaert's avatar
   
Dries Buytaert committed
32
    if ($voc) {
33
34
35
      $group  = form_select(t("Forum vocabulary"), "forum_nav_vocabulary", variable_get("forum_nav_vocabulary", ""), $vocs, t("The taxonomy vocabulary that will be used as the navigation tree.  The vacabulary's terms define the forums."));
      $group .= _taxonomy_term_select(t("Containers"), "forum_containers", variable_get("forum_containers", array()), variable_get("forum_nav_vocabulary", ""), t("You can choose forums which will not have topics, but will be just containers for other forums.  This lets you both group and nest forums."), 1, t("<none>"));

Dries Buytaert's avatar
   
Dries Buytaert committed
36
      $output = form_group(t('Forum structure settings'), $group);
37
38
39

      $group  = form_textarea(t("Explanation or submission guidelines"), "forum_help", variable_get("forum_help", ""), 70, 5, t("This text will be displayed at the top of the forum submission form.  Useful for helping or instructing your users."));
      $group .= form_textfield(t("Forum icon path"), "forum_icon_path", variable_get("forum_icon_path", ""), 30, 255, t("The path to the forum icons.  Leave blank to disable icons.  Don't add a trailing slash.  Default icons are available in the 'misc' directory."));
Dries Buytaert's avatar
   
Dries Buytaert committed
40
      $number = array(5 => 5, 10 => 10, 15 => 15, 20 => 20, 25 => 25, 30 => 30, 35 => 35, 40 => 40, 50 => 50, 60 => 60, 80 => 80, 100 => 100, 10000 => 10000);
41
      $group .= form_select(t("Hot topic threshold"), "forum_hot_topic", variable_get("forum_hot_topic", 15), $number, t("The number of posts a topic must have to be considered <strong>hot</strong>."));
Dries Buytaert's avatar
   
Dries Buytaert committed
42
      $number = array(10 => 10, 25 => 25, 50 => 50, 75 => 75, 100 => 100);
43
      $group .= form_select(t("Topics per page"), "forum_per_page", variable_get("forum_per_page", 25), $number, t("The default number of topics displayed per page; links to browse older messages are automatically being displayed."));
44
      $forder = array(1 => t("Date - newest first"), 2 => t("Date - oldest first"), 3 => t("Posts - most active first"), 4=> t("Posts - least active first"));
Dries Buytaert's avatar
Dries Buytaert committed
45
      $group .= form_radios(t("Default order"), "forum_order", variable_get("forum_order", "1"), $forder, t("The default display order for topics."));
Dries Buytaert's avatar
   
Dries Buytaert committed
46
      $output .= form_group(t('Forum viewing options'), $group);
47

Dries Buytaert's avatar
Dries Buytaert committed
48
      $group = form_textfield(t("Number of topics in block"), "forum_block_num", variable_get("forum_block_num", "5"), 5, 5, t("The number of topics to show in the \"Forum topics\" block.  To enable the block, click ". l("here", "admin/system/block") ."."));
Dries Buytaert's avatar
   
Dries Buytaert committed
49
      $output .= form_group(t('"Forum topic" block settings'), $group);
Dries Buytaert's avatar
   
Dries Buytaert committed
50
51
    }
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
52

Dries Buytaert's avatar
   
Dries Buytaert committed
53
54
55
  return $output;
}

Dries Buytaert's avatar
Dries Buytaert committed
56
57
function forum_taxonomy($op, $type, $object) {
  if ($type == "vocabulary" && ($op == "insert" || $op == "update")) {
Dries Buytaert's avatar
   
Dries Buytaert committed
58
    if (variable_get("forum_nav_vocabulary", "") == "" && in_array("forum", $object["nodes"])) {
Dries Buytaert's avatar
Dries Buytaert committed
59
60
61
62
63
64
      // since none is already set, silently set this vocabulary as the navigation vocabulary
      variable_set("forum_nav_vocabulary", $object["vid"]);
    }
  }
}

Dries Buytaert's avatar
   
Dries Buytaert committed
65
function forum_load($node) {
Dries Buytaert's avatar
   
Dries Buytaert committed
66
  $forum = db_fetch_object(db_query("SELECT * FROM {forum} WHERE nid = %d", $node->nid));
Dries Buytaert's avatar
   
Dries Buytaert committed
67
68
69
70

  return $forum;
}

71
72
73
74
75
76
function forum_block($op = "list", $delta = 0) {
  if ($op == "list") {
    $blocks[0]["info"] = t("Forum topics");
  }
  else {
    if (user_access("access content")) {
Dries Buytaert's avatar
   
Dries Buytaert committed
77
      $content = node_title_list(db_query_range("SELECT n.nid, n.title, GREATEST(n.created, MAX(c.timestamp)) AS sort FROM {node} n LEFT JOIN {comments} c ON n.nid = c.nid WHERE n.type = 'forum' AND n.status = 1 GROUP BY n.nid, n.title, n.created ORDER BY sort DESC", 0, variable_get("forum_block_num", "5")), t("Active forum topics:"));
Dries Buytaert's avatar
   
Dries Buytaert committed
78

Dries Buytaert's avatar
   
Dries Buytaert committed
79
      $content .= node_title_list(db_query_range("SELECT nid, title FROM {node} WHERE type = 'forum' ORDER BY nid DESC", 0, variable_get("forum_block_num", "5")), t("New forum topics:"));
Dries Buytaert's avatar
   
Dries Buytaert committed
80

Dries Buytaert's avatar
   
Dries Buytaert committed
81
      if ($content) {
Dries Buytaert's avatar
   
Dries Buytaert committed
82
        $content .= "<div class=\"more-link\">". l(t("more"), "forum", array("title" => t("Read the latest forum topics."))) ."</div>";
Dries Buytaert's avatar
   
Dries Buytaert committed
83
      }
Dries Buytaert's avatar
   
Dries Buytaert committed
84

85
      $blocks["subject"] = t("Forum topics");
Dries Buytaert's avatar
   
Dries Buytaert committed
86
      $blocks["content"] = $content;
Dries Buytaert's avatar
   
Dries Buytaert committed
87
88
    }
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
89

Dries Buytaert's avatar
   
Dries Buytaert committed
90
91
92
  return $blocks;
}

93
function forum_link($type, $node = 0, $main = 0) {
Dries Buytaert's avatar
Dries Buytaert committed
94
  global $user;
Dries Buytaert's avatar
   
Dries Buytaert committed
95

Dries Buytaert's avatar
   
Dries Buytaert committed
96
97
  $links = array();

Dries Buytaert's avatar
   
Dries Buytaert committed
98
  if ($type == "page" && user_access("access content")) {
Dries Buytaert's avatar
   
Dries Buytaert committed
99
    $links[] = l(t("forums"), "forum");
Dries Buytaert's avatar
   
Dries Buytaert committed
100
101
  }

Dries Buytaert's avatar
   
Dries Buytaert committed
102
103
104
105
106
  if ($type == "system") {
    if (user_access("create forum topics")) {
      menu("node/add/forum", t("forum topic"), "node_page");
    }
    if (user_access("access content")) {
Dries Buytaert's avatar
   
Dries Buytaert committed
107
      menu("forum", t("forums"), "forum_page", 0, MENU_HIDE);
Dries Buytaert's avatar
   
Dries Buytaert committed
108
    }
Dries Buytaert's avatar
   
Dries Buytaert committed
109
110
  }

111
  if (!$main && $type == "node" && $node->type == "forum") {
Dries Buytaert's avatar
   
Dries Buytaert committed
112
113
    // get previous and next topic

Dries Buytaert's avatar
Dries Buytaert committed
114
    $result = db_query("SELECT n.nid, n.title, GREATEST(n.created, MAX(c.timestamp)) AS date_sort, COUNT(c.nid) AS num_comments FROM {node} n INNER JOIN {forum} f ON n.nid = f.nid INNER JOIN {comments} c ON n.nid = c.nid WHERE n.nid = f.nid AND f.tid = %d AND n.status = 1 GROUP BY n.nid, n.title, n.created ORDER BY ". _forum_get_topic_order(isset($user->sortby) ? $user->sortby : variable_get("forum_order", 1)), $node->tid);
Dries Buytaert's avatar
   
Dries Buytaert committed
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131

    while ($topic = db_fetch_object($result)) {
      if ($stop == 1) {
        $next->nid = $topic->nid;
        $next->title = $topic->title;
        break;
      }
      if ($topic->nid == $node->nid) {
        $stop = 1;
      }
      else {
        $prev->nid = $topic->nid;
        $prev->title = $topic->title;
      }
    }

    if ($prev) {
Dries Buytaert's avatar
Dries Buytaert committed
132
      $links[] = l(t("previous forum topic"), "node/view/$prev->nid", array("title" => $prev->title));
Dries Buytaert's avatar
   
Dries Buytaert committed
133
134
135
    }

    if ($next) {
Dries Buytaert's avatar
Dries Buytaert committed
136
      $links[] = l(t("next forum topic"), "node/view/$next->nid", array("title" => $next->title));
Dries Buytaert's avatar
   
Dries Buytaert committed
137
    }
Dries Buytaert's avatar
   
Dries Buytaert committed
138
139
  }

Dries Buytaert's avatar
   
Dries Buytaert committed
140
  return $links;
Dries Buytaert's avatar
   
Dries Buytaert committed
141
142
}

Dries Buytaert's avatar
   
Dries Buytaert committed
143
144
function forum_content($node, $main = 0) {
  return node_prepare($node, $main);
Dries Buytaert's avatar
   
Dries Buytaert committed
145
146
}

Dries Buytaert's avatar
   
Dries Buytaert committed
147
function forum_view($node, $main = 0, $page = 0) {
Dries Buytaert's avatar
   
Dries Buytaert committed
148

Dries Buytaert's avatar
   
Dries Buytaert committed
149
  if ($page) {
Dries Buytaert's avatar
   
Dries Buytaert committed
150
151
152
153
154
    $term_data = array_shift(taxonomy_node_get_terms($node->nid));
    if (!$term_data) {
      // we are previewing
      $term_data = taxonomy_get_term($node->taxonomy[0]);
    }
Dries Buytaert's avatar
   
Dries Buytaert committed
155

Dries Buytaert's avatar
   
Dries Buytaert committed
156
    // Breadcrumb navigation
Dries Buytaert's avatar
   
Dries Buytaert committed
157
158
159
160
161
162
163
    $breadcrumb = array(l(t("Home"), NULL), l(t("forum"), "forum"));
    if ($parents = taxonomy_get_parents_all($term_data->tid)) {
      $parents = array_reverse($parents);
      foreach ($parents as $p) {
        $breadcrumb[] = l($p->name, "forum/$p->tid");
      }
    }
Dries Buytaert's avatar
   
Dries Buytaert committed
164
    drupal_set_breadcrumb($breadcrumb);
165
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
166

Dries Buytaert's avatar
   
Dries Buytaert committed
167
  return theme("node", forum_content($node, $main), $main, $page);
Dries Buytaert's avatar
   
Dries Buytaert committed
168
169
}

170
171
172
173
function forum_validate(&$node) {
  // Make sure all fields are set properly:
  $node->icon = $node->icon ? $node->icon : "";
  $node->shadow = $node->shadow ? $node->shadow : 0;
174
  $node->tid = $node->tid ? $node->tid : 0;
175
176
177
178
179
180
  // We use the validate hook to remember the old taxonomy terms:
  if ($node->tid) {
    $node->taxonomy = array_keys(taxonomy_node_get_terms($node->nid));
    if (!in_array($node->tid[0], $node->taxonomy)) {
      $node->taxonomy[] = $node->tid[0];
    }
Dries Buytaert's avatar
Dries Buytaert committed
181
182
183
  }
}

Dries Buytaert's avatar
   
Dries Buytaert committed
184
function forum_form(&$node, &$error) {
Dries Buytaert's avatar
Dries Buytaert committed
185
186
187
  if ($node->tid) {
    // editing
    $tid = $node->tid;
188
189
  }
  else {
Dries Buytaert's avatar
Dries Buytaert committed
190
191
    // new topic
    $tid = arg(3);
192
193
  }

Dries Buytaert's avatar
   
Dries Buytaert committed
194
  $output .= _taxonomy_term_select(t("Forum"), "tid", $tid, variable_get("forum_nav_vocabulary", ""), "", 0, "", variable_get("forum_containers", array()));
Dries Buytaert's avatar
Dries Buytaert committed
195
196
197
198
199

  if ($node->nid) {
    // if editing, give option to leave shadows
    $output .= form_checkbox(t("Leave shadow copy"), "shadow", 1, $node->shadow, t("If you move this topic, you can leave a link in the old forum to the new forum."));
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
200

201
  $output .= form_textarea(t("Body"), "body", $node->body, 60, 10);
Dries Buytaert's avatar
   
Dries Buytaert committed
202
203
204
205

  return $output;
}

Dries Buytaert's avatar
   
Dries Buytaert committed
206
function forum_insert($node) {
Dries Buytaert's avatar
   
Dries Buytaert committed
207
  db_query("INSERT INTO {forum} (nid, shadow, tid) VALUES (%d, %d, %d)", $node->nid, $node->shadow, $node->tid[0]);
Dries Buytaert's avatar
   
Dries Buytaert committed
208
209
210
}

function forum_update($node) {
Dries Buytaert's avatar
   
Dries Buytaert committed
211
  db_query("UPDATE {forum} SET shadow = %d, tid = %d WHERE nid = %d", $node->shadow, $node->tid[0], $node->nid);
Dries Buytaert's avatar
   
Dries Buytaert committed
212
213
214
}

function forum_delete(&$node) {
Dries Buytaert's avatar
   
Dries Buytaert committed
215
  db_query("DELETE FROM {forum} WHERE nid = %d", $node->nid);
Dries Buytaert's avatar
   
Dries Buytaert committed
216
}
Dries Buytaert's avatar
   
Dries Buytaert committed
217

Dries Buytaert's avatar
   
Dries Buytaert committed
218
function _forum_num_comments($nid) {
Dries Buytaert's avatar
   
Dries Buytaert committed
219
  $value = db_fetch_object(db_query("SELECT COUNT(cid) AS count FROM {comments} WHERE nid = %d AND status = 0", $nid));
Dries Buytaert's avatar
   
Dries Buytaert committed
220
221
222
  return ($value) ? $value->count : 0;
}

Dries Buytaert's avatar
   
Dries Buytaert committed
223
function _forum_last_comment($nid) {
Dries Buytaert's avatar
   
Dries Buytaert committed
224
  $value = db_fetch_object(db_query_range("SELECT timestamp FROM {comments} WHERE nid = %d AND status = 0 ORDER BY timestamp DESC", $nid, 0, 1));
Dries Buytaert's avatar
   
Dries Buytaert committed
225
226
227
  return ($value) ? format_date($value->timestamp, "small") : "&nbsp;";
}

Dries Buytaert's avatar
   
Dries Buytaert committed
228
function _forum_last_reply($nid) {
Dries Buytaert's avatar
   
Dries Buytaert committed
229
  $value = db_fetch_object(db_query_range("SELECT c.timestamp, u.name, u.uid FROM {comments} c INNER JOIN {users} u ON c.uid = u.uid WHERE c.nid = %d AND c.status = 0 ORDER BY c.timestamp DESC", $nid, 0, 1));
Dries Buytaert's avatar
   
Dries Buytaert committed
230
231
232
233
234
  return $value;
}

function _forum_format($topic) {
  if ($topic) {
Dries Buytaert's avatar
   
Dries Buytaert committed
235
    return t("%date<br />by %author", array("%date" => format_date($topic->timestamp, "small"), "%author" => format_name($topic)));
Dries Buytaert's avatar
   
Dries Buytaert committed
236
237
238
239
240
241
242
243
244
245
246
247
248
  }
  else {
    return message_na();
  }
}

function forum_get_forums($tid = 0) {
  global $user;

  if (!$tid) {
    $tid = 0;
  }

Dries Buytaert's avatar
   
Dries Buytaert committed
249
  $cache = cache_get("forum:$tid");
Dries Buytaert's avatar
   
Dries Buytaert committed
250

Dries Buytaert's avatar
   
Dries Buytaert committed
251
  if (empty($cache)) {
252
    $forums = array();
Dries Buytaert's avatar
   
Dries Buytaert committed
253
    $_forums = taxonomy_get_tree(variable_get("forum_nav_vocabulary", ""), $tid);
Dries Buytaert's avatar
   
Dries Buytaert committed
254
255
    $n = 0;
    foreach ($_forums as $forum) {
Dries Buytaert's avatar
   
Dries Buytaert committed
256
257
258
      if (in_array($forum->tid, variable_get("forum_containers", array()))) {
        $forum->container = 1;
      }
Dries Buytaert's avatar
   
Dries Buytaert committed
259
260
261
      $forum->num_topics = _forum_num_topics($forum->tid);
      $forum->num_posts = _forum_num_replies($forum->tid) + $forum->num_topics;
      $forum->last_post = _forum_last_post($forum->tid);
Dries Buytaert's avatar
   
Dries Buytaert committed
262
263
264
265
      $forums[$forum->tid] = $forum;
      $n++;
    }

Dries Buytaert's avatar
   
Dries Buytaert committed
266
    cache_set("forum:$tid", serialize($forums), 1);
Dries Buytaert's avatar
   
Dries Buytaert committed
267
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
268
269
270
  else {
    $forums = unserialize($cache->data);
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
271
272
273
274
275
276
277
278
279
280
281
282

  if ($user->uid && $forums) {
    foreach (_forum_topics_read($user->uid) as $tid => $old) {
      if ($forums[$tid]) {
        $forums[$tid]->old_topics = $old;
      }
    }
  }
  return $forums;
}

function _forum_num_topics($term) {
Dries Buytaert's avatar
   
Dries Buytaert committed
283
  $value = db_fetch_object(db_query("SELECT COUNT(n.nid) AS count FROM {node} n INNER JOIN {forum} f ON n.nid = f.nid WHERE f.tid = %d AND n.nid = f.nid AND n.status = 1 AND n.type = 'forum'", $term));
Dries Buytaert's avatar
   
Dries Buytaert committed
284
285
286
287
  return ($value) ? $value->count : 0;
}

function _forum_num_replies($term) {
Dries Buytaert's avatar
   
Dries Buytaert committed
288
  $value = db_fetch_object(db_query("SELECT COUNT(*) AS count FROM {comments} c INNER JOIN {node} n ON n.nid = c.nid INNER JOIN {forum} f ON n.nid = f.nid WHERE f.tid = %d AND n.nid = f.nid AND n.nid = c.nid AND n.status = 1 AND c.status = 0 AND n.type = 'forum'", $term));
Dries Buytaert's avatar
   
Dries Buytaert committed
289
290
291
292
  return ($value) ? $value->count : 0;
}

function _forum_topics_read($uid) {
Dries Buytaert's avatar
   
Dries Buytaert committed
293
  $result = db_query("SELECT tid, count(*) AS c FROM {history} h INNER JOIN {node} n ON n.nid = h.nid INNER JOIN {forum} f ON n.nid = f.nid WHERE f.nid = n.nid AND n.nid = h.nid AND n.type = 'forum' AND n.status = 1 AND h.uid = %d GROUP BY tid", $uid);
Dries Buytaert's avatar
   
Dries Buytaert committed
294
295
296
297
298
299
300
301
302

  while ($obj = db_fetch_object($result)) {
    $topics_read[$obj->tid] = $obj->c;
  }

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

function _forum_last_post($term) {
Dries Buytaert's avatar
   
Dries Buytaert committed
303
  $topic = db_fetch_object(db_query_range("SELECT n.nid, n.created AS timestamp, u.name AS name, u.uid AS uid FROM {forum} f INNER JOIN {node} n ON n.nid = f.nid INNER JOIN {users} u ON n.uid = u.uid WHERE f.tid = %d AND n.nid = f.nid AND n.type = 'forum' AND n.status = 1 ORDER BY timestamp DESC", $term, 0, 1));
Dries Buytaert's avatar
   
Dries Buytaert committed
304

Dries Buytaert's avatar
   
Dries Buytaert committed
305
  $reply = db_fetch_object(db_query_range("SELECT n.nid, c.timestamp, u.name AS name, u.uid AS uid FROM {forum} f INNER JOIN {node} n ON n.nid = f.nid INNER JOIN {comments} c ON n.nid = c.nid INNER JOIN {users} u ON c.uid = u.uid WHERE f.tid = %d AND n.nid = f.nid AND n.type = 'forum' AND n.status = 1 AND c.status = 0 ORDER BY c.timestamp DESC", $term, 0, 1));
Dries Buytaert's avatar
   
Dries Buytaert committed
306
307
308
309
310
311

  $value = ($topic->timestamp > $reply->timestamp) ? $topic : $reply;

  return $value;
}

Dries Buytaert's avatar
Dries Buytaert committed
312
function forum_get_topics($tid, $sortby, $forum_per_page) {
Dries Buytaert's avatar
   
Dries Buytaert committed
313
  global $user, $forum_topic_list_header;
Dries Buytaert's avatar
   
Dries Buytaert committed
314

Dries Buytaert's avatar
   
Dries Buytaert committed
315
  $forum_topic_list_header = array(
316
317
      array("data" => "&nbsp;"),
      array("data" => t("Topic"), "field" => "n.title"),
Dries Buytaert's avatar
   
Dries Buytaert committed
318
      array("data" => t("Replies"), "field" => "num_comments"),
Dries Buytaert's avatar
   
Dries Buytaert committed
319
320
321
      array("data" => t("Created"), "field" => "n.created"),
      array("data" => t("Last reply"), "field" => "date_sort", "sort" => "desc"),
  );
Dries Buytaert's avatar
   
Dries Buytaert committed
322
323

  $sql_sortby = _forum_get_topic_order($sortby);
Dries Buytaert's avatar
   
Dries Buytaert committed
324
  for ($i = 0; $i < count($forum_topic_list_header); $i++) {
Dries Buytaert's avatar
   
Dries Buytaert committed
325
326
327
328
329
330
331
    if ($forum_topic_list_header[$i]["field"] == $sql_sortby) {
      $forum_topic_list_header[$i]["order"] = $sql_sortby;
    }
  }

  $term = taxonomy_get_term($tid);
  $voc = taxonomy_get_vocabulary($term->vid);
332
  $check_tid = $tid ? "'". check_query($tid) ."'" : "NULL";
Dries Buytaert's avatar
   
Dries Buytaert committed
333

Dries Buytaert's avatar
Dries Buytaert committed
334
  // show topics with the correct tid, or in the forum but with shadow = 1
Dries Buytaert's avatar
   
Dries Buytaert committed
335
336
  // @TODO: this is not ANSI SQL! ("user error: 'n.created' isn't in GROUP BY")
  // @TODO: timestamp is a sql reserved word. are there more?
Dries Buytaert's avatar
Dries Buytaert committed
337
  $sql = "SELECT n.nid, n.title, u.name AS name, u.uid AS uid, n.created AS timestamp, GREATEST(n.created, MAX(c.timestamp)) AS date_sort, COUNT(c.nid) AS num_comments, n.comment AS comment_mode, f.tid FROM {node} n INNER JOIN {term_node} r ON n.nid = r.nid INNER JOIN {users} u ON n.uid = u.uid LEFT JOIN {comments} c ON n.nid = c.nid INNER JOIN {forum} f ON n.nid = f.nid WHERE n.nid = r.nid AND ((r.tid = $check_tid AND f.shadow = 1) OR f.tid = $check_tid) AND n.status = 1 AND n.type = 'forum' GROUP BY n.nid, n.title, u.name, u.uid, n.created, n.comment, f.tid";
Dries Buytaert's avatar
   
Dries Buytaert committed
338
  $sql .= tablesort_sql($forum_topic_list_header);
Dries Buytaert's avatar
Dries Buytaert committed
339

Dries Buytaert's avatar
Dries Buytaert committed
340
  $sql_count = "SELECT COUNT(DISTINCT(n.nid)) FROM {node} n INNER JOIN {forum} f ON n.nid = f.nid INNER JOIN {term_node} r ON n.nid = r.nid WHERE n.nid = r.nid AND ( (r.tid = $check_tid AND f.shadow = 1) OR f.tid = $check_tid) AND n.status = 1 AND n.type = 'forum'";
Dries Buytaert's avatar
   
Dries Buytaert committed
341

Dries Buytaert's avatar
Dries Buytaert committed
342
  $result = pager_query($sql, $forum_per_page, 0, $sql_count);
Dries Buytaert's avatar
   
Dries Buytaert committed
343
344
345
346
  $topic_num = db_num_rows($result);

  $n = 0;
  while ($topic = db_fetch_object($result)) {
Dries Buytaert's avatar
Dries Buytaert committed
347
348
349
350
351
    if ($user->uid) {
      $history = _forum_user_last_visit($topic->nid);
      // folder is new if topic is new or there are new comments since last visit
      if ($topic->shadow > 0) {
        $topic->new = 0;
Dries Buytaert's avatar
   
Dries Buytaert committed
352
353
      }
      else {
Dries Buytaert's avatar
Dries Buytaert committed
354
355
        if (!$history && $user->uid) {
          $topic->new_replies = 0;
Dries Buytaert's avatar
   
Dries Buytaert committed
356
357
358
          $topic->new = 1;
        }
        else {
Dries Buytaert's avatar
   
Dries Buytaert committed
359
          $comments = db_result(db_query("SELECT COUNT(c.nid) FROM {node} n INNER JOIN {comments} c ON n.nid = c.nid WHERE n.nid = '$topic->nid' AND n.status = 1 AND c.status = 0 AND timestamp > '$history' GROUP BY n.nid"));
Dries Buytaert's avatar
Dries Buytaert committed
360
361
362
363
364
365
366
367

          $topic->new_replies = $comments ? $comments : 0;
          if ($topic->new_replies) {
            $topic->new = 1;
          }
          else {
            $topic->new = 0;
          }
Dries Buytaert's avatar
   
Dries Buytaert committed
368
369
        }
      }
Dries Buytaert's avatar
Dries Buytaert committed
370
371
372
373
374
375
     }
     else {
      // you're not logged in eh?
      $topic->new_replies = 0;
      $topic->new = 0;
     }
Dries Buytaert's avatar
   
Dries Buytaert committed
376
377
378
379
380

    $topic->last_reply = _forum_last_reply($topic->nid);
    $topics[] = $topic;
  }

Dries Buytaert's avatar
Dries Buytaert committed
381
  return $topics;
Dries Buytaert's avatar
   
Dries Buytaert committed
382
383
}

Dries Buytaert's avatar
Dries Buytaert committed
384
function _forum_new($tid) {
Dries Buytaert's avatar
   
Dries Buytaert committed
385
  global $user;
Dries Buytaert's avatar
   
Dries Buytaert committed
386
  $result = db_query("SELECT n.nid FROM {node} n, {history} h, {forum} f WHERE n.type = 'forum' AND n.status = 1 AND h.nid = n.nid AND f.nid = h.nid AND f.tid = %d AND h.uid = %d", $tid, $user->uid);
Dries Buytaert's avatar
   
Dries Buytaert committed
387
388
389
390
  while ($r = db_fetch_object($result)) {
    $read[] = $r->nid;
  }

Dries Buytaert's avatar
   
Dries Buytaert committed
391
  $nid = db_result(db_query_range("SELECT n.nid FROM {node} n INNER JOIN {forum} f ON n.nid = f.nid WHERE n.type = 'forum' AND f.nid = n.nid AND n.status = 1 AND f.tid = %d ". ($read ? "AND NOT (n.nid IN (". implode(",", $read) .")) " : "") ."ORDER BY created", $tid, 0, 1));
Dries Buytaert's avatar
   
Dries Buytaert committed
392
393
394
395

  return $nid ? $nid : 0;
}

Dries Buytaert's avatar
   
Dries Buytaert committed
396
function _forum_message_taxonomy() {
397
  return t("Forums are threaded discussions based on the taxonomy system.  For the forums to work, the taxonomy module has to be installed and enabled.  When activated, a taxonomy vocabulary (eg. \"forums\") needs to be <a href=\"%created\">created</a> and bound to the node type \"forum topic\".", array('%created' => url('admin/taxonomy/add/vocabulary')));
Dries Buytaert's avatar
   
Dries Buytaert committed
398
399
}

Dries Buytaert's avatar
   
Dries Buytaert committed
400
function forum_page() {
Dries Buytaert's avatar
   
Dries Buytaert committed
401
  global $sortby, $forum_per_page, $from, $user;
Dries Buytaert's avatar
   
Dries Buytaert committed
402

Dries Buytaert's avatar
   
Dries Buytaert committed
403
  $op = $_POST["op"];
Dries Buytaert's avatar
   
Dries Buytaert committed
404

Dries Buytaert's avatar
   
Dries Buytaert committed
405
  if (user_access("access content")) {
Dries Buytaert's avatar
   
Dries Buytaert committed
406
    if (module_exist("taxonomy")) {
Dries Buytaert's avatar
   
Dries Buytaert committed
407
      $tid = arg(1);
Dries Buytaert's avatar
   
Dries Buytaert committed
408

Dries Buytaert's avatar
Dries Buytaert committed
409
410
411
412
413
      if (arg(2) == "new") {
        if ($nid = _forum_new($tid)) {
          drupal_goto(url("node/view/$nid"));
        }
      }
Dries Buytaert's avatar
   
Dries Buytaert committed
414

Dries Buytaert's avatar
   
Dries Buytaert committed
415
      if (empty($sortby)) {
Dries Buytaert's avatar
   
Dries Buytaert committed
416
        $sortby = isset($user->sortby) ? $user->sortby : variable_get("forum_order", 1);
Dries Buytaert's avatar
   
Dries Buytaert committed
417
      }
Dries Buytaert's avatar
   
Dries Buytaert committed
418

Dries Buytaert's avatar
   
Dries Buytaert committed
419
420
421
      if (empty($forum_per_page)) {
        $forum_per_page = isset($user->forum_per_page) ? $user->forum_per_page : variable_get("forum_per_page", 25);
      }
Dries Buytaert's avatar
   
Dries Buytaert committed
422

Dries Buytaert's avatar
Dries Buytaert committed
423
      $offset = ($from / $forum_per_page) + 1;
Dries Buytaert's avatar
   
Dries Buytaert committed
424

Dries Buytaert's avatar
   
Dries Buytaert committed
425
      $forums = forum_get_forums($tid);
Dries Buytaert's avatar
   
Dries Buytaert committed
426
      $parents = taxonomy_get_parents_all($tid);
Dries Buytaert's avatar
   
Dries Buytaert committed
427
428
429
      if ($tid && !in_array($tid, variable_get("forum_containers", array()))) {
        $topics = forum_get_topics($tid, $sortby, $forum_per_page);
      }
Dries Buytaert's avatar
   
Dries Buytaert committed
430

Dries Buytaert's avatar
   
Dries Buytaert committed
431
      print theme("forum_display", $forums, $topics, $parents, $tid, $sortby, $forum_per_page, $offset);
Dries Buytaert's avatar
   
Dries Buytaert committed
432
433
    }
    else {
Dries Buytaert's avatar
   
Dries Buytaert committed
434
      print theme("page", _forum_message_taxonomy(), t("Warning"));
Dries Buytaert's avatar
   
Dries Buytaert committed
435
    }
Dries Buytaert's avatar
   
Dries Buytaert committed
436
437
  }
  else {
Dries Buytaert's avatar
   
Dries Buytaert committed
438
    print theme("page", message_access());
Dries Buytaert's avatar
   
Dries Buytaert committed
439
440
441
  }
}

Dries Buytaert's avatar
   
Dries Buytaert committed
442
/**
Dries Buytaert's avatar
   
Dries Buytaert committed
443
444
445
 * @addtogroup themeable
 * @{
 */
Dries Buytaert's avatar
   
Dries Buytaert committed
446
447

/**
Dries Buytaert's avatar
   
Dries Buytaert committed
448
449
450
451
452
453
454
455
456
457
458
459
 * Format the forum body.
 *
 * @param forums
 * @param topics
 * @param parents
 * @param tid
 * @param sortby
 * @param forum_per_page
 * @param offset
 *
 * @return the output for the forum body.
 */
Dries Buytaert's avatar
   
Dries Buytaert committed
460
function theme_forum_display($forums, $topics, $parents, $tid, $sortby, $forum_per_page, $offset) {
Dries Buytaert's avatar
   
Dries Buytaert committed
461
  // forum list, topics list, topic browser and "add new topic" link
Dries Buytaert's avatar
   
Dries Buytaert committed
462

Dries Buytaert's avatar
   
Dries Buytaert committed
463
  $title = t("forums");
Dries Buytaert's avatar
   
Dries Buytaert committed
464

Dries Buytaert's avatar
   
Dries Buytaert committed
465
466
467
  /*
  ** Breadcrumb navigation:
  */
Dries Buytaert's avatar
   
Dries Buytaert committed
468
  $breadcrumb[] = l(t("Home"), "");
Dries Buytaert's avatar
   
Dries Buytaert committed
469
470
471
  if ($tid) {
    $breadcrumb[] = l($title, "forum");
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
472
473

  if ($parents) {
Dries Buytaert's avatar
   
Dries Buytaert committed
474
475
    $parents = array_reverse($parents);
    foreach ($parents as $p) {
476
477
      if ($p->tid == $tid) {
        $title = $p->name;
Dries Buytaert's avatar
   
Dries Buytaert committed
478
479
      }
      else {
Dries Buytaert's avatar
   
Dries Buytaert committed
480
        $breadcrumb[] = l($p->name, "forum/$p->tid");
Dries Buytaert's avatar
   
Dries Buytaert committed
481
482
483
484
      }
    }
  }

Dries Buytaert's avatar
   
Dries Buytaert committed
485
486
  if (count($forums) || count($parents)) {
    $output  = "<div id=\"forum\">";
Dries Buytaert's avatar
   
Dries Buytaert committed
487
    $output .= theme("forum_list", $forums, $parents, $tid);
Dries Buytaert's avatar
   
Dries Buytaert committed
488

Dries Buytaert's avatar
   
Dries Buytaert committed
489
    if ($tid && !in_array($tid, variable_get("forum_containers", array()))) {
Dries Buytaert's avatar
   
Dries Buytaert committed
490
      $output .= theme("forum_topic_list", $tid, $topics, $sortby, $forum_per_page, $offset);
Dries Buytaert's avatar
   
Dries Buytaert committed
491
492
493
494
495
496
    }
    $output .= "</div>";
  }
  else {
    $title = t("No forums defined");
    $output = '';
Dries Buytaert's avatar
   
Dries Buytaert committed
497
498
  }

Dries Buytaert's avatar
   
Dries Buytaert committed
499
  print theme("page", $output, $title, $breadcrumb);
Dries Buytaert's avatar
   
Dries Buytaert committed
500
501
}

Dries Buytaert's avatar
   
Dries Buytaert committed
502
/**
Dries Buytaert's avatar
   
Dries Buytaert committed
503
504
505
506
507
508
509
510
 * Format the forum listing.
 *
 * @param forums
 * @param parents
 * @param tid
 *
 * @return output for the forum listing.
 */
Dries Buytaert's avatar
   
Dries Buytaert committed
511
function theme_forum_list($forums, $parents, $tid) {
Dries Buytaert's avatar
   
Dries Buytaert committed
512
513
  global $user;

Dries Buytaert's avatar
   
Dries Buytaert committed
514
515
  if ($forums) {

Dries Buytaert's avatar
   
Dries Buytaert committed
516
    $header = array(t("Forum"), t("Topics"), t("Posts"), t("Last post"));
Dries Buytaert's avatar
   
Dries Buytaert committed
517
518

    foreach ($forums as $forum) {
Dries Buytaert's avatar
   
Dries Buytaert committed
519
520
521
522
      if ($forum->container) {
        $forum->num_topics = "";
        $forum->num_posts = "";
        $forum->last_post = "";
Dries Buytaert's avatar
   
Dries Buytaert committed
523
524
        $new_topics = 0;
        $links = array();
525
      }
Dries Buytaert's avatar
   
Dries Buytaert committed
526
527
528
529
      else {
        if ($user->uid) {
          $new_topics = $forum->num_topics - $forum->old_topics;
        }
Dries Buytaert's avatar
   
Dries Buytaert committed
530

Dries Buytaert's avatar
   
Dries Buytaert committed
531
        $links = array();
Dries Buytaert's avatar
   
Dries Buytaert committed
532

Dries Buytaert's avatar
   
Dries Buytaert committed
533
534
535
        if ($forum->last_post) {
          $links[] = l(t("the most recent topic"), "node/view/". $forum->last_post->nid);
        }
Dries Buytaert's avatar
   
Dries Buytaert committed
536

Dries Buytaert's avatar
   
Dries Buytaert committed
537
538
539
        if ($new_topics) {
          $links[] = l(t("the first new topic"), "forum/$forum->tid/new");
        }
Dries Buytaert's avatar
   
Dries Buytaert committed
540
      }
Dries Buytaert's avatar
   
Dries Buytaert committed
541
542
543
544
545
546
547
548
549
550

      $description  = "<div class=\"forum\" style=\"margin-left: ". ($forum->depth * 30) ."px;\">\n";
      $description .= " <div class=\"name\">". l($forum->name, "forum/$forum->tid") ."</div>\n";

      if ($forum->description) {
        $description .= " <div class=\"description\">$forum->description</div>\n";
      }
      if ($links) {
        $description .= " <div class=\"navigation\">". t("Jump to: %links", array("%links" => implode(", ", $links))) .".</div>\n";
      }
Dries Buytaert's avatar
   
Dries Buytaert committed
551
      $description .= "</div>\n";
Dries Buytaert's avatar
   
Dries Buytaert committed
552
553
554

      $rows[] = array(
        array("data" => $description, "class" => "description"),
555
        array("data" => $forum->num_topics . ($new_topics ? "<br />(". t("%a new", array("%a" => $new_topics)) .")" : ""), "class" => "topics"),
Dries Buytaert's avatar
   
Dries Buytaert committed
556
        array("data" => $forum->num_posts, "class" => "posts"),
Dries Buytaert's avatar
   
Dries Buytaert committed
557
558
        array("data" => ($forum->container ? "" : _forum_format($forum->last_post)), "class" => "last-reply")

Dries Buytaert's avatar
   
Dries Buytaert committed
559
560
       );

Dries Buytaert's avatar
   
Dries Buytaert committed
561
562
563
    }
  }

Dries Buytaert's avatar
   
Dries Buytaert committed
564
  return theme("table", $header, $rows);
Dries Buytaert's avatar
   
Dries Buytaert committed
565
566
}

Dries Buytaert's avatar
   
Dries Buytaert committed
567
/**
Dries Buytaert's avatar
   
Dries Buytaert committed
568
569
570
571
572
573
574
575
576
577
 * Format the topic listing.
 *
 * @param tid
 * @param topics
 * @param sortby
 * @param forum_per_page
 * @param offset
 *
 * @return output for the topic list.
 */
Dries Buytaert's avatar
   
Dries Buytaert committed
578
function theme_forum_topic_list($tid, $topics, $sortby, $forum_per_page, $offset) {
Dries Buytaert's avatar
   
Dries Buytaert committed
579
  global $id, $status, $user, $pager_total, $forum_topic_list_header;
Dries Buytaert's avatar
   
Dries Buytaert committed
580
581

  if ($topics) {
Dries Buytaert's avatar
   
Dries Buytaert committed
582

Dries Buytaert's avatar
   
Dries Buytaert committed
583
584
    foreach ($topics as $topic) {
      // folder is new if topic is new or there are new comments since last visit
Dries Buytaert's avatar
Dries Buytaert committed
585
      if ($topic->tid != $tid) {
Dries Buytaert's avatar
   
Dries Buytaert committed
586
        $rows[] = array(
Dries Buytaert's avatar
   
Dries Buytaert committed
587
          array("data" => _forum_icon($topic->new, $topic->num_comments, $topic->comment_mode), "class" => "icon"),
Dries Buytaert's avatar
   
Dries Buytaert committed
588
          array("data" => $topic->title, "class" => "title"),
Dries Buytaert's avatar
   
Dries Buytaert committed
589
          array("data" => l(t("This topic has been moved"), "forum/$topic->tid"), "colspan" => "3")
Dries Buytaert's avatar
   
Dries Buytaert committed
590
        );
Dries Buytaert's avatar
   
Dries Buytaert committed
591
592
      }
      else {
Dries Buytaert's avatar
   
Dries Buytaert committed
593
        $rows[] = array(
Dries Buytaert's avatar
   
Dries Buytaert committed
594
          array("data" => _forum_icon($topic->new, $topic->num_comments, $topic->comment_mode), "class" => "icon"),
Dries Buytaert's avatar
   
Dries Buytaert committed
595
          array("data" => l($topic->title, "node/view/$topic->nid"), "class" => "topic"),
596
          array("data" => $topic->num_comments . ($topic->new_replies ? "<br />(". t("%a new", array("%a" => $topic->new_replies)) .")" : ""), "class" => "replies"),
Dries Buytaert's avatar
   
Dries Buytaert committed
597
598
          array("data" => _forum_format($topic), "class" => "created"),
          array("data" => _forum_format($topic->last_reply), "class" => "last-reply")
Dries Buytaert's avatar
   
Dries Buytaert committed
599
        );
Dries Buytaert's avatar
   
Dries Buytaert committed
600
601
602
      }
    }

Dries Buytaert's avatar
Dries Buytaert committed
603
    if ($pager = theme("pager", NULL, $forum_per_page, 0, tablesort_pager())) {
Dries Buytaert's avatar
   
Dries Buytaert committed
604
      $rows[] = array(array("data" => $pager, "colspan" => "5", "class" => "pager"));
Dries Buytaert's avatar
   
Dries Buytaert committed
605
606
    }
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
607
608


Dries Buytaert's avatar
Dries Buytaert committed
609
  if (user_access("create forum topics")) {
Dries Buytaert's avatar
   
Dries Buytaert committed
610
    $output = l(t("create new forum topic"), "node/add/forum/$tid") ."<br /><br />";
Dries Buytaert's avatar
   
Dries Buytaert committed
611
612
  }

Dries Buytaert's avatar
   
Dries Buytaert committed
613
  $output .= theme("table", $forum_topic_list_header, $rows);
Dries Buytaert's avatar
   
Dries Buytaert committed
614

Dries Buytaert's avatar
   
Dries Buytaert committed
615
616
617
  return $output;
}

Dries Buytaert's avatar
   
Dries Buytaert committed
618
/** @} End of addtogroup themeable */
Dries Buytaert's avatar
   
Dries Buytaert committed
619

Dries Buytaert's avatar
   
Dries Buytaert committed
620
function _forum_icon($new_posts, $num_posts = 0, $comment_mode = 0) {
Dries Buytaert's avatar
   
Dries Buytaert committed
621

Dries Buytaert's avatar
   
Dries Buytaert committed
622
  $base_path = variable_get("forum_icon_path", "");
Dries Buytaert's avatar
   
Dries Buytaert committed
623
624
  if ($base_path) {
    if ($num_posts > variable_get("forum_hot_topic", 15)) {
Dries Buytaert's avatar
   
Dries Buytaert committed
625
      $icon = $new_posts ? "hot-new" : "hot";
Dries Buytaert's avatar
   
Dries Buytaert committed
626
627
628
629
630
631
632
633
634
    }
    else {
      $icon = $new_posts ? "new" : "default";
    }

    if ($comment_mode == 1) {
      $icon = "closed";
    }

Dries Buytaert's avatar
   
Dries Buytaert committed
635
    // default
Dries Buytaert's avatar
   
Dries Buytaert committed
636
    $file = $base_path ."/forum-$icon.gif";
Dries Buytaert's avatar
   
Dries Buytaert committed
637

Dries Buytaert's avatar
   
Dries Buytaert committed
638
    return "<img src=\"$file\" alt=\"\" title=\"\" />";
Dries Buytaert's avatar
   
Dries Buytaert committed
639
640
641
642
643
644
645
646
647
648
  }
  else {
    return "&nbsp;";
  }
}

function _forum_user_last_visit($nid) {
  global $user;
  static $history;
  if (!$history) {
Dries Buytaert's avatar
   
Dries Buytaert committed
649
    $result = db_query("SELECT nid, timestamp FROM {history} WHERE uid = %d", $user->uid);
Dries Buytaert's avatar
   
Dries Buytaert committed
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
    while ($t = db_fetch_object($result)) {
      $history[$t->nid] = $t->timestamp;
    }
  }
  return $history[$nid] ? $history[$nid] : 0;
}

function _forum_get_topic_order($sortby) {
  switch ($sortby) {
    case 1:
      return "date_sort DESC";
      break;
    case 2:
      return "date_sort ASC";
      break;
    case 3:
      return "num_comments DESC";
      break;
    case 4:
      return "num_comments ASC";
      break;
  }
}

Dries Buytaert's avatar
   
Dries Buytaert committed
674
function forum_help($section = "admin/help#forum") {
Dries Buytaert's avatar
   
Dries Buytaert committed
675
676
677
  $output = "";

  switch ($section) {
Dries Buytaert's avatar
   
Dries Buytaert committed
678
    case 'admin/help#forum':
Dries Buytaert's avatar
   
Dries Buytaert committed
679
      $output .= "<h3>Creating a forum</h3>";
680
681
      $output .= "<p>The forum module uses taxonomy to organize itself. To create a forum you first have to create a <a href=\"%taxonomy\">taxonomy vocabulary</a>. When doing this, choose a sensible name for it (such as \"fora\") and make sure under \"Types\" that \"forum\" is selected. Once you have done this, <a href=\"%taxo-terms\">add some terms</a> to it. Each term will become a forum. If you fill in the description field, users will be given additonal information about the forum on the main forum page. For example: \"troubleshooting\" - \"Please ask your questions here.\"</p>";
      $output .= "<p>When you are happy with your vocabulary, go to <a href=\"%forums\">administer &raquo; configutation &raquo; modules &raquo; forum</a> and set <strong>Forum vocabulary</strong> to the one you have just created. There will now be fora active on the site. For users to access them they must have the \"access content\" <a href=\"%permission\">permission</a> and to create a topic they must have the \"create forum topics\" <a href=\"%permission\">permission</a>. These permissions can be set in the <a href=\"%permission\">permission</a> pages.</p>";
Dries Buytaert's avatar
   
Dries Buytaert committed
682
      $output .= "<h4>Icons</h4>";
683
      $output .= "<p>To disable icons, set the icon path as blank in <a href=\"%forums\">administer &raquo; configutation &raquo; modules &raquo; forum</a>.</p>";
Dries Buytaert's avatar
   
Dries Buytaert committed
684
      $output .= "<p>All files in the icon directory are assumed to be images. You may use images of whatever size you wish, but it is recommended to use 15x15 or 16x16.</p>";
685
      $output = t($output, array("%taxonomy" => url("admin/taxonomy/add/vocabulary"), "%taxo-terms" => url("admin/taxonomy"), "%forums" => url("admin/system/modules/forum"), "%permission" => url("admin/user/permission")));
Dries Buytaert's avatar
   
Dries Buytaert committed
686
      break;
Dries Buytaert's avatar
   
Dries Buytaert committed
687
    case 'admin/system/modules#description':
Dries Buytaert's avatar
   
Dries Buytaert committed
688
      $output = t("Enable threaded discussions about general topics.");
Dries Buytaert's avatar
   
Dries Buytaert committed
689
690
      break;
    case 'admin/system/modules/forum':
Dries Buytaert's avatar
   
Dries Buytaert committed
691
      $output = _forum_message_taxonomy();
Dries Buytaert's avatar
   
Dries Buytaert committed
692
      break;
Dries Buytaert's avatar
   
Dries Buytaert committed
693
694
695
    case 'node/add/forum':
      $output = variable_get('forum_help', '');
      break;
Dries Buytaert's avatar
   
Dries Buytaert committed
696
  }
Dries Buytaert's avatar
   
Dries Buytaert committed
697

Dries Buytaert's avatar
   
Dries Buytaert committed
698
  return $output;
Dries Buytaert's avatar
   
Dries Buytaert committed
699
700
701
}

?>