function hook_block_view_MODULE_DELTA_alter

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().

Parameters

$data: The data as returned from the hook_block_view() implementation of the module that defined the block. This could be an empty array or NULL value (if the block is empty) or an array containing:

  • 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 unique identifier for the block within that module, as defined in hook_block_info().

See also

hook_block_view_alter()

hook_block_view()

Related topics

3 string references to 'hook_block_view_MODULE_DELTA_alter'
BlockViewModuleDeltaAlterWebTest::testBlockViewModuleDeltaAlter in modules/block/block.test
Tests that the alter hook is called, even if the delta contains a hyphen.
block_test_block_view_block_test_test_hyphen_alter in modules/block/tests/block_test.module
Implements hook_block_view_MODULE_DELTA_alter().
block_test_block_view_block_test_test_underscore_alter in modules/block/tests/block_test.module
Implements hook_block_view_MODULE_DELTA_alter().
2 functions implement hook_block_view_MODULE_DELTA_alter()

Note: this list is generated by pattern matching, so it may include some functions that are not actually implementations of this hook.

block_test_block_view_block_test_test_hyphen_alter in modules/block/tests/block_test.module
Implements hook_block_view_MODULE_DELTA_alter().
block_test_block_view_block_test_test_underscore_alter in modules/block/tests/block_test.module
Implements hook_block_view_MODULE_DELTA_alter().

File

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

Code

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');
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.