Important-93331-DescriptionOfSelectCheckBoxItems.rst 1.96 KB
Newer Older
1
2
3
4
.. include:: ../../Includes.txt

=======================================================
Important: #93331 - Description of SelectCheckBox items
5
=======================================================
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73

See :issue:`93331`

Description
===========

Due to the introduction of grouping and sorting for TCA columns of type
`select` in #91008, the position of the items description, also referred
as "Help text" has changed in the corresponding TCA configuration. This
previously led to misbehaviour when using `renderType=selectCheckBox`
since the old position was still checked by this FormEngine element.

Adding descriptions is now working again and it will be used when configured
at the correct position:

.. code-block:: php

   'items' => [
       ...,
       [
           'the label',
           'the value',
           'iconIdentifier',
           'groupIdentifier',
            // The item description must be added as the fifth argument
           'item description'
       ],
   ]

It's furthermore still possible to define an array with the `title` and
`description` keys:

.. code-block:: php

   'items' => [
       ...,
       [
           'the label',
           'the value',
           'iconIdentifier',
           'groupIdentifier',
            // The item description must be added as the fifth argument
           [
              'title' => 'Help title',
              'description' => 'Help description'
           ]
       ]
   ]

In case you are using :php:`$GLOBALS['TYPO3_CONF_VARS']['BE']['customPermOptions']`
for defining custom permission options, nothing changes. The description has
still to be placed at the third position in each items configuration.

.. code-block:: php

   $GLOBALS['TYPO3_CONF_VARS']['BE']['customPermOptions'] => [
      'my_custom_field' => [
         'items' => [
            'someKey' => [
               'the label',
               'anIconIdentifier',
               'item description',
            ]
         ]
      ]
   ]

.. index:: Backend, TCA