Same name and namespace in other branches
  1. 4.6.x modules/forum.module \forum_get_forums()
  2. 4.7.x modules/forum.module \forum_get_forums()
  3. 5.x modules/forum/forum.module \forum_get_forums()

Returns a list of all forums for a given taxonomy id

Forum objects contain the following fields -num_topics Number of topics in the forum -num_posts Total number of posts in all topics -last_post Most recent post for the forum

Parameters

$tid: Taxonomy ID of the vocabulary that holds the forum list.

Return value

Array of object containing the forum information.

1 call to forum_get_forums()
forum_page in modules/forum/forum.pages.inc
Menu callback; prints a forum listing.

File

modules/forum/forum.module, line 490
Enable threaded discussions about general topics.

Code

function forum_get_forums($tid = 0) {
  $forums = array();
  $vid = variable_get('forum_nav_vocabulary', '');
  $_forums = taxonomy_get_tree($vid, $tid);
  if (count($_forums)) {
    $counts = array();
    $sql = "\n      SELECT r.tid AS tid, n.nid AS nid, l.comment_count AS nid_comment_count\n        FROM {node} n\n        INNER JOIN {node_comment_statistics} l ON n.nid = l.nid\n        INNER JOIN {term_node} r ON n.vid = r.vid\n        WHERE n.status = 1\n        GROUP BY r.tid, n.nid, l.comment_count";
    $sql_rewritten = db_rewrite_sql($sql);
    if ($sql_rewritten == $sql) {
      $sql = "\n        SELECT r.tid, COUNT(n.nid) AS topic_count, SUM(l.comment_count) AS comment_count\n          FROM {node} n\n          INNER JOIN {node_comment_statistics} l ON n.nid = l.nid\n          INNER JOIN {term_node} r ON n.vid = r.vid\n          WHERE n.status = 1\n          GROUP BY r.tid";
      $sql = db_rewrite_sql($sql);
    }
    else {
      $sql = "\n        SELECT tid, COUNT(nid) AS topic_count, SUM(nid_comment_count) AS comment_count\n          FROM ({$sql_rewritten}) AS forum_content_list\n          GROUP BY tid";
    }
    $_counts = db_query($sql);
    while ($count = db_fetch_object($_counts)) {
      $counts[$count->tid] = $count;
    }
  }
  foreach ($_forums as $forum) {
    if (in_array($forum->tid, variable_get('forum_containers', array()))) {
      $forum->container = 1;
    }
    if (!empty($counts[$forum->tid])) {
      $forum->num_topics = $counts[$forum->tid]->topic_count;
      $forum->num_posts = $counts[$forum->tid]->topic_count + $counts[$forum->tid]->comment_count;
    }
    else {
      $forum->num_topics = 0;
      $forum->num_posts = 0;
    }

    // This query does not use full ANSI syntax since MySQL 3.x does not support
    // table1 INNER JOIN table2 INNER JOIN table3 ON table2_criteria ON table3_criteria
    // used to join node_comment_statistics to users.
    $sql = "SELECT ncs.last_comment_timestamp, IF (ncs.last_comment_uid != 0, u2.name, ncs.last_comment_name) AS last_comment_name, ncs.last_comment_uid FROM {node} n INNER JOIN {users} u1 ON n.uid = u1.uid INNER JOIN {term_node} tn ON n.vid = tn.vid INNER JOIN {node_comment_statistics} ncs ON n.nid = ncs.nid INNER JOIN {users} u2 ON ncs.last_comment_uid=u2.uid WHERE n.status = 1 AND tn.tid = %d ORDER BY ncs.last_comment_timestamp DESC";
    $sql = db_rewrite_sql($sql);
    $topic = db_fetch_object(db_query_range($sql, $forum->tid, 0, 1));
    $last_post = new stdClass();
    if (!empty($topic->last_comment_timestamp)) {
      $last_post->timestamp = $topic->last_comment_timestamp;
      $last_post->name = $topic->last_comment_name;
      $last_post->uid = $topic->last_comment_uid;
    }
    $forum->last_post = $last_post;
    $forums[$forum->tid] = $forum;
  }
  return $forums;
}