The PageLinkHandler¶

The PageLinkHandler enables editors to link to pages and content.

It is implemented in class \TYPO3\CMS\Backend\LinkHandler\PageLinkHandler of the system extension backend. The class is marked as @internal and contains neither hooks nor events.

Changed in version 12.0: Due to the integration of EXT:recordlist into EXT:backend the namespace of LinkHandlers has changed from TYPO3\CMS\Recordlist\LinkHandler to TYPO3\CMS\Backend\LinkHandler. For TYPO3 v12 the moved classes are available as an alias under the old namespace to allow extensions to be compatible with TYPO3 v11 and v12.

The PageLinkHandler is preconfigured in the page TSconfig as:

EXT:some_extension/Configuration/page.tsconfig¶

TCEMAIN.linkHandler {
   page {
      handler = TYPO3\CMS\Backend\LinkHandler\PageLinkHandler
      label = LLL:EXT:backend/Resources/Private/Language/locallang_browse_links.xlf:page
   }
}

Enable direct input of the page id¶

It is possible to enable an additional field in the link browser to enter the uid of a page. The uid will be used directly instead of selecting it from the page tree.

The link browser field for entering a page uid.

Enable the field with the following page TSConfig:

EXT:some_extension/Configuration/page.tsconfig¶

TCEMAIN.linkHandler.page.configuration.pageIdSelector.enabled = 1