Link handler configuration

Link browser tabs are registered in page TSconfig like this:

TCEMAIN.linkHandler {
    haiku {
        handler = TYPO3\CMS\Recordlist\LinkHandler\RecordLinkHandler
        label = LLL:EXT:examples/Resources/Private/Language/locallang_browse_links.xlf:haiku
        configuration {
            table = tx_examples_haiku
        }
        displayAfter = url
        scanBefore = page
    }
}

See the complete example: Tutorial: Custom record link browser.

Possible options are:

handler

The fully-qualified classname of the link handler.

label

The name displayed on the tab button in the link browser.

displayAfter / displayBefore

Can be used to decide the order of the tabs.

scanAfter / scanBefore

The first backend link handler who determines that it can handle the link may edit a link. Most likely your links will start with a specific prefix to identify them.

You should register your tab at least before the url link handler. The url link handler treats all links, that no other handler can treat.

configuration

Some custom configuration, available to the backend link handler.

Page link handler configuration

configuration.pageIdSelector.enabled

Enable an additional field in the link browser to enter the uid of a page.

Enable the field with the following page TSConfig:

EXT:some_extension/Configuration/page.tsconfig

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

Copied!

or by configuring the link button in your ckeditor configuration

EXT:some_extension/Configuration/RTE/Default.yaml

buttons:
  link:
    pageIdSelector:
      enabled: true

Copied!

Note

Additionally, you have to allow the pageIdSelector as a link option in your RTE configuration, e.g.

EXT:some_extension/Configuration/RTE/Default.yaml

allowedOptions: 'target,title,class,pageIdSelector'

Copied!