node_title_list

Versions
4.6 – 7: node_title_list($result, $title = NULL)

Gather a listing of links to nodes.

Parameters

$result A DB result object from a query to fetch node entities. If your query joins the <code>node_comment_statistics</code> table so that the <code>comment_count</code> field is available, a title attribute will be added to show the number of comments.

$title A heading for the resulting list.

Return value

An HTML list suitable as content for a block, or FALSE if no result can fetch from DB result object.

▸ 3 functions call node_title_list()

▾ 3 functions call node_title_list()

blog_block_view in modules/blog/blog.module: Implement hook_block_view().
forum_block_view_pre_render in modules/forum/forum.module: A #pre_render callback. Lists nodes based on the element's #query property. *
statistics_block_view in modules/statistics/statistics.module: Implement hook_block_view().

Code

modules/node/node.module, line 258

<?php
function node_title_list($result, $title = NULL) {
  $items = array();
  $num_rows = FALSE;
  foreach ($result as $node) {
    $items[] = l($node->title, 'node/' . $node->nid, !empty($node->comment_count) ? array('attributes' => array('title' => format_plural($node->comment_count, '1 comment', '@count comments'))) : array());
    $num_rows = TRUE;
  }

  return $num_rows ? theme('node_list', array('items' => $items, 'title' => $title)) : FALSE;
}
?>