4700b2ba4ed7f4f912fbbd3438234965f20715bb
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / 8.6 / Feature-79626-IntegrateRecordLinkHandler.rst
1 .. include:: ../../Includes.txt
2
3 ===============================================
4 Feature: #79626 - Integrate record link handler
5 ===============================================
6
7 See :issue:`79626`
8
9 Description
10 ===========
11
12 The functionality of EXT:linkhandler has been integrated into the core. It enables editors to link to single records.
13
14 The configuration consists of the following parts:
15
16 **PageTsConfig** is used to create a new tab in the LinkBrowser to be able to select records:
17
18 .. code-block:: typoscript
19
20 TCEMAIN.linkHandler.anIdentifier {
21 handler = TYPO3\CMS\Recordlist\LinkHandler\RecordLinkHandler
22 label = LLL:EXT:extension/Resources/Private/Language/locallang.xlf:link.customTab
23 configuration {
24 table = tx_example_domain_model_item
25 }
26 scanBefore = page
27 }
28
29 The following optional configuration is available:
30
31 - :typoscript:`configuration.hidePageTree = 1`: Hide the page tree in the link browser
32 - :typoscript:`configuration.storagePid = 1`: Let the link browser start with the given page
33 - :typoscript:`configuration.pageTreeMountPoints = 123,456`: Mount the given pages instead of the regular page tree
34
35 You can position your own handlers in order as defined in https://docs.typo3.org/typo3cms/extensions/core/7.6/Changelog/7.6/Feature-66369-AddedLinkBrowserAPIs.html
36
37
38 **TypoScript** is used to generate the actual link in the frontend
39
40 .. code-block:: typoscript
41
42 config.recordLinks.anIdentifier {
43 // Do not force link generation when the record is hidden
44 forceLink = 0
45
46 typolink {
47 parameter = 123
48 additionalParams.data = field:uid
49 additionalParams.wrap = &tx_example_pi1[item]=|&tx_example_pi1[controller]=Item&tx_example_pi1[action]=show
50 useCacheHash = 1
51 }
52 }
53
54 .. index:: Backend, Frontend, PHP-API, TSConfig, TypoScript