function node_title_list
7.x node.module | node_title_list($result, $title = NULL) |
6.x node.module | node_title_list($result, $title = NULL) |
Gathers a listing of links to nodes.
Parameters
$result: A database result object from a query to fetch node entities. If your query joins the {node_comment_statistics} table so that the comment_count field is available, a title attribute will be added to show the number of comments.
$title: A heading for the resulting list.
Return value
A renderable array containing a list of linked node titles fetched from $result, or FALSE if there are no rows in $result.
3 calls to node_title_list()
- blog_block_view in drupal-7.x/
modules/ blog/ blog.module - Implements hook_block_view().
- forum_block_view_pre_render in drupal-7.x/
modules/ forum/ forum.module - Render API callback: Lists nodes based on the element's #query property.
- statistics_block_view in drupal-7.x/
modules/ statistics/ statistics.module - Implements hook_block_view().
File
- drupal-7.x/
modules/ node/ node.module, line 288 - The core that allows content to be submitted to the site. Modules and scripts may programmatically submit nodes using the usual form API pattern.
Code
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 ? array('#theme' => 'item_list__node', '#items' => $items, '#title' => $title) : FALSE;
}