[!!!][FEATURE] Streamline Fluid Styled Content and CSS Styled Content
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / master / Breaking-79622-SpaceBeforeAndSpaceAfterAdjustmentsForCSSStyledContent.rst
1 .. include:: ../../Includes.txt
2
3 ================================================================================
4 Breaking: #79622 - SpaceBefore and SpaceAfter adjustments for CSS Styled Content
5 ================================================================================
6
7 See :issue:`79622`
8
9 Description
10 ===========
11
12 CSS Styled Content provided the editor the possibility to fine-tune distances
13 between content elements. The concept of CSC relied on that the editor
14 understood what `margins` are, how they are calculated and had to maintain
15 an overview of pixels that where used on the site he is maintaining.
16
17 This lead to different problems not only for the editor but also for the
18 integrator because he has no control about what the editor fills into these
19 fields. Also it was hardly controlable when these distances should be
20 variable and change on certain viewports for mobile usage.
21
22 To regain control for this behaviour we are now introducing a new concept
23 that purely relies on CSS classes, that can be defined by the integrator.
24
25 The original fields `spaceAfter` and `spaceBefore` have been dropped, and also
26 the method :php:`\TYPO3\CMS\CssStyledContent\Controller\CssStyledContentController::renderSpace`
27 is not called anymore.
28
29
30 Old TypoScript Rendering
31 ------------------------
32
33 .. code-block:: typoscript
34
35    tt_content.stdWrap.innerWrap.cObject.default.20.20 = USER
36    tt_content.stdWrap.innerWrap.cObject.default.20.20 {
37       userFunc = TYPO3\CMS\CssStyledContent\Controller\CssStyledContentController->renderSpace
38       space = before
39       constant = {$content.spaceBefore}
40       classStdWrap {
41          required = 1
42          noTrimWrap = |csc-space-before-| |
43       }
44    }
45
46
47 New TypoScript Rendering
48 ------------------------
49
50 .. code-block:: typoscript
51
52    tt_content.stdWrap.innerWrap.cObject.default.20.20 = TEXT
53    tt_content.stdWrap.innerWrap.cObject.default.20.20 {
54       field = space_before_class
55       required = 1
56       noTrimWrap = |csc-space-before-| |
57    }
58
59
60 Impact
61 ======
62
63 Userdefined distances between content elements are missing.
64
65
66 Affected Installations
67 ======================
68
69 All instances that use  CSS Styled Content and have spaceBefore or spaceAfter
70 values set to generate more space between their content elements.
71
72
73 Check if your site is affected
74 ------------------------------
75
76 .. code-block:: mysql
77
78    SELECT
79       uid,
80       pid,
81       spaceBefore,
82       spaceAfter
83    FROM
84       tt_content
85    WHERE
86       (spaceBefore > 0 OR spaceAfter > 0)
87       AND deleted = 0
88
89
90 Migration
91 =========
92
93 There is no automatic migration available. If a migration is nessesary you need
94 to check the new presets available and migrate the pixels defined before to the
95 a preset of your choice.
96
97
98 Example
99 -------
100
101 .. code-block:: mysql
102
103    UPDATE
104       tt_content
105    SET
106       spaceAfter = 0,
107       space_after_class = 'medium'
108    WHERE
109       spaceAfter >= 42
110       AND spaceAfter < 56
111
112
113 Replacement Documentation
114 -------------------------
115
116 For detailed information about the replacement of spaceBefore and spaceAfter,
117 please head over to the feature documentation of SpaceBefore- and SpaceAfterClass
118 for CSS Styled Content.
119
120 Feature-79622-SpaceBeforeAndSpaceAfterClassForCssStyledContent.rst
121
122
123 .. index:: Frontend