Same filename and directory in other branches
  1. 7.x modules/forum/forum-list.tpl.php

forum-list.tpl.php Default theme implementation to display a list of forums and containers.

Available variables:

  • $forums: An array of forums and containers to display. It is keyed to the numeric id's of all child forums and containers.
  • $forum_id: Forum id for the current forum. Parent to all items within the $forums array.

Each $forum in $forums contains:

  • $forum->is_container: Is TRUE if the forum can contain other forums. Is FALSE if the forum can contain only topics.
  • $forum->depth: How deep the forum is in the current hierarchy.
  • $forum->zebra: 'even' or 'odd' string used for row class.
  • $forum->name: The name of the forum.
  • $forum->link: The URL to link to this forum.
  • $forum->description: The description of this forum.
  • $forum->new_topics: True if the forum contains unread posts.
  • $forum->new_url: A URL to the forum's unread posts.
  • $forum->new_text: Text for the above URL which tells how many new posts.
  • $forum->old_topics: A count of posts that have already been read.
  • $forum->num_posts: The total number of posts in the forum.
  • $forum->last_reply: Text representing the last time a forum was posted or commented in.

See also

template_preprocess_forum_list()

theme_forum_list()

1 theme call to forum-list.tpl.php
template_preprocess_forums in modules/forum/forum.module
Process variables for forums.tpl.php

File

modules/forum/forum-list.tpl.php
View source
<?php

/**
 * @file forum-list.tpl.php
 * Default theme implementation to display a list of forums and containers.
 *
 * Available variables:
 * - $forums: An array of forums and containers to display. It is keyed to the
 *   numeric id's of all child forums and containers.
 * - $forum_id: Forum id for the current forum. Parent to all items within
 *   the $forums array.
 *
 * Each $forum in $forums contains:
 * - $forum->is_container: Is TRUE if the forum can contain other forums. Is
 *   FALSE if the forum can contain only topics.
 * - $forum->depth: How deep the forum is in the current hierarchy.
 * - $forum->zebra: 'even' or 'odd' string used for row class.
 * - $forum->name: The name of the forum.
 * - $forum->link: The URL to link to this forum.
 * - $forum->description: The description of this forum.
 * - $forum->new_topics: True if the forum contains unread posts.
 * - $forum->new_url: A URL to the forum's unread posts.
 * - $forum->new_text: Text for the above URL which tells how many new posts.
 * - $forum->old_topics: A count of posts that have already been read.
 * - $forum->num_posts: The total number of posts in the forum.
 * - $forum->last_reply: Text representing the last time a forum was posted or
 *   commented in.
 *
 * @see template_preprocess_forum_list()
 * @see theme_forum_list()
 */
?>
<table id="forum-<?php

print $forum_id;
?>">
  <thead>
    <tr>
      <th><?php

print t('Forum');
?></th>
      <th><?php

print t('Topics');
?></th>
      <th><?php

print t('Posts');
?></th>
      <th><?php

print t('Last post');
?></th>
    </tr>
  </thead>
  <tbody>
  <?php

foreach ($forums as $child_id => $forum) {
  ?>
    <tr id="forum-list-<?php

  print $child_id;
  ?>" class="<?php

  print $forum->zebra;
  ?>">
      <td <?php

  print $forum->is_container ? 'colspan="4" class="container"' : 'class="forum"';
  ?>>
        <?php


  /* Enclose the contents of this cell with X divs, where X is the
   * depth this forum resides at. This will allow us to use CSS
   * left-margin for indenting.
   */
  ?>
        <?php

  print str_repeat('<div class="indent">', $forum->depth);
  ?>
          <div class="name"><a href="<?php

  print $forum->link;
  ?>"><?php

  print $forum->name;
  ?></a></div>
          <?php

  if ($forum->description) {
    ?>
            <div class="description"><?php

    print $forum->description;
    ?></div>
          <?php

  }
  ?>
        <?php

  print str_repeat('</div>', $forum->depth);
  ?>
      </td>
      <?php

  if (!$forum->is_container) {
    ?>
        <td class="topics">
          <?php

    print $forum->num_topics;
    ?>
          <?php

    if ($forum->new_topics) {
      ?>
            <br />
            <a href="<?php

      print $forum->new_url;
      ?>"><?php

      print $forum->new_text;
      ?></a>
          <?php

    }
    ?>
        </td>
        <td class="posts"><?php

    print $forum->num_posts;
    ?></td>
        <td class="last-reply"><?php

    print $forum->last_reply;
    ?></td>
      <?php

  }
  ?>
    </tr>
  <?php

}
?>
  </tbody>
</table>