function hook_block_alter

Same name and namespace in other branches
  1. 9 core/modules/block/block.api.php \hook_block_alter()
  2. 10 core/modules/block/block.api.php \hook_block_alter()

Allow modules to alter the block plugin definitions.

Parameters

array[] $definitions: The array of block definitions, keyed by plugin ID.

Related topics

Block API
Information about the classes and interfaces that make up the Block API.
Hooks
Define functions that alter the behavior of Drupal core.
11 functions implement hook_block_alter()

Note: the procedural functions in this list are found by pattern matching, so the list may include some functions that are not actually implementations of this hook.

BlockTestHooks::blockAlter in core/modules/block/tests/modules/block_test/src/Hook/BlockTestHooks.php
Implements hook_block_alter().
block_test_block_alter in core/modules/block/tests/modules/block_test/block_test.module
Implements hook_block_alter().
LayoutBuilderFormBlockTestHooks::blockAlter in core/modules/layout_builder/tests/modules/layout_builder_form_block_test/src/Hook/LayoutBuilderFormBlockTestHooks.php
Implements hook_block_alter().
NavigationHooks::blockAlter in core/modules/navigation/src/Hook/NavigationHooks.php
Implements hook_block_alter().
NavigationTestBlockHooks::blockAlter in core/modules/navigation/tests/navigation_test_block/src/Hook/NavigationTestBlockHooks.php
Implements hook_block_alter().

... See full list

File

core/modules/block/block.api.php, line 255

Code

function hook_block_alter(&$definitions) {
  foreach ($definitions as $id => $definition) {
    if (str_starts_with($id, 'system_menu_block:')) {
      // Replace $definition properties: id, deriver, class, provider to ones
      // provided by this custom module.
    }
  }
}

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