[BUGFIX] Fix PageTS config example of CKEditor RTE
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / 8.6 / Breaking-79622-SectionFrameForCSSStyledContentReplacedWithFrameClass.rst
1 .. include:: ../../Includes.txt
2
3 =================================================================================
4 Breaking: #79622 - Section Frame for CSS Styled Content replaced with Frame Class
5 =================================================================================
6
7 See :issue:`79622`
8
9 Description
10 ===========
11
12 The functionality provided by `Section Frame` has been streamlined with Fluid Styled
13 Content and is now available as `Frame Class`. Previously, integers have been
14 stored in the Database that required a mapping of non speaking values.
15
16 The new introduced speaking values provide a more valuable use, for example
17 in Fluid Styled Content the values are used directly without mapping.
18
19 For CSS Styled Content the original behaviour has been mapped to the new keys in the
20 database and the option `invisible` has been dropped.
21
22
23 Compatibility Table
24 -------------------
25
26 ===============   ===============   ===============   ===================================   =======================
27 Name              Previous Key      New Key           CSS Class                             Additional Effects
28 ===============   ===============   ===============   ===================================   =======================
29 Default           0                 default           csc-frame csc-frame-default           -
30 Invisible         1                 (dropped)         -                                     -
31 Ruler Before      5                 ruler-before      csc-frame csc-frame-ruler-before      -
32 Ruler After       6                 ruler-after       csc-frame csc-frame-ruler-after       -
33 Indent            10                indent            csc-frame csc-frame-indent            -
34 Indent, 33/66%    11                intent-left       csc-frame csc-frame-indent-left       -
35 Indent, 66/33%    12                indent-right      csc-frame csc-frame-indent-right      -
36 No Frame          66                none              (none)                                No Frame is rendered
37 ===============   ===============   ===============   ===================================   =======================
38
39
40 TypoScript Before
41 -----------------
42
43 .. code-block:: typoscript
44
45    tt_content.stdWrap.innerWrap.cObject.key.field = section_frame
46    tt_content.stdWrap.innerWrap.cObject.5 =< tt_content.stdWrap.innerWrap.cObject.default
47    tt_content.stdWrap.innerWrap.cObject.5.20.10.value = csc-frame csc-frame-ruler-before
48
49
50 TypoScript After
51 ----------------
52
53 .. code-block:: typoscript
54
55    tt_content.stdWrap.innerWrap.cObject.key.field = frame_class
56    tt_content.stdWrap.innerWrap.cObject.ruler-before =< tt_content.stdWrap.innerWrap.cObject.default
57    tt_content.stdWrap.innerWrap.cObject.ruler-before.20.10.value = csc-frame csc-frame-ruler-before
58
59
60 Affected Installations
61 ======================
62
63 Installations that use the CSS Styled Content.
64
65
66 Migration
67 =========
68
69 Default fames can be automatically upgraded to the new field and values. Custom
70 values will be prefixed with `custom-<key>` and will also be transferred to the
71 new field.
72
73 Note that custom values must be added again to the field configuration, and the
74 mapping in the TypoScript rendering definition for CSS Styled Content needs also
75 to adapt.
76
77
78 Add custom frame
79 ----------------
80
81 .. code-block:: typoscript
82
83    TCEFORM.tt_content.frame_class {
84       addItems {
85          custom-1 = LLL:EXT:extension/Resources/Private/Language/locallang.xlf:customFrame
86       }
87    }
88
89 .. code-block:: php
90
91    $GLOBALS['TCA']['tt_content']['columns']['frame_class']['config']['items'][] = [
92       0 = LLL:EXT:extension/Resources/Private/Language/locallang.xlf:customFrame
93       1 = custom-1
94    ];
95
96
97 Adapt rendering definition
98 --------------------------
99
100 .. code-block:: typoscript
101
102    tt_content.stdWrap.innerWrap.cObject.custom-1 =< tt_content.stdWrap.innerWrap.cObject.default
103    tt_content.stdWrap.innerWrap.cObject.custom-1.20.10.value = csc-frame csc-frame-custom-1
104
105
106 .. index:: Frontend, TypoScript