forum-list.tpl.php
Displays a list of forums and containers.
Available variables:
- $forums: An array of forums and containers to display. It is keyed to the
numeric IDs of all child forums and containers. Each $forum in $forums
contains:
- $forum->is_container: TRUE if the forum can contain other forums. 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->icon_class: 'default' or 'new' string used for forum icon class.
- $forum->icon_title: Text alternative for the forum icon.
- $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.
- $forum_id: Forum ID for the current forum. Parent to all items within the $forums array.
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 - Preprocesses variables for forums.tpl.php.
File
-
modules/
forum/ forum-list.tpl.php
View source
<?php
/**
* @file
* Displays a list of forums and containers.
*
* Available variables:
* - $forums: An array of forums and containers to display. It is keyed to the
* numeric IDs of all child forums and containers. Each $forum in $forums
* contains:
* - $forum->is_container: TRUE if the forum can contain other forums. 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->icon_class: 'default' or 'new' string used for forum icon class.
* - $forum->icon_title: Text alternative for the forum icon.
* - $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.
* - $forum_id: Forum ID for the current forum. Parent to all items within the
* $forums array.
*
* @see template_preprocess_forum_list()
* @see theme_forum_list()
*
* @ingroup themeable
*/
?>
<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="icon forum-status-<?php
print $forum->icon_class;
?>" title="<?php
print $forum->icon_title;
?>">
<span class="element-invisible"><?php
print $forum->icon_title;
?></span>
</div>
<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>
Related topics
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.