[FEATURE] Override check/radio labels with TSConfig
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / master / Feature-58033-AltLabelsForFormEngineCheckboxAndRadioButtons.rst
1 =================================================================================
2 Feature: #58033 - Enable label override of checkbox and radio buttons by TSconfig
3 =================================================================================
4
5 Description
6 -----------
7
8 Use TSconfig to override labels of radio buttons and checkboxes used in FormEngine.
9
10 For single checkboxes the key "default" is used:
11
12 .. codeblock:: typoscript
13 TCEFORM.pages.hidden.altLabels.default = individual label
14
15 .. codeblock:: typoscript
16 TCEFORM.pages.hidden.altLabels.default = LLL:path/to/languagefile.xlf:individualLabel
17
18 For fields with multiple checkboxes, the value or the corresponding numeration (0,1,2,3) of the checkbox is used:
19
20 .. codeblock:: typoscript
21 TCEFORM.pages.l18n_cfg.altLabels.0 = individual label for the first checkbox
22 TCEFORM.pages.l18n_cfg.altLabels.1 = individual label for the second checkbox
23
24 The same functionality works on radio buttons, where the "key" is the value of the radio button.
25
26 As seen in the example, hard-coded strings or references to language files are allowed.
27
28 Impact
29 ------
30
31 The feature enables even more customization for FormEngine for any custom crafted backend instance.