[BUGFIX] Fix PageTS config example of CKEditor RTE
[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/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