Attention
TYPO3 v12 has reached end-of-life as of April 30th 2026 and is no longer being maintained. Use the version switcher on the top left of this page to select documentation for a supported version of TYPO3.
Need more time before upgrading? You can purchase Extended Long Term Support (ELTS) for TYPO3 v12 here: TYPO3 ELTS.
FilterMenuItemsEvent
New in version 12.0
This event has been introduced to serve as a more powerful and flexible
alternative for the removed hook
$GLOBALS.
The PSR-14 event
\TYPO3\ has
a variety of properties and getters, along with
TYPO3\CMS\Frontend\Event\FilterMenuItemsEvent::getFilteredMenuItems()
and
TYPO3\CMS\Frontend\Event\FilterMenuItemsEvent::setFilteredMenuItems().
Those methods can be used to change the items of a menu, which has been generated
with a TypoScript HMENU or
a MenuProcessor.
This event is fired after TYPO3 has filtered all menu items. The menu can then be adjusted by adding, removing or modifying the menu items. Also changing the order is possible.
Additionally, more information about the currently rendered menu, such as the menu items which were filtered out, is available.
Example
Note
Currently, we do not have an example for this event. If you can provide a useful one, please open an issue with your code snippets or a pull request.