菜单

FEATURE SPOTLIGHT: LINKHANDLER

2018年05月28日 - typo3

PageTSconfig – Make records appear in the link browser

To add a new type of records to the link browser you have to add a few lines of PageTSconfig to the system. Under TCEMAIN.linkHandler you can add new tabs with unique identifiers. By using the TYPO3\CMS\Recordlist\LinkHandler\RecordLinkHandler the link browser knows that the new tab cares about some kind of records. It is possible to add custom LinkHandler since TYPO3 7 LTS (see feature RST). Of course you have to configure the table that stores the records. Other than that you have a few additional options:

TCEMAIN.linkHandler.tx_news {
    handler = TYPO3\CMS\Recordlist\LinkHandler\RecordLinkHandler
    label = News
    configuration {
        table = tx_news_domain_model_news
        storagePid = 164
        hidePageTree = 1
    }
    scanAfter = page
}

 

  • The label can also be a reference to a locallang file (LLL:EXT:...).
  • If hidePageTree is set to 1 the page tree will not be rendered in this link browser tab.
  • If the storagePid is set this page will be rendered when the tab is opened first.
  • If any pageTreeMountPoints are set, those are rendered instead of the normal page tree.
  • The scanAfter (or scanBefore) option defines the order in which handlers are queried when determining the responsible tab for an existing link.
  • The position of the tab can be altered with the option displayAfter (or displayBefore).

The 2nd part of the configuration is concerned with the frontend rendering of the links to the records. So let’s have a look at the TypoScript.

Top 

TypoScript – Tell the Frontend what to do

With the PageTSconfig from above it is now already possible to add links in a RTE. This will create something like <a href="t3://record?identifier=tx_news&amp;uid=2">News</a> in the database. And when this is rendered in the frontend you need to make sure that TYPO3 knows how to resolve the t3://record?identifier=tx_news link. You tell TYPO3 in its favorite language: TypoScript.

config.recordLinks.tx_news {
    typolink {
        parameter = {$myConstants.newsDetailPid}
        additionalParams.data = field:uid
        additionalParams.wrap = &tx_news_pi1[news]=|
        useCacheHash = 1
    }
}
Under config.recordLinks you have to register the same identifier you used in the PageTSconfig. Of course you need to tell TYPO3 on what page the record should be rendered, how to pass the uid and what other parameter need to be added to the URL. You could add 
config.recordLinks.tx_news.forceLink = 1

to force even links to hidden records.

And that is all you have to do.

From: https://usetypo3.com/linkhandler.html

发表评论

电子邮件地址不会被公开。 必填项已用*标注