hook_block_view_MODULE_DELTA_alter

Versions
7
hook_block_view_MODULE_DELTA_alter(&$data, $block)

Perform alterations to a specific block.

Modules can implement hook_block_view_MODULE_DELTA_alter() to modify a specific block, rather than implementing hook_block_view_alter().

Note that this hook fires before hook_block_view_alter(). Therefore, all implementations of hook_block_view_MODULE_DELTA_alter() will run before all implementations of hook_block_view_alter(), regardless of the module order.

See also

hook_block_view_alter()

@see hook_block_view()

Parameters

$data An array of data, as returned from the hook_block_view() implementation of the module that defined the block:

  • subject: The localized title of the block.
  • content: Either a string or a renderable array representing the content of the block. You should check that the content is an array before trying to modify parts of the renderable structure.

$block The block object, as loaded from the database, having the main properties:

  • module: The name of the module that defined the block.
  • delta: The identifier for the block within that module, as defined within hook_block_info().

Related topics

Code

modules/block/block.api.php, line 216

<?php
function hook_block_view_MODULE_DELTA_alter(&$data, $block) {
  // This code will only run for a specific block. For example, if MODULE_DELTA
  // in the function definition above is set to "mymodule_somedelta", the code
  // will only run on the "somedelta" block provided by the "mymodule" module.

  // Change the title of the "somedelta" block provided by the "mymodule"
  // module.
  $data['subject'] = t('New title of the block');
}
?>
Login or register to post comments
 
 

All source code and documentation on this site is released under the terms of the GNU General Public License, version 2 and later. Drupal is a registered trademark of Dries Buytaert.