function hook_block_view
hook_block_view($delta = '')
Return a rendered or renderable view of a block.
Parameters
$delta: Which block to render. This is a unique identifier for the block within the module, defined in hook_block_info().
Return value
Either an empty array so the block will not be shown or an array containing the following elements:
- subject: The default localized title of the block. If the block does not have a default title, this should be set to NULL.
- content: The content of the block's body. This may be a renderable array (preferable) or a string containing rendered HTML content. If the content is empty the block will not be shown.
For a detailed usage example, see block_example.module.
See also
hook_block_view_MODULE_DELTA_alter()
Related topics
File
- modules/block/block.api.php, line 217
- Hooks provided by the Block module.
Code
function hook_block_view($delta = '') { // This example is adapted from node.module. $block = array(); switch ($delta) { case 'syndicate': $block['subject'] = t('Syndicate'); $block['content'] = array( '#theme' => 'feed_icon', '#url' => 'rss.xml', '#title' => t('Syndicate'), ); break; case 'recent': if (user_access('access content')) { $block['subject'] = t('Recent content'); if ($nodes = node_get_recent(variable_get('node_recent_block_count', 10))) { $block['content'] = array( '#theme' => 'node_recent_block', '#nodes' => $nodes, ); } else { $block['content'] = t('No content available.'); } } break; } return $block; }
© 2001–2016 by the original authors
Licensed under the GNU General Public License, version 2 and later.
Drupal is a registered trademark of Dries Buytaert.
https://api.drupal.org/api/drupal/modules!block!block.api.php/function/hook_block_view/7.x