Feature: #87616 - PSR-14 event for modifying Page Link Generation¶

Description¶

A new PSR-14 event TYPO3\CMS\Frontend\Event\ModifyPageLinkConfigurationEvent has been introduced which serves as a more powerful and flexible alternative for the now removed hook $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['typolinkProcessing']['typolinkModifyParameterForPageLinks'].

The event is called after a page has already been resolved, and includes much more arguments such as the generated fragment or the to-be-used query parameters.

The page to be linked to can also be modified, for example to link to a different page.

Example¶

Registration of the event in your extension's Services.yaml:

MyVendor\MyPackage\Frontend\MyEventListener:
  tags:
    - name: event.listener
      identifier: 'my-package/frontend/modify-page-link-configuration'

The corresponding event listener class:

use TYPO3\CMS\Frontend\Event\ModifyPageLinkConfigurationEvent;

class MyEventListener {

    public function __invoke(ModifyPageLinkConfigurationEvent $event): void
    {
        // Do your magic here
    }
}

Impact¶

The main advantage of the PSR-14 event is that it is fired after TYPO3 has already prepared some functionality within the PageLinkBuilder, allowing to modify more properties, if needed.