1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
|
<?php
/**
* @file
* Hooks related to the Navigation module.
*/
/**
* @addtogroup hooks
* @{
*/
/**
* Provide content for Navigation content_top section.
*
* @return array
* An associative array of renderable elements.
*
* @see hook_navigation_content_top_alter()
*/
function hook_navigation_content_top(): array {
return [
'navigation_foo' => [
'#markup' => \Drupal::config('system.site')->get('name'),
'#cache' => [
'tags' => ['config:system.site'],
],
],
'navigation_bar' => [
'#markup' => 'bar',
],
'navigation_baz' => [
'#markup' => 'baz',
],
];
}
/**
* Alter replacement values for placeholder tokens.
*
* @param array $content_top
* An associative array of content returned by hook_navigation_content_top().
*
* @see hook_navigation_content_top()
*/
function hook_navigation_content_top_alter(array &$content_top): void {
// Remove a specific element.
unset($content_top['navigation_foo']);
// Modify an element.
$content_top['navigation_bar']['#markup'] = 'new bar';
// Change weight.
$content_top['navigation_baz']['#weight'] = '-100';
}
/**
* Provides default content for the Navigation bar.
*
* @return array
* An associative array of navigation block definitions.
* The following elements should be part of each definition array:
* - delta: The expected delta where the block should be placed in the
* Navigation bar. Defaults to 0.
* - configuration: The key-value array with the Navigation Block definition.
* It should include the following elements, besides the Navigation block
* specific settings:
* - id: The Navigation Block plugin ID.
* - label: The block label.
* -label_display: 0 or 1 depending on whether the label should be
* displayed or not.
* - provider: The module that provides the block. In general, the module
* that defines the Navigation block.
*/
function hook_navigation_defaults(): array {
$blocks = [];
$blocks[] = [
'delta' => 1,
'configuration' => [
'id' => 'navigation_test',
'label' => 'My test block',
'label_display' => 1,
'provider' => 'navigation_test_block',
'test_block_setting_foo' => 'Foo',
'test_block_setting_bar' => 1,
],
];
return $blocks;
}
/**
* Alter the content of a given Navigation menu link tree.
*
* @param array &$tree
* The Navigation link tree.
*
* @see \Drupal\navigation\Menu\NavigationMenuLinkTree::transform()
*/
function hook_navigation_menu_link_tree_alter(array &$tree): void {
foreach ($tree as $key => $item) {
// Skip elements where menu is not the 'admin' one.
$menu_name = $item->link->getMenuName();
if ($menu_name != 'admin') {
continue;
}
// Remove unwanted Help menu link.
$plugin_id = $item->link->getPluginId();
if ($plugin_id == 'help.main') {
unset($tree[$key]);
}
}
}
/**
* @} End of "addtogroup hooks".
*/
|
