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

Dries's avatar
 
Dries committed
4 5
function forum_help($section = 'admin/help#forum') {
  $output = '';
Dries's avatar
 
Dries committed
6 7 8 9 10 11 12 13 14 15 16 17

  switch ($section) {
    case 'admin/help#forum':
      $output = t("
      <h3>Creating a forum</h3>
      <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>
      <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>
      <h4>Icons</h4>
      <p>To disable icons, set the icon path as blank in <a href=\"%forums\">administer &raquo; configutation &raquo; modules &raquo; forum</a>.</p>
      <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>", array("%taxonomy" => url("admin/taxonomy/add/vocabulary"), "%taxo-terms" => url("admin/taxonomy"), "%forums" => url("admin/system/modules/forum"), "%permission" => url("admin/user/permission")));
      break;
    case 'admin/system/modules#description':
Dries's avatar
 
Dries committed
18
      $output = t('Enable threaded discussions about general topics.');
Dries's avatar
 
Dries committed
19 20 21 22 23 24 25
      break;
    case 'admin/system/modules/forum':
      $output = 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')));
      break;
    case 'node/add/forum':
      $output = variable_get('forum_help', '');
      break;
Dries's avatar
 
Dries committed
26
    case 'node/add#forum':
Dries's avatar
 
Dries committed
27
      $output = t('A forum is a threaded discussion, enabling users to communicate about a particular topic.');
Dries's avatar
 
Dries committed
28
      break;
Dries's avatar
 
Dries committed
29 30 31 32 33
  }

  return $output;
}

Dries's avatar
 
Dries committed
34
function forum_node_name($node) {
Dries's avatar
 
Dries committed
35
  return t('forum topic');
Dries's avatar
 
Dries committed
36 37 38
}

function forum_access($op, $node) {
Dries's avatar
 
Dries committed
39
  if ($op == 'view') {
Dries's avatar
 
Dries committed
40 41
    return $node->status;
  }
Dries's avatar
 
Dries committed
42 43
  if ($op == 'create') {
    return user_access('create forum topics');
Dries's avatar
 
Dries committed
44
  }
Dries's avatar
 
Dries committed
45 46
}

Dries's avatar
 
Dries committed
47
function forum_perm() {
Dries's avatar
 
Dries committed
48
  return array('create forum topics');
Dries's avatar
 
Dries committed
49
}
Dries's avatar
 
Dries committed
50

51
function forum_settings() {
Dries's avatar
 
Dries committed
52

Dries's avatar
 
Dries committed
53 54 55
  if (module_exist('taxonomy')) {
    $vocs[0] = '<'. t('none') .'>';
    foreach (taxonomy_get_vocabularies('forum') as $vid => $voc) {
Dries's avatar
 
Dries committed
56 57 58
      $vocs[$vid] = $voc->name;
    }

Dries's avatar
 
Dries committed
59
    if ($voc) {
Dries's avatar
 
Dries committed
60
      $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."));
61
      $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') .'>');
62

Dries's avatar
 
Dries committed
63
      $output = form_group(t('Forum structure settings'), $group);
64

Dries's avatar
 
Dries committed
65 66
      $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's avatar
 
Dries committed
67
      $number = drupal_map_assoc(array(5, 10, 15, 20, 25, 30, 35, 40, 50, 60, 80, 100, 10000));
Dries's avatar
 
Dries committed
68
      $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's avatar
 
Dries committed
69
      $number = drupal_map_assoc(array(10, 25, 50, 75, 100));
Dries's avatar
 
Dries committed
70 71 72
      $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.'));
      $forder = array(1 => t('Date - newest first'), 2 => t('Date - oldest first'), 3 => t('Posts - most active first'), 4=> t('Posts - least active first'));
      $group .= form_radios(t('Default order'), 'forum_order', variable_get('forum_order', '1'), $forder, t('The default display order for topics.'));
Dries's avatar
 
Dries committed
73
      $output .= form_group(t('Forum viewing options'), $group);
74

Dries's avatar
 
Dries committed
75
      $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, go to the <a href=\"%block-administration\">block administration</a> page.", array('%block-administration' => url('admin/system/block'))));
Dries's avatar
 
Dries committed
76
      $output .= form_group(t('"Forum topic" block settings'), $group);
Dries's avatar
 
Dries committed
77 78
    }
  }
Dries's avatar
 
Dries committed
79

Dries's avatar
 
Dries committed
80 81 82
  return $output;
}

Dries's avatar
Dries committed
83
function forum_taxonomy($op, $type, $object) {
Dries's avatar
 
Dries committed
84 85
  if ($type == 'vocabulary' && ($op == 'insert' || $op == 'update')) {
    if (variable_get('forum_nav_vocabulary', '') == '' && in_array('forum', $object['nodes'])) {
Dries's avatar
Dries committed
86
      // since none is already set, silently set this vocabulary as the navigation vocabulary
Dries's avatar
 
Dries committed
87
      variable_set('forum_nav_vocabulary', $object['vid']);
Dries's avatar
Dries committed
88 89 90 91
    }
  }
}

Dries's avatar
 
Dries committed
92
function forum_load($node) {
Dries's avatar
 
Dries committed
93
  $forum = db_fetch_object(db_query('SELECT * FROM {forum} WHERE nid = %d', $node->nid));
Dries's avatar
 
Dries committed
94 95 96 97

  return $forum;
}

Dries's avatar
 
Dries committed
98
function forum_block($op = 'list', $delta = 0) {
Dries's avatar
 
Dries committed
99 100
  global $user;

Dries's avatar
 
Dries committed
101 102
  if ($op == 'list') {
    $blocks[0]['info'] = t('Forum topics');
103 104
  }
  else {
Dries's avatar
 
Dries committed
105
    if (user_access('access content')) {
Dries's avatar
 
Dries committed
106
      $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's avatar
 
Dries committed
107

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

Dries's avatar
 
Dries committed
110
      if ($content) {
Dries's avatar
 
Dries committed
111
        $content .= "<div class=\"more-link\">". l(t('more'), 'forum', array('title' => t('Read the latest forum topics.'))) .'</div>';
Dries's avatar
 
Dries committed
112
      }
Dries's avatar
 
Dries committed
113

Dries's avatar
 
Dries committed
114 115
      $blocks['subject'] = t('Forum topics');
      $blocks['content'] = $content;
Dries's avatar
 
Dries committed
116 117
    }
  }
Dries's avatar
 
Dries committed
118

Dries's avatar
 
Dries committed
119 120 121
  return $blocks;
}

Dries's avatar
 
Dries committed
122 123 124
/**
 * Implementation of hook_link().
 */
125
function forum_link($type, $node = 0, $main = 0) {
Dries's avatar
Dries committed
126
  global $user;
Dries's avatar
 
Dries committed
127

Dries's avatar
 
Dries committed
128 129
  $links = array();

Dries's avatar
 
Dries committed
130 131
  if ($type == 'page' && user_access('access content')) {
    $links[] = l(t('forums'), 'forum');
Dries's avatar
 
Dries committed
132 133
  }

Dries's avatar
 
Dries committed
134
  if ($type == 'system') {
Dries's avatar
 
Dries committed
135 136
    menu('node/add/forum', t('forum topic'), user_access('create forum topics') ? 'node_page' : MENU_DENIED);
    menu('forum', t('forums'), user_access('access content') ? 'forum_page' : MENU_DENIED, 0, MENU_HIDE);
Dries's avatar
 
Dries committed
137 138
  }

Dries's avatar
 
Dries committed
139
  if (!$main && $type == 'node' && $node->type == 'forum') {
Dries's avatar
 
Dries committed
140 141
    // get previous and next topic

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

    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's avatar
 
Dries committed
160
      $links[] = l(t('previous forum topic'), "node/view/$prev->nid", array('title' => $prev->title));
Dries's avatar
 
Dries committed
161 162 163
    }

    if ($next) {
Dries's avatar
 
Dries committed
164
      $links[] = l(t('next forum topic'), "node/view/$next->nid", array('title' => $next->title));
Dries's avatar
 
Dries committed
165
    }
Dries's avatar
 
Dries committed
166 167
  }

Dries's avatar
 
Dries committed
168
  return $links;
Dries's avatar
 
Dries committed
169 170
}

Dries's avatar
 
Dries committed
171 172
function forum_content($node, $main = 0) {
  return node_prepare($node, $main);
Dries's avatar
 
Dries committed
173 174
}

Dries's avatar
 
Dries committed
175
function forum_view($node, $main = 0, $page = 0) {
Dries's avatar
 
Dries committed
176

Dries's avatar
 
Dries committed
177
  if ($page) {
Dries's avatar
 
Dries committed
178
    $vocabulary = taxonomy_get_vocabulary(variable_get('forum_nav_vocabulary', ''));
Dries's avatar
 
Dries committed
179
    // Breadcrumb navigation
Dries's avatar
 
Dries committed
180
    $breadcrumb = array(l(t('Home'), NULL), l($vocabulary->name, 'forum'));
Dries's avatar
 
Dries committed
181
    if ($parents = taxonomy_get_parents_all($node->tid)) {
Dries's avatar
 
Dries committed
182 183 184 185 186
      $parents = array_reverse($parents);
      foreach ($parents as $p) {
        $breadcrumb[] = l($p->name, "forum/$p->tid");
      }
    }
Dries's avatar
 
Dries committed
187
    drupal_set_breadcrumb($breadcrumb);
188
  }
Dries's avatar
 
Dries committed
189

Dries's avatar
 
Dries committed
190
  return theme('node', forum_content($node, $main), $main, $page);
Dries's avatar
 
Dries committed
191 192
}

193 194
function forum_validate(&$node) {
  // Make sure all fields are set properly:
Dries's avatar
 
Dries committed
195
  $node->icon = $node->icon ? $node->icon : '';
196
  $node->shadow = $node->shadow ? $node->shadow : 0;
Dries's avatar
 
Dries committed
197 198 199

  if ($node->taxonomy) {
    // Extract the node's proper topic ID.
Dries's avatar
 
Dries committed
200
    $vocabulary = variable_get('forum_nav_vocabulary', '');
201
    $containers = variable_get('forum_containers', array());
Dries's avatar
 
Dries committed
202
    foreach ($node->taxonomy as $term) {
Dries's avatar
 
Dries committed
203
      if (db_result(db_query('SELECT COUNT(*) FROM {term_data} WHERE tid = %d AND vid = %d', $term, $vocabulary))) {
204 205 206 207 208 209 210
        if (in_array($term, $containers)) {
          $term = taxonomy_get_term($term);
          $error['taxonomy'] = theme('error', t('The item \'%forum\' is only a container for forums. Please select one of the forums below it.', array('%forum' => $term->name)));
        }
        else {
          $node->tid = $term;
        }
Dries's avatar
 
Dries committed
211
      }
212
    }
Dries's avatar
Dries committed
213
  }
214
  return $error;
Dries's avatar
Dries committed
215 216
}

Dries's avatar
 
Dries committed
217
function forum_form(&$node, &$error) {
Dries's avatar
 
Dries committed
218
  if (!$node->nid) {
Dries's avatar
Dries committed
219
    // new topic
Dries's avatar
 
Dries committed
220
    $node->taxonomy[] = arg(3);
221 222
  }

223
  $output = implode('', taxonomy_node_form('forum', $node, $error));
Dries's avatar
Dries committed
224 225 226

  if ($node->nid) {
    // if editing, give option to leave shadows
Dries's avatar
 
Dries committed
227
    $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's avatar
Dries committed
228
  }
Dries's avatar
 
Dries committed
229

Dries's avatar
 
Dries committed
230
  $output .= form_textarea(t('Body'), 'body', $node->body, 60, 10, filter_tips_short());
Dries's avatar
 
Dries committed
231 232 233 234

  return $output;
}

Dries's avatar
 
Dries committed
235
function forum_insert($node) {
Dries's avatar
 
Dries committed
236
  db_query('INSERT INTO {forum} (nid, shadow, tid) VALUES (%d, %d, %d)', $node->nid, $node->shadow, $node->tid);
Dries's avatar
 
Dries committed
237 238 239
}

function forum_update($node) {
Dries's avatar
 
Dries committed
240
  db_query('UPDATE {forum} SET shadow = %d, tid = %d WHERE nid = %d', $node->shadow, $node->tid, $node->nid);
Dries's avatar
 
Dries committed
241 242 243
}

function forum_delete(&$node) {
Dries's avatar
 
Dries committed
244
  db_query('DELETE FROM {forum} WHERE nid = %d', $node->nid);
Dries's avatar
 
Dries committed
245
}
Dries's avatar
 
Dries committed
246

Dries's avatar
 
Dries committed
247
function _forum_num_comments($nid) {
Dries's avatar
 
Dries committed
248
  $value = db_fetch_object(db_query('SELECT COUNT(cid) AS count FROM {comments} WHERE nid = %d AND status = 0', $nid));
Dries's avatar
 
Dries committed
249 250 251
  return ($value) ? $value->count : 0;
}

Dries's avatar
 
Dries committed
252
function _forum_last_comment($nid) {
Dries's avatar
 
Dries committed
253 254
  $value = db_fetch_object(db_query_range('SELECT timestamp FROM {comments} WHERE nid = %d AND status = 0 ORDER BY timestamp DESC', $nid, 0, 1));
  return ($value) ? format_date($value->timestamp, 'small') : '&nbsp;';
Dries's avatar
 
Dries committed
255 256
}

Dries's avatar
 
Dries committed
257
function _forum_last_reply($nid) {
Dries's avatar
 
Dries committed
258
  $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's avatar
 
Dries committed
259 260 261 262 263
  return $value;
}

function _forum_format($topic) {
  if ($topic) {
Dries's avatar
 
Dries committed
264
    return t('%time ago<br />by %author', array('%time' => format_interval(time() - $topic->timestamp), '%author' => format_name($topic)));
Dries's avatar
 
Dries committed
265 266 267 268 269 270 271 272 273 274 275 276 277
  }
  else {
    return message_na();
  }
}

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

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

Dries's avatar
 
Dries committed
278
  $cache = cache_get("forum:$tid");
Dries's avatar
 
Dries committed
279

Dries's avatar
 
Dries committed
280
  if (empty($cache)) {
281
    $forums = array();
Dries's avatar
 
Dries committed
282
    $_forums = taxonomy_get_tree(variable_get('forum_nav_vocabulary', ''), $tid);
Dries's avatar
 
Dries committed
283 284
    $n = 0;
    foreach ($_forums as $forum) {
Dries's avatar
 
Dries committed
285
      if (in_array($forum->tid, variable_get('forum_containers', array()))) {
Dries's avatar
 
Dries committed
286 287
        $forum->container = 1;
      }
Dries's avatar
 
Dries committed
288 289 290
      $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's avatar
 
Dries committed
291 292 293 294
      $forums[$forum->tid] = $forum;
      $n++;
    }

Dries's avatar
 
Dries committed
295
    cache_set("forum:$tid", serialize($forums), 1);
Dries's avatar
 
Dries committed
296
  }
Dries's avatar
 
Dries committed
297 298 299
  else {
    $forums = unserialize($cache->data);
  }
Dries's avatar
 
Dries committed
300

Dries's avatar
 
Dries committed
301 302 303 304
  return $forums;
}

function _forum_num_topics($term) {
Dries's avatar
 
Dries committed
305
  return db_result(db_query('SELECT COUNT(*) FROM {forum} f INNER JOIN {node} n ON n.nid = f.nid WHERE f.tid = %d AND n.status = 1 AND f.shadow = 0', $term));
Dries's avatar
 
Dries committed
306 307 308
}

function _forum_num_replies($term) {
309
  return db_result(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's avatar
 
Dries committed
310 311
}

312 313 314 315
function _forum_topics_read($term, $uid) {
  // Calculate the number of topics the user has read. Assume all entries older
  // than NODE_NEW_LIMIT are read, and include the recent posts that user has
  // read.
Dries's avatar
 
Dries committed
316 317
  $ancient = db_result(db_query('SELECT COUNT(*) FROM {forum} f INNER JOIN {node} n ON f.nid = n.nid WHERE f.tid = %d AND n.status = 1 AND n.created <= %d AND f.shadow = 0', $term, NODE_NEW_LIMIT));
  $recent = db_result(db_query('SELECT COUNT(*) FROM {forum} f INNER JOIN {node} n ON f.nid = n.nid INNER JOIN {history} h ON n.nid = h.nid WHERE n.status = 1 AND f.tid = %d AND h.uid = %d AND n.created > %d AND f.shadow = 0', $term, $uid, NODE_NEW_LIMIT));
Dries's avatar
 
Dries committed
318

319
  return $ancient + $recent;
Dries's avatar
 
Dries committed
320 321 322
}

function _forum_last_post($term) {
Dries's avatar
 
Dries committed
323
  $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's avatar
 
Dries committed
324

Dries's avatar
 
Dries committed
325
  $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's avatar
 
Dries committed
326 327 328 329 330 331

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

  return $value;
}

Dries's avatar
Dries committed
332
function forum_get_topics($tid, $sortby, $forum_per_page) {
Dries's avatar
 
Dries committed
333
  global $user, $forum_topic_list_header;
Dries's avatar
 
Dries committed
334

Dries's avatar
 
Dries committed
335
  $forum_topic_list_header = array(
Dries's avatar
 
Dries committed
336 337 338 339 340
    array('data' => '&nbsp;'),
    array('data' => t('Topic'), 'field' => 'n.title'),
    array('data' => t('Replies'), 'field' => 'num_comments'),
    array('data' => t('Created'), 'field' => 'n.created'),
    array('data' => t('Last reply'), 'field' => 'date_sort', 'sort' => 'desc'),
Dries's avatar
 
Dries committed
341
  );
Dries's avatar
 
Dries committed
342 343

  $sql_sortby = _forum_get_topic_order($sortby);
Dries's avatar
 
Dries committed
344
  for ($i = 0; $i < count($forum_topic_list_header); $i++) {
Dries's avatar
 
Dries committed
345 346
    if ($forum_topic_list_header[$i]['field'] == $sql_sortby) {
      $forum_topic_list_header[$i]['order'] = $sql_sortby;
Dries's avatar
 
Dries committed
347 348 349 350 351
    }
  }

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

Dries's avatar
Dries committed
354
  // show topics with the correct tid, or in the forum but with shadow = 1
Dries's avatar
 
Dries committed
355 356
  // @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's avatar
Dries committed
357
  $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's avatar
 
Dries committed
358
  $sql .= tablesort_sql($forum_topic_list_header);
Dries's avatar
Dries committed
359

Dries's avatar
Dries committed
360
  $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's avatar
 
Dries committed
361

Dries's avatar
Dries committed
362
  $result = pager_query($sql, $forum_per_page, 0, $sql_count);
Dries's avatar
 
Dries committed
363 364 365 366
  $topic_num = db_num_rows($result);

  $n = 0;
  while ($topic = db_fetch_object($result)) {
Dries's avatar
Dries committed
367 368 369 370 371
    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's avatar
 
Dries committed
372 373
      }
      else {
Dries's avatar
 
Dries committed
374
        $topic->new_replies = db_result(db_query('SELECT COUNT(c.nid) FROM {node} n INNER JOIN {comments} c ON n.nid = c.nid WHERE n.nid = %d AND n.status = 1 AND c.status = 0 AND c.timestamp > %d', $topic->nid, $history));
375
        $topic->new = $topic->new_replies || ($topic->timestamp > $history);
Dries's avatar
 
Dries committed
376
      }
377 378
    }
    else {
Dries's avatar
Dries committed
379 380 381
      // you're not logged in eh?
      $topic->new_replies = 0;
      $topic->new = 0;
382
    }
Dries's avatar
 
Dries committed
383 384 385 386 387

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

Dries's avatar
Dries committed
388
  return $topics;
Dries's avatar
 
Dries committed
389 390
}

Dries's avatar
Dries committed
391
function _forum_new($tid) {
Dries's avatar
 
Dries committed
392
  global $user;
Dries's avatar
 
Dries committed
393
  $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's avatar
 
Dries committed
394 395 396 397
  while ($r = db_fetch_object($result)) {
    $read[] = $r->nid;
  }

Dries's avatar
 
Dries committed
398
  $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's avatar
 
Dries committed
399 400 401 402

  return $nid ? $nid : 0;
}

Dries's avatar
 
Dries committed
403
function forum_page() {
Dries's avatar
 
Dries committed
404
  global $sortby, $forum_per_page, $from, $user;
Dries's avatar
 
Dries committed
405

Dries's avatar
 
Dries committed
406
  $op = $_POST['op'];
Dries's avatar
 
Dries committed
407

Dries's avatar
 
Dries committed
408 409
  if (module_exist('taxonomy')) {
    $tid = arg(1);
Dries's avatar
 
Dries committed
410

Dries's avatar
 
Dries committed
411 412 413
    if (arg(2) == 'new') {
      if ($nid = _forum_new($tid)) {
        drupal_goto("node/view/$nid");
Dries's avatar
 
Dries committed
414
      }
Dries's avatar
 
Dries committed
415
    }
Dries's avatar
 
Dries committed
416 417 418 419
    else {
      if (empty($sortby)) {
        $sortby = isset($user->sortby) ? $user->sortby : variable_get('forum_order', 1);
      }
Dries's avatar
 
Dries committed
420

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

Dries's avatar
 
Dries committed
425
      $offset = ($from / $forum_per_page) + 1;
Dries's avatar
 
Dries committed
426

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

Dries's avatar
 
Dries committed
433
      print theme('forum_display', $forums, $topics, $parents, $tid, $sortby, $forum_per_page, $offset);
Dries's avatar
 
Dries committed
434
    }
Dries's avatar
 
Dries committed
435 436
  }
  else {
Dries's avatar
 
Dries committed
437
    print theme('page', forum_help('admin/system/modules/forum'), t('Warning'));
Dries's avatar
 
Dries committed
438 439 440
  }
}

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

/**
Dries's avatar
 
Dries committed
447 448 449 450 451 452 453 454 455 456 457 458
 * 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's avatar
 
Dries committed
459
function theme_forum_display($forums, $topics, $parents, $tid, $sortby, $forum_per_page, $offset) {
Dries's avatar
 
Dries committed
460
  global $user;
Dries's avatar
 
Dries committed
461
  // forum list, topics list, topic browser and 'add new topic' link
Dries's avatar
 
Dries committed
462

Dries's avatar
 
Dries committed
463 464
  $vocabulary = taxonomy_get_vocabulary(variable_get('forum_nav_vocabulary', ''));
  $title = $vocabulary->name;
Dries's avatar
 
Dries committed
465

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

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

Dries's avatar
 
Dries committed
486 487
  if (count($forums) || count($parents)) {
    $output  = "<div id=\"forum\">";
Dries's avatar
 
Dries committed
488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508
    $output .= "<ul>";

    if (module_exist('tracker')) {
      if ($user->uid) {
        $output .= " <li>". l(t('Track your forum discussions.'), "tracker/$user->uid") ."</li>";
      }

      $output .= " <li>". l(t('Track active forum discussions.'), 'tracker') ."</li>";
    }

    if (user_access('create forum topics')) {
      $output .= "<li>". l(t('Post new forum topic.'), "node/add/forum/$tid") ."</li>";
    }
    else if ($user->uid) {
      $output .= "<li>". t('You are not allowed to post a new forum topic.') .'</li>';
    }
    else {
      $output .= '<li>'. t('<a href="%login">Login</a> to post a new forum topic.', array('%login' => url('user/login'))) .'</li>';
    }
    $output .= "</ul>";

Dries's avatar
 
Dries committed
509
    $output .= theme('forum_list', $forums, $parents, $tid);
Dries's avatar
 
Dries committed
510

Dries's avatar
 
Dries committed
511 512
    if ($tid && !in_array($tid, variable_get('forum_containers', array()))) {
      $output .= theme('forum_topic_list', $tid, $topics, $sortby, $forum_per_page, $offset);
Dries's avatar
 
Dries committed
513 514 515 516
    }
    $output .= "</div>";
  }
  else {
Dries's avatar
 
Dries committed
517
    $title = t('No forums defined');
Dries's avatar
 
Dries committed
518
    $output = '';
Dries's avatar
 
Dries committed
519 520
  }

Dries's avatar
 
Dries committed
521
  print theme('page', $output, $title, $breadcrumb);
Dries's avatar
 
Dries committed
522 523
}

Dries's avatar
 
Dries committed
524
/**
Dries's avatar
 
Dries committed
525 526 527 528 529 530 531 532
 * Format the forum listing.
 *
 * @param forums
 * @param parents
 * @param tid
 *
 * @return output for the forum listing.
 */
Dries's avatar
 
Dries committed
533
function theme_forum_list($forums, $parents, $tid) {
Dries's avatar
 
Dries committed
534 535
  global $user;

Dries's avatar
 
Dries committed
536 537
  if ($forums) {

Dries's avatar
 
Dries committed
538
    $header = array(t('Forum'), t('Topics'), t('Posts'), t('Last post'));
Dries's avatar
 
Dries committed
539 540

    foreach ($forums as $forum) {
Dries's avatar
 
Dries committed
541
      if ($forum->container) {
Dries's avatar
 
Dries committed
542 543 544 545 546 547 548 549
        $description  = "<div 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";
        }
        $description .= "</div>\n";

Dries's avatar
 
Dries committed
550
        $rows[] = array(array('data' => $description, 'class' => 'container', 'colspan' => 4));
551
      }
Dries's avatar
 
Dries committed
552
      else {
553
        $forum->old_topics = _forum_topics_read($forum->tid, $user->uid);
Dries's avatar
 
Dries committed
554 555 556
        if ($user->uid) {
          $new_topics = $forum->num_topics - $forum->old_topics;
        }
Dries's avatar
 
Dries committed
557 558 559
        else {
          $new_topics = 0;
        }
Dries's avatar
 
Dries committed
560

Dries's avatar
 
Dries committed
561
        $links = array();
Dries's avatar
 
Dries committed
562

Dries's avatar
 
Dries committed
563 564
        $description  = "<div style=\"margin-left: ". ($forum->depth * 30) ."px;\">\n";
        $description .= " <div class=\"name\">". l($forum->name, "forum/$forum->tid") ."</div>\n";
Dries's avatar
 
Dries committed
565

Dries's avatar
 
Dries committed
566 567 568 569
        if ($forum->description) {
          $description .= " <div class=\"description\">$forum->description</div>\n";
        }
        if ($links) {
Dries's avatar
 
Dries committed
570
          $description .= " <div class=\"links\">". t('Jump to: %links', array('%links' => implode(', ', $links))) .".</div>\n";
Dries's avatar
 
Dries committed
571 572
        }
        $description .= "</div>\n";
Dries's avatar
 
Dries committed
573

Dries's avatar
 
Dries committed
574
        $rows[] = array(
Dries's avatar
 
Dries committed
575
          array('data' => $description, 'class' => 'forum'),
Dries's avatar
 
Dries committed
576
          array('data' => $forum->num_topics . ($new_topics ? "<br />". l(t('%a new', array('%a' => $new_topics)), "forum/$forum->tid", NULL, NULL, 'new') : ''), 'class' => 'topics'),
Dries's avatar
 
Dries committed
577 578
          array('data' => $forum->num_posts, 'class' => 'posts'),
          array('data' => _forum_format($forum->last_post), 'class' => 'last-reply'));
Dries's avatar
 
Dries committed
579
      }
Dries's avatar
 
Dries committed
580 581 582
    }
  }

Dries's avatar
 
Dries committed
583
  return theme('table', $header, $rows);
Dries's avatar
 
Dries committed
584 585
}

Dries's avatar
 
Dries committed
586
/**
Dries's avatar
 
Dries committed
587 588 589 590 591 592 593 594 595 596
 * Format the topic listing.
 *
 * @param tid
 * @param topics
 * @param sortby
 * @param forum_per_page
 * @param offset
 *
 * @return output for the topic list.
 */
Dries's avatar
 
Dries committed
597
function theme_forum_topic_list($tid, $topics, $sortby, $forum_per_page, $offset) {
Dries's avatar
 
Dries committed
598
  global $id, $status, $pager_total, $forum_topic_list_header;
Dries's avatar
 
Dries committed
599 600

  if ($topics) {
Dries's avatar
 
Dries committed
601

Dries's avatar
 
Dries committed
602 603
    foreach ($topics as $topic) {
      // folder is new if topic is new or there are new comments since last visit
Dries's avatar
Dries committed
604
      if ($topic->tid != $tid) {
Dries's avatar
 
Dries committed
605
        $rows[] = array(
Dries's avatar
 
Dries committed
606 607 608
          array('data' => _forum_icon($topic->new, $topic->num_comments, $topic->comment_mode), 'class' => 'icon'),
          array('data' => $topic->title, 'class' => 'title'),
          array('data' => l(t('This topic has been moved'), "forum/$topic->tid"), 'colspan' => '3')
Dries's avatar
 
Dries committed
609
        );
Dries's avatar
 
Dries committed
610 611
      }
      else {
Dries's avatar
 
Dries committed
612
        $rows[] = array(
Dries's avatar
 
Dries committed
613 614
          array('data' => _forum_icon($topic->new, $topic->num_comments, $topic->comment_mode), 'class' => 'icon'),
          array('data' => l($topic->title, "node/view/$topic->nid"), 'class' => 'topic'),
Dries's avatar
 
Dries committed
615
          array('data' => $topic->num_comments . ($topic->new_replies ? "<br />". l(t('%a new', array('%a' => $topic->new_replies)), "node/view/$topic->nid", NULL, NULL, 'new') : ''), 'class' => 'replies'),
Dries's avatar
 
Dries committed
616 617
          array('data' => _forum_format($topic), 'class' => 'created'),
          array('data' => _forum_format($topic->last_reply), 'class' => 'last-reply')
Dries's avatar
 
Dries committed
618
        );
Dries's avatar
 
Dries committed
619 620 621
      }
    }

Dries's avatar
 
Dries committed
622 623
    if ($pager = theme('pager', NULL, $forum_per_page, 0, tablesort_pager())) {
      $rows[] = array(array('data' => $pager, 'colspan' => '5', 'class' => 'pager'));
Dries's avatar
 
Dries committed
624 625
    }
  }
Dries's avatar
 
Dries committed
626

Dries's avatar
 
Dries committed
627
  $output .= theme('table', $forum_topic_list_header, $rows);
Dries's avatar
 
Dries committed
628

Dries's avatar
 
Dries committed
629 630 631
  return $output;
}

Dries's avatar
 
Dries committed
632
/** @} End of addtogroup themeable */
Dries's avatar
 
Dries committed
633

Dries's avatar
 
Dries committed
634
function _forum_icon($new_posts, $num_posts = 0, $comment_mode = 0) {
Dries's avatar
 
Dries committed
635

Dries's avatar
 
Dries committed
636
  $base_path = variable_get('forum_icon_path', '');
Dries's avatar
 
Dries committed
637
  if ($base_path) {
Dries's avatar
 
Dries committed
638 639
    if ($num_posts > variable_get('forum_hot_topic', 15)) {
      $icon = $new_posts ? 'hot-new' : 'hot';
Dries's avatar
 
Dries committed
640 641
    }
    else {
Dries's avatar
 
Dries committed
642
      $icon = $new_posts ? 'new' : 'default';
Dries's avatar
 
Dries committed
643 644 645
    }

    if ($comment_mode == 1) {
Dries's avatar
 
Dries committed
646
      $icon = 'closed';
Dries's avatar
 
Dries committed
647 648
    }

Dries's avatar
 
Dries committed
649
    // default
Dries's avatar
 
Dries committed
650
    $file = $base_path ."/forum-$icon.gif";
Dries's avatar
 
Dries committed
651

Dries's avatar
 
Dries committed
652
    $output = "<img src=\"$file\" alt=\"\" title=\"\" />";
Dries's avatar
 
Dries committed
653 654
  }
  else {
Dries's avatar
 
Dries committed
655
    $output = '&nbsp;';
Dries's avatar
 
Dries committed
656
  }
Dries's avatar
 
Dries committed
657 658 659 660 661 662

  if ($new_posts) {
    $output = "<a name=\"new\">$output</a>";
  }

  return $output;
Dries's avatar
 
Dries committed
663 664 665 666
}

function _forum_user_last_visit($nid) {
  global $user;
667 668 669
  static $history = array();

  if (empty($history)) {
Dries's avatar
 
Dries committed
670
    $result = db_query('SELECT nid, timestamp FROM {history} WHERE uid = %d', $user->uid);
Dries's avatar
 
Dries committed
671
    while ($t = db_fetch_object($result)) {
672
      $history[$t->nid] = $t->timestamp > NODE_NEW_LIMIT ? $t->timestamp : NODE_NEW_LIMIT;
Dries's avatar
 
Dries committed
673 674
    }
  }
675
  return $history[$nid] ? $history[$nid] : NODE_NEW_LIMIT;
Dries's avatar
 
Dries committed
676 677 678 679 680
}

function _forum_get_topic_order($sortby) {
  switch ($sortby) {
    case 1:
Dries's avatar
 
Dries committed
681
      return 'date_sort DESC';
Dries's avatar
 
Dries committed
682 683
      break;
    case 2:
Dries's avatar
 
Dries committed
684
      return 'date_sort ASC';
Dries's avatar
 
Dries committed
685 686
      break;
    case 3:
Dries's avatar
 
Dries committed
687
      return 'num_comments DESC';
Dries's avatar
 
Dries committed
688 689
      break;
    case 4:
Dries's avatar
 
Dries committed
690
      return 'num_comments ASC';
Dries's avatar
 
Dries committed
691 692 693 694
      break;
  }
}

Dries's avatar
 
Dries committed
695
?>