[TASK] Documentation for FluidStyledContent and CSSStyledContent changes
[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 automaticly 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